01 / 04 · 技能使用指南

从场景开始

判断你遇到的事,选择最短路径,并用九个问题验收学到的技能。

选场景看路线查技能卡核对产物
四步阅读路径

先找到路径,再按需打开细节

每页都保留原文对应章节。可以顺序读,也可以直接跳到当前问题。

STEP 01从场景开始判断你遇到的事,选择最短路径,并用九个问题验收学到的技能。先选一个真实场景 →STEP 02理解完整交付看大型项目如何分层推进,文档如何接力,人和 Agent 各在哪一步作决定。把决策落进项目 →STEP 03看技能关系先读主干,再打开按需分支;点击节点查看前后关联。从路线找到节点 →STEP 04查操作手册按需展开 25 张技能卡、48 个术语与一周练习,不要求背完。只查现在需要的一张卡 →
从这里开始只选当前场景,再沿着这条路线走。

在下方选择一项真实处境;需要项目资料时看文档怎样接力,准备执行时打开对应技能卡。有些技能需要你明确点名,有些也能由 Agent 根据任务主动调用。

场景入口

先回答一个问题:你现在卡在哪里?

这就是整套方法的“路由器”。不要从技能列表里猜,先选场景;右侧会给出最短可用顺序。

    只记这一句

    先判断场景,再点名最少必要的技能;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. 异常或结果不符时怎么办?异常恢复、每张技能卡的“异常处理”保留现场,回到最近证据点,采取最窄恢复动作,不把失败说成成功。
    完成红线:字段写全不等于用户学会。使用者必须能在不依赖作者解释的情况下,选择技能、给出输入、执行流程、找到产物、复核证据并处理一次异常。