Skip to content

xinetzone/SpecWeave / .agents/skills/agent-task-handoff

agent-task-handoff

Verified

当用户要把一件有外部副作用的事交给 AI Agent(浏览器自动化、手机助手、桌面 Agent、外包或实习生)执行,或出现『AI 说做了却没生效』『同一任务越跑越贵』『第一次让 AI 碰陌生项目』时,必须使用此技能。五模式编排:P1 定路线(底座先行)→ P2 建地图(只讲不改)→ P3 写任务书(做什么/条件/停点/回报/红线)→ P5 控成本(步数与停点前移)→ P4 排障(分链定位);排障时反向从 P4 回到 P3。另含四张补充卡(E1 四问成技 / E2 证据先行 / E3 单产出拆分 / E4 双闸门),覆盖把重复流程写成技能、失败先取证、多段编排与不可逆动作能力层兜底。产出可验收的委托契约、步数台账与排障记录;不替代需求澄清,不替用户执行不可逆动作。

AI 委托编排 Skill

把「帮我交给 AI 去做」从一句话,变成五个可验收动作:定路线 → 建地图 → 写任务 → 控成本 → 排故障。

本 Skill 是方法论模式库九篇模式的编排门面(L1):01 课五模式(P1P5)构成主链,02 课四模式(E1E4)作为补充卡按需插入。完整论证在 L2 模式文档,本文件只保留可直接执行的判据、卡片与模板。

1. 何时使用

触发信号分级

级别信号动作
T0 弱信号只提到「AI」「Agent」「自动化」「让它帮我」「代操作」,未说明对象、副作用或验收方式先问三件事:交给谁、会不会改变外部状态、怎么算完成;确认后才进入编排
T1 中信号用户说「把这件事交给 AI / 让它去做」,但条件与边界缺失直接进入 P3 任务书,把缺口补成四要素
T2 强信号用户明确要求对真实系统执行有副作用的动作(下单、支付、发送、发布、删除、改生产配置、批量改文件),或要求「写个任务书 / 帮我看看 Agent 为什么卡住 / 这个任务怎么拆」按五模式编排并生成任务书或排障记录

不适用:

  • 纯问答、纯生成、可无限重做且无外部副作用的探索;
  • 目标本身还不清楚——先做需求澄清,不要用任务书把模糊目标固化(任务书会放大错误目标);
  • 用户要的是「改这个仓库的代码」而不是「委托外部执行者」——那是 TRAE-plan-mode / TRAE-spec-mode 的领域。

2. 五条洞察 → 五条判据

本 Skill 的判断层不是规则清单,而是五条从真实案例抽出的判据。洞察原文在上游知识包,这里只保留可执行形态。

#洞察可执行判据落在哪个模式违反时的典型症状
1真正的分水岭在操作链,不在聊天链出故障先分链,不要先换模型或重填配置P4「闲聊有回复、界面却不动」却反复换模型
2二次开发杠杆在规则/技能/记忆,不在核心代码改动落点按「可声明资产 → 规则/技能 → 界面 → 核心层」自上而下找P1一上来就改核心执行器,改动面失控
3长任务成本由截图次数(步数)决定写任务时就估算步数、分段、前移停点P5任务书写得含糊,同一模型多走十几步
4人类在环是能力边界,不是安全补丁不可逆动作必须位于停点之后或红线之内P3停点写在支付页(订单已生成)
5首次接触只讲不改首次勘察以「工作区零改动」为验收条件P2边看边改,改坏后无法归因

为什么? 洞察是结论,判据是动作。只记「成本由步数决定」不会改变任何一次任务下发;把它写成「写任务时先估步数、把停点前移」才会。判据的价值在于它能在写任务书的那五分钟里被触发。

3. 编排总览

委托前                          委托中                失败后
──────────────────────────────────────────────────────────────
P1 定路线 ──→ P2 建地图 ──→ P3 写任务书 ──→ P5 控成本 ──→ P4 排障
                                    ↑                        │
                                    └────── 回到 P3 改任务书 ──┘
  • 正向(新建委托):P1 → P2 → P3 → P5,产出一份可执行任务书。
  • 反向(排障):P4 先定位坏在哪条链,再按结论回 P3 改任务书(或回 P1 换底座)。
  • 可跳过:P1 仅在「要不要基于现成底座做」尚未决定时需要;P2 仅在执行者第一次接触该系统时需要;P5 仅在任务是图形界面多步任务时需要。

为什么允许跳步? 五模式不是流水线而是候选集。知识沉淀类与纯事务类委托常常只需 P3;把五步全跑一遍,会把一次「发一封邮件」变成一次流程改造。

扩展路径(02 课补充卡)

  • 要把它变成可复用能力(同一流程会反复发生)→ 插入 E1 四问成技,把任务书升格为技能;
  • 失败后要定位并修(已有现象、原因不明)→ 在 P4 之前插入 E2 证据先行,先取证再归链;
  • 任务要拆给多个执行者(步骤多、可并行、有中间产出)→ 用 E3 单产出拆分,把单份任务书扩成多段交接单;
  • 存在不可逆动作(付款/发送/删除/安装/授权)→ 在 P3 红线之外加 E4 双闸门,把「应该确认」下沉到能力层。
  • 串联顺序:新建委托走 P1 → P2 → P3 → P5 → P4;把它变成长期能力时走 P1 → E1 → E2 → E4 → E3(先定层、再成技、再取证、再守闸门、最后才拆分)。顺序可反转:做多 Agent 设计时先用 E3 切段,再用 E1 把每段写成技能,最后用 E2 与 E4 收口。

为什么补充卡不改主链编号? P1P5 与 02 课 P1P6 的编号含义不同(01 课 P5 是成本裁剪,02 课 P5 是单产出拆分)。主链保留 P 编号以维持既有引用稳定,02 课四项改用 E 编号,避免「P5 到底指哪一个」的歧义。

4. 阶段执行卡

4.1 P1 定路线(底座先行最小定制)

输入:目标能力、候选底座、时间与许可约束。

动作:

  1. 判断目标能力是否与某个成熟底座高度重合;重合则先跑通最小闭环,并冻结基线(可用能力、不可用能力、报错、耗时)。
  2. 最小闭环在零改动下就跑不通 → 换底座或先修通,不要把「装不起来」当作定制第一步。
  3. 落点按层找:可声明资产(配置/提示词/记忆)→ 规则/技能 → 界面 → 核心操作层。对「有记忆、有技能、有可改程序」的 Agent 产品,四层可折叠为记忆 / 技能 / 程序三层,先给需求判型再落层——偏好(希望它记得什么)→ 记忆层;流程(希望它按什么步骤做)→ 技能层;界面/能力(当前做不到或不允许做)→ 程序层。一句话判层:这条要求是希望它记得(记忆)、会做(技能),还是做不到也不能做(程序)?能用上层表达就不下沉;每上升一层先确认回滚方式(技能保留旧版、程序保留备份),改程序前必须确认卸载重装不会清空记忆与技能。
  4. 一次只改一个落点,改完立即在真实环境验证一次。
  5. 每条改动登记三元组:改了什么|怎么证明生效(含多久生效:即时生效还是需重装/重发)|怎么退回。

不适用:完全黑盒、三层均不可配置的 SaaS;或改动必须跨三层同时生效、无法单层验证的场景——此时不要硬套分层,回到 P1 动作 1 重新评估底座。

产出:基线快照 + 落点表 + 改动台账。

质量门:能否在不改核心操作层的前提下完成一次定制,并用一句话说明「这次改动落在哪层、多久生效、怎么验证、怎么退回」?

4.2 P2 建地图(只讲不改勘察)

输入:陌生系统 + 一个具体需求。

动作:

  1. 先写三问:关键模块在哪|一次请求经过哪几步|改某类行为该动哪里。
  2. 在任务描述末尾写死否定式约束:「先只讲解,不要修改任何文件」。
  3. 要求用非开发者能懂的话复述,暴露理解空洞。
  4. 人工核对说法与目录/入口是否一致,重点抓「把不存在的东西说成存在」。
  5. 用版本控制状态证明零改动(未跟踪 + 已修改清单为空);无版本控制时用哈希快照前后比对。

产出:系统说明 + 三问答案 + 零改动证据。

质量门:三问答案都指向真实文件,且变更清单为空。

4.3 P3 写任务书(四要素 + 红线)

要素写法常见失效
做什么哪个环境、哪个对象、达成什么可观察结果只有目标没有对象(「整理一下资料」)
条件预算、规格、时间、数量全部换成数字或有限枚举用形容词(「便宜点」「尽快」)
停点用可观察的位置/动作边界描述终点,且早于不可逆动作停点写在不可逆动作之后
回报3–5 项交接字段,直接对应验收判断要求叙述过程而非回报字段
红线显式禁止动作 + 越界时停下上报红线只写在人脑里

发送前四问自查:第三人能说出「它会在哪停」吗?每条条件都能判真假吗?停点早于所有不可逆动作吗?回报项足以验收吗?

产出:可复制、可验收的任务书(模板见 references/task-brief-template.md)。

质量门:四问全为「是」。

改完之后怎么复测(改配置化行为时接上,来源 02 课 P3,库内并入 edit-verify-separation Step 6):

  1. 改前留基线:先跑一次,记下输入原话与输出表现;
  2. 只改一处:一条规则、一个检查点或一个配置项;
  3. 发布改动:技能类走 lint + push,程序类走构建 + 安装,并注明生效方式(即时生效还是需重装/重发);
  4. 同句复测:用与基线完全相同的那句话原样再跑,不换问法;
  5. 对照与回退:能说出「这次只改了什么、输入没变、输出变了哪里」;不达预期先回退再进下一轮。

不适用:首次搭建(没有基线可对比);无法重复触发的场景。两类情况都不要假装有对照实验,直接记录单次表现。

为什么必须同句复测? 换一句话会把「输入变化」与「规则变化」混在一起,得到的差异无法归因;一次改五处即使成功,也不知道哪条起作用。另注意:lint 通过只证明格式合法,不证明行为正确;改完不复测就进下一个需求,会让两轮改动的效果互相污染、永远无法归因。

4.4 P5 控成本(截图成本裁剪)

输入:图形界面多步任务(手机/浏览器/桌面 Agent)。

动作:

  1. 按「一次搜索/一次筛选/进一次详情页/一次表单填写各算一步」估算步数,找出占步数最多的一段。
  2. 切成「侦察 → 选定 → 决策」三段,每段有独立完成标志,分别验收。
  3. 条件数字化,减少 Agent 来回比较。
  4. 停点前移:能停在列表页就不进详情页,能停在详情页就不进结算页。
  5. 记录每轮步数、重试次数、费用与验收结果,形成自己的基线。

产出:三段任务书 + 步数/费用台账(模板见 references/step-ledger.md)。

质量门:第二次执行同类任务时步数下降或明确说明为何不能下降,且验收项没有减少。

为什么不能靠换便宜模型降本? 单价下降但步数不变;弱模型更容易试错,反而增加总步数与失败率。成本的自变量是任务书写法。

4.5 P4 排障(分链定位)

前置:系统必须存在两条可独立观测的链路——一条只触发理解、不产生外部动作;一条只触发执行、不依赖复杂推理。找不到这类指令时,改用逐部件替换法。

五步:

  1. 一条最小指令验证理解链(复述要求、解释文本)。
  2. 一条最小指令验证执行链(打开固定页面、写固定文件、跑固定命令),以外部可观察状态为准。
  3. 落到四分支之一:只理解不执行|只执行不理解|两条都不通|执行中途停。
  4. 只查该分支的固定三项,一次只改一项,改完用同一条最小指令复测。
  5. 重跑两条最小指令做交叉回归,确认没有把另一条链弄坏。

产出:分支判定 + 单点改动记录 + 交叉回归结果(工作表见 references/triage-worksheet.md)。

质量门:能说出「这次坏在哪条链、改了哪一项、另一条链是否仍通」。

4.6 E1 四问成技(把重复流程固化为技能)

何时用:同一流程会反复发生,每次委托都要重写任务书。

不适用:一次性任务(写成技能的成本高于重复下发);结果无法观察、无页面/列表/通知可检查的任务;触发条件还在变化的任务(先维持任务书形态,稳定后再成技)。

动作:① 触发——用户会说哪句话或到哪个时间点;② 步骤——先读什么、再做什么、最后交什么;③ 检查——去哪个页面/文件/列表看什么,没做到如实说;④ 确认——不可逆动作前必须停;⑤ 补一行红线;⑥ 用同一句触发语复测改前改后。

产出:四问齐备的技能说明书(或技能草稿)。

质量门:第三人读完后能说出「它什么时候开始、在哪停、回来给你什么、怎么验收」。

与主链分工:P3 产出一份一次性任务书,E1 把它升格为可复用资产;条件与红线同源,不重复定义。

4.7 E2 证据先行(失败处置纪律)

何时用:已有失败现象、原因不明,且重跑会覆盖现场。

不适用:确定性脚本的编译错误——报错栈已直接定位问题,先看报错比取证更快;本卡只服务多步、跨设备、结果不确定的自动化任务。

动作:① 冻结现场并留可回退点;② 取三类证据(运行 ID、最后几步日志、界面/输出状态),缺口如实标注;③ 先让分析者解释「失败在第几步」,不直接改;④ 写最小复现或记录触发频率;⑤ 单点最小修改并写明生效方式(即时 vs 需重装);⑥ 用最小复现原样复测;⑦ 状态按「已完成 / 待验证 / 未达成」三分登记。

反模式:顺手重构——借修复引入与本次故障无关的变更,会破坏单点归因,让「修好了」无法证明是哪处起作用;无关重构另开任务、另走验证。

产出:证据包 + 最小复现 + 单点改动记录。

质量门:能指出失败在第几步并说明依据;未完成项没有被改写成完成。

与主链分工:P4 回答「坏在哪条链」,E2 回答「证据是什么、改了什么、是否真的完成」。

4.8 E3 单产出拆分(多段编排)

何时用:任务步骤多、可并行、每段有可检查产出,需要交给多个执行者。

不适用:强顺序依赖、无法并行的任务;没有可检查中间产出的任务;只有一两步的任务(直接用 P3 任务书,拆分只会增加交接成本)。

动作:① 列动作与产出;② 按四规则切段(单一产出 / 人工确认处切 / 触发时间不同分开 / 同产出合并);③ 每段写六字段交接单(目标、输入、能改什么、不能做什么、交回什么、怎么验收);④ 标人工关口;⑤ 先跑最费劲的一段;⑥ 两三段各自跑稳后再引入调度者,调度者按「怎么验收」自核、不过不传、坏段退回不往下传。

产出:分段表 + 每段交接单 + 验收记录(含打回次数)。

质量门:每段可独立验收;任一段失败不污染下游;不存在两人共担同一产出。

与主链分工:P3 是一份任务书,E3 是把一份扩成多段,并规定交接、关口与打回。

4.9 E4 双闸门(不可逆动作能力层兜底)

何时用:委托范围内含付款、发送、删除、安装、授权等不可逆动作。

不适用:纯只读系统;所有动作都可回滚的系统——两类系统没有不可逆面,加闸门只增加摩擦。

动作:① 列不可逆动作清单并标代价;② 规则层写具体项确认(展示时间/金额/收件人/对象);③ 能力层实现「缺确认凭据即拒绝执行」;④ 做反证测试——移除规则层确认后仍被拦住;⑤ 登记闸门台账(位置、覆盖动作、责任人)。

反模式:闸门只覆盖付款,漏掉发送与删除(清单必须枚举全部不可逆动作,逐项对闸门);把确认做成「可一键跳过」的弹窗(跳过等于没有能力层闸门)。

产出:动作清单 + 双层闸门位置 + 反证记录。

质量门:故意绕过规则层时能力层仍能阻止不可逆动作;密码/验证码/支付口令不经过自动化链路。

与主链分工:P3 红线是单次委托的软约束,E4 把它固化为运行时常量;无接口控制权时退化为权限最小化 + 独立审批。

5. 任务书模板(可直接复制)

【做什么】在 <环境/设备/账号/站点> 上,对 <对象> 达成 <可观察结果>。
【条件】<预算 ≤ N 元>;<规格 = 枚举值>;<时间 ≤ 今天 18:00>;<数量 = N>。条件冲突时优先级:<预算 > 规格>。
【停点】停在 <页面/动作> 之前;到达停点后不再深入。
【回报】①<名称> ②<关键属性> ③<价格/数量> ④<你判断所需的其他项>。
【红线】不要 <加购/下单/发送/删除/改配置/代填凭据>;遇到 <验证码/实名人脸/密钥输入> 请停下并告知我。

填写示例与三类任务(采购、信息收集、内容处理)的对照见 references/task-brief-template.md。

6. 分链排障卡

分支现象固定检查项(按系统替换)
只理解不执行有合理回复,外部无变化① 执行侧模型/执行器是否配置 ② 输入模态是否被支持(如能否读屏) ③ 执行所需权限/无障碍是否被关闭
只执行不理解不听指令但外部有异常动作① 意图路由是否指向错误技能 ② 上下文/记忆是否污染 ③ 提示词或工具描述是否过期
两条都不通两条最小指令都失败① 凭据与配额 ② 网络与端点 ③ 运行时版本与依赖
执行中途停跑到一半不动① 是否触发确认闸门等待人工 ② 单步超时/重试上限 ③ 中途错误是否被静默吞掉

7. 预览确认与幂等

  1. 预检:列出本次将下发的任务书字段、预计步数与不可逆动作清单,逐项标注依据。
  2. 预览:把任务书全文原样贴出,不截断,让用户自己判断停点位置与条件松紧。
  3. 确认:用户明确认可后才视为可下发;用户改动则回到 P3 重出预览。
  4. 重复检查:同一目标若已下发过,先比对旧任务书——停点、条件、红线未变时直接复用并只增量修改;已给出的排障结论不重复推导。

为什么? 任务书一旦下发,执行者就会按它行动;错误停点的代价不是多跑一步,而是不可逆动作被提前执行。预览把「建议」和「已下发」之间的边界固定住,幂等则避免同一委托被重复执行、重复计费。

8. 安全检查清单

  • 副作用等级已判定(只读 / 可回退 / 不可逆),且写进任务书
  • 停点早于所有不可逆动作,且位置可观察
  • 红线逐条列出,并写明越界时的上报动作
  • 条件全部可机械判定,无形容词残留
  • 回报项足以在不回放过程的前提下验收
  • 价格、数量、时间等关键数字已由用户确认,未经推断
  • 凭据类输入(密码/验证码/密钥/实名)已排除在委托范围外
  • 预览稿已给出并获用户确认后才下发

9. Gotchas:隐性陷阱

#陷阱表现正确做法
1「有回复」当作「已执行」Agent 说「已为你打开页面」,实际界面没变执行链判定一律以外部可观察状态为证据
2停点写在不该写的地方写「下单后停在支付页」——订单已生成,回滚成本已发生停点必须是不可逆动作之前的位置
3只写「先看看」正向描述不构成禁止,执行者仍会顺手改用否定式祈使句写死「不要修改任何文件」
4用形容词当条件「便宜点」「性价比高」「尽快」换成数字区间或有限枚举,并写冲突优先级
5一次改三项配置恢复了也不知道哪项起作用一次只改一项,改完用同一条最小指令复测
6只复测故障链修执行链时改了模型配置,把理解链弄坏修复后两条最小指令都复跑,做交叉回归
7以减少步数为由放宽验收少比一家候选、少核一项回报,却记为降本成功步数下降且验收项不变才算优化;否则是降低目标
8任务书替代需求澄清目标尚模糊就写四要素,错误目标被放大先澄清到能写出「停点」再写任务书

为什么? 这八条的共同点是「看起来都完成了任务」——每份产物读起来都像一份合格的委托。正因如此只能靠停点位置、外部状态证据与交叉回归这三类可核对的锚点拦住,而不能靠结果自检。

10. 检验标准

  • 任务书四问自查全部为「是」(可复述 / 可判定 / 不可逆安全 / 可验收)
  • 每次只改一个落点或一项配置,且有一次对应验证
  • 排障结论包含「哪条链、改了哪项、另一条链是否仍通」
  • 图形界面任务有步数与重试次数记录,可回答「贵在哪一段」
  • 首次勘察有零改动证据(状态输出或哈希对照)
  • 全过程未替用户执行不可逆动作,未代填凭据

11. 边界与邻近技能

邻近资产关系区分判据
TRAE-plan-mode不同对象它规划本仓库内的有界代码变更并等批准;本 Skill 面向外部执行者(Agent/外包/自动化)的任务契约,不产出代码计划
TRAE-spec-mode不同对象它用于复杂仓库变更的需求-任务-审查闭环;本 Skill 不写 spec,只写委托契约与排障记录
四要素 vs 子代理文档模板相邻易混子代理模板约束「写哪份文档、frontmatter 是什么」;本 Skill 约束「做到哪停、回来报什么」。给「在电商站买一台指定规格的笔记本」,子代理模板不提供停点与回报字段
输出行为规范互补输出行为规范约束「说什么、说多少」;本 Skill 约束「做到哪、停在哪」,两者可写进同一份任务书

12. 参考

L2 模式文档(库内通用版):

上游案例(只读,不复制):TRAE 训练营 01 课知识包(五条洞察 / 91 条事实)与 02 课知识包(五条洞察 / 118 条事实)。

13. 来源与萃取记录

  • 上游知识与洞察:sc-20261115-trae-agent-camp-01(场景 4 知识沉淀,R→I→E→V→C;91 条事实 / 5 条四元组洞察 / 7 条 V 意见),产物为只读知识包,本 Skill 不复制其正文。
  • 模式层:sc-20261116-trae-agent-camp-01-pattern(E→V→入库)把五个模式逐条去重后登记入方法论模式库,均标 L1-draft;本 Skill 是这五篇的编排门面,不新增模式、不改其成熟度。
  • 补充卡来源(v1.1.0):sc-20261116-trae-agent-camp-02-pattern 将 02 课 6 个模式去重后处置为 4 新建(四问成技 / 证据先行 / 单产出拆分 / 双闸门)与 2 并入(三层改造面 → base-first-minimal-customization;试改验循环 → edit-verify-separation)。本 Skill 以 E1~E4 编号接入其中 4 篇,并把「三层映射」与「同输入复测」作为 P1 / P3 的口径补充,不重复定义。
  • 编号冲突处置:01 课 P5=截图成本裁剪,02 课 P5=单产出拆分。为保持既有引用稳定,主链沿用 P1P5,02 课四项改用 E1E4,并在 §3 说明映射。
  • 本会话:sc-20261116-trae-agent-camp-01-skill(E 阶段再萃取:把「模式集合」变成「一次可执行的委托编排」)。
  • 去重判定:与 TRAE-plan-mode(仓库内有界变更规划)、TRAE-spec-mode(复杂变更规范闭环)、writing-plans / executing-plans(实施计划)、session-to-skill(会话转 Skill)逐一比对——它们都不产出「有外部副作用任务的停点与回报契约」,故不重复;边界判据写在 §11。
  • 成熟度继承:九篇模式分属同一课程系列的两个知识包(01 课 / 02 课),互不构成独立验证;封装成 Skill 不构成第二次验证,validation_count 不因本 Skill 而增加。升级路径仍按各模式文档的升级条件执行。
  • 本 Skill 的验证证据:v1.0.0 初建时 check-skill-quality.py --path .agents/skills/agent-task-handoff --score --threshold 100 → 100/100、36 项全过;v1.1.0 回灌后复跑仍为 100/100,check-links.py --paths .agents/skills/agent-task-handoff .agents/skills .agents/capability-registry .meta/toml --check-frontmatter-paths → 1379 条本地引用 0 断链、frontmatter 路径全部有效(残留 3 条目录链接警告为 HEAD 既有,本次引入 0 项);evals 由 3 条增至 4 条。
  • 实战复用验证(2026-11-16,首次):委托一个子代理修复 external-learning 下 6 个报告目录的 17 条 checklist.md 存量断链(目标改为同 spec 目录的 review.md)。实际走通的链路:P3 任务书(做什么/条件/停点/回报/红线五项齐备,条件全部可判定)→ 子代理执行 → E2 取证核验(不采信自述,独立跑 git diff 与 check-links)→ 验收。结果:13 文件 17 处替换,独立复核本地断链 17 → 0,无越界改动。未覆盖项(如实登记):① E4 只走了规则层(红线禁止 git 写操作),能力层闸门在「子代理拥有写权限」的环境下无法强制,属本 Skill 的已知缺口;② E1/E3/P1/P2/P5 本次未触发;③ 观察到一处张力——任务书为降风险限定「不改链接文字」,导致链接标签仍写 checklist.md 而目标已是 review.md,属可接受但可改进项。
  • v1.3.0 对照核验(2026-11-16):以 02 课 patterns.md 六模式(P1 三层改造面 / P2 四问成技 / P3 试改验循环 / P4 证据先行 / P5 单产出拆分 / P6 双闸门)为基准做逐条机械比对(核心步骤 / 检验标准 / 反模式 / 适用边界四列)。主干步骤此前已全覆盖,本次只补缺口、不重写:①六张卡补齐「不适用」边界(P1 黑盒 SaaS 与跨三层同改、P3 无基线/不可重复、E1 一次性/不可观察/触发在变、E2 确定性编译错误、E3 强顺序/无中间产出/一两步、E4 纯只读/全可回滚);②补三条源文有而现盘缺的反模式(E2 顺手重构、E4 漏覆盖发送删除与一键跳过弹窗、P3 改完不复测);③P3 补「发布改动(lint+push / 构建+安装)」环节与生效方式;④P1 补需求三分类判型(偏好/流程/界面能力)与「多久生效」检验;⑤修复 L2 漏链——edit-verify-separation.md(P3 库内归宿)此前未入 §12 与 frontmatter paths;⑥修复四面版本漂移(frontmatter 1.2.0 / §14 与登记面 v1.1.1 / TOML 1.0 → 统一为 v1.3.0,TOML 两段式 1.3)。evals 同步新增 2 条覆盖 P1 判层与 P3 同句复测(两个「并入」模式此前零回归用例)。

为什么记录未验证项? 封装本身只增加可触发性与可执行性,不增加证据。若把「已被 Skill 收录」当作「已被验证」,下游会误以为停点与回报契约的效果有实测支撑——这正是上游模式文档在 maturity_note 里反复防范的同一类错觉。

14. Changelog

  • v1.3.0 (2026-11-16): 以 02 课 patterns.md 六模式为基准机械比对后的缺口补齐(纯增补,不改变主链与触发面)。变更面:①六张阶段卡(P1/P3/E1~E4)补齐「不适用」边界;②补三条缺失反模式(E2 顺手重构、E4 漏覆盖发送/删除与一键跳过弹窗、P3 改完不复测);③P3 试改验补「发布改动」环节(技能 lint+push/程序构建+安装,注明生效方式)并扩为五步;④P1 补需求三分类判型(偏好→记忆/流程→技能/界面能力→程序)、上升层先确认回滚、检验补「多久生效」;⑤§12 与 frontmatter paths 补入 L2 漏链 edit-verify-separation.md(P3 库内归宿);⑥E3 动作⑥量化为「两三段跑稳后再引入调度者」;⑦修复四面版本漂移,统一为 v1.3.0;⑧evals 新增 2 条(P1 三层判层、P3 同句复测),共 6 条。
  • v1.2.0 (2026-11-16): 02 课两个「并入」模式的口径回灌 + 首次实战复用验证。口径回灌:①§3 新增串联顺序(P1→E1→E2→E4→E3,及多 Agent 设计时的反转顺序);②§4.1 补三层折叠(记忆/技能/程序)与一句话判层、卸载备份红线;③§4.3 补同句复测四步与「lint 通过≠行为正确」。实战验证:以「修复 6 个报告目录 17 条存量 checklist 断链」为真实委托,跑通 P3 任务书 → 子代理执行 → E2 独立取证 → 验收全链路,独立复核本地断链 17→0、无越界改动;如实登记三项缺口(E4 仅规则层、E1/E3/P1/P2/P5 未触发、链接标签与目标不一致的张力)。
  • v1.1.0 (2026-11-16): 回灌 02 课入库的四个模式,补齐「把委托变成能力、把失败变成证据、把任务拆成多段、把确认下沉到能力层」四类场景。变更面:①§3 新增「扩展路径」与编号冲突处置说明(01 课 P5=成本裁剪,02 课 P5=单产出拆分,故 02 课四项改用 E1E4);②§4 新增 4.64.9 四张补充卡(E1 四问成技 / E2 证据先行 / E3 单产出拆分 / E4 双闸门),每卡含何时用、动作、产出、质量门与「与主链分工」;③§12 参考补 4 篇 L2 模式文档与 02 课知识包;④§13 补补充卡来源、编号冲突处置与成熟度继承口径(九篇仍不构成独立验证);⑤evals 增至 4 条(新增多段流水线 + 发布确认场景);⑥description 增列四张补充卡以覆盖新触发场景。验证:质量门 100/100、链接门 0 断链。
  • v1.0.0 (2026-11-16): 初始版本。以五模式编排门面形式沉淀手机 Agent 课程案例的可迁移方法论:洞察→判据映射、五阶段执行卡、任务书模板、分链排障卡、8 条 Gotchas;配套三篇 references 与三条 evals。
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 465kUpdated Claude CodeCodexVerifiedInstall
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 465kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 318kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 318kUpdated Claude CodeCodexVerifiedInstall