场景入口
先回答一个问题:你现在卡在哪里?
这就是整套方法的“路由器”。不要从技能列表里猜,先选场景;右侧会给出最短可用顺序。
只记这一句
先判断场景,再点名最少必要的技能;Skill 用完会回到当前任务继续,只有工作内容需要跨工具、跨目录或交给别人携带时,才用本地 handoff 技能生成交接文件。
小白先记住:有真实项目目录的新功能,默认主线是
grill-with-docs → to-spec → to-tickets → implement(内含 tdd)→ code-review。不确定时先用 ask-matt 路由。| 你最关心的问题 | 直接答案 | 你要看什么 |
|---|---|---|
| 什么时候用 Skill? | 当任务与 Skill 的触发场景吻合时使用;可以直接点名,也可能由 Codex 根据描述匹配。 | 先看“什么时候用”和输入条件,不要因为技能存在就全部串起来。 |
| Skill 用完会去哪? | 默认仍在当前任务里,结果返回给当前 Agent;它不会自动创建新任务。 | 看“顺序关系”:继续下一技能、返回主线、等待你确认,或在此停止。 |
| 产出都要看吗? | 不用逐字审阅所有代码和日志,但关键决策与验收证据必须看。 | 优先看:业务范围、Out of Scope、ADR 取舍、票据依赖、失败/通过的测试证据、审查发现、未验证项。 |
| 什么时候开新任务? | 独立工作要并行,或票据已经自包含且你想获得干净上下文时。相关工作通常继续留在同一任务。 | 新任务必须带项目、票据/规格链接、验收条件和写入范围;不要让两个任务同时写同一批文件。 |
场景顺序
各场景下,正确顺序是什么?
箭头表示先后关系;括号里的技能通常由主技能自动带入,不需要你单独喊。
使用者验收导航
学会一个技能,必须能独立回答这 9 个问题
这不是目录装饰,而是你的完成检查。先从场景进入;执行前看条件;执行后按产物、变化和异常证据验收。
| 你必须能回答 | 在本手册哪里学 | 最低合格标准 |
|---|---|---|
| 1. 什么时候用,哪些场景不适合? | 场景入口、场景顺序、技能字典 | 能从真实业务处境选出最少必要技能,并说出一个反例。 |
| 2. 使用前需要什么? | 文档与项目记忆、每张技能卡的“前置条件” | 能确认项目、输入、权限、工具和停止条件,不在错误目录开工。 |
| 3. 完整操作流程是什么? | Agent 对话实操、每张技能卡的“完整流程” | 知道先后顺序、人工关卡和何时停止,不只会喊技能名。 |
| 4–6. 产出什么、去哪里看、重点看什么? | 文档总账、每张技能卡的“执行产物 / 查看位置 / 重点关注” | 能打开真实文件、Issue、Git 或对话结果,并找出业务与风险决策。 |
| 7. 结果会不会变化,谁触发? | 功能完成后的变化、每张技能卡的“变化规则” | 能区分自动变化、下一次 Agent 运行、人工编辑、Git 和外部平台活动。 |
| 8. 什么时候必须人工复核? | 生产关卡、每张技能卡的“人工复核” | 在业务选择、远程变更、不可逆操作、合并和上线前后设置明确关卡。 |
| 9. 异常或结果不符时怎么办? | 异常恢复、每张技能卡的“异常处理” | 保留现场,回到最近证据点,采取最窄恢复动作,不把失败说成成功。 |
完成红线:字段写全不等于用户学会。使用者必须能在不依赖作者解释的情况下,选择技能、给出输入、执行流程、找到产物、复核证据并处理一次异常。