技能字典
25 张技能卡：先看产物，再学操作
展开一张卡，先确认它会留下什么以及保存位置；接着读前置条件、步骤和复核点。
读卡方法
“产物放哪里”指什么？
先问它会生成文档、修改代码，还是只给出对话结论。文件路径从项目根目录算起；票据位置以 docs/agents/issue-tracker.md 中的配置为准。没有固定文件的技能会明确写出“当前对话”或“项目约定路径”。
- 项目规则
AGENTS.md、docs/agents/ - 业务共识
CONTEXT.md、docs/adr/ - 规格与任务已配置的 Issue Tracker；本地模式可在
.scratch/<feature>/ - 执行证据仓库代码与测试、Git 提交、票据状态
名词解释
生产工程名词翻译成人话
这里解释本笔记中影响决策的专业词。理解它们，比背命令更重要。
上手练习
最小练习路径：一周跑通，而不是一次学完
目标不是记住 25 个名字，而是建立“遇到什么事走什么路”的肌肉记忆。
第 1–2 天：主干第一次
- 选一个 1–2 天能做完的小功能。
- 跑 setup，然后完整经历 grill-with-docs。
- 确认生成 CONTEXT.md 和必要的 ADR。
- 继续 to-spec → to-tickets，只做第一张票。
第 3–4 天：实现与审查
- 用一张自包含票练习 implement，并明确选择继续当前任务还是新开任务。
- 阅读 Spec 轴审查，亲自判断有没有漏做或多做。
- 用真实界面完成一次人工验收。
第 5 天：故障演练
- 故意制造一个小错误。
- 用 diagnosing-bugs 建立可重复失败的反馈回路。
- 验证修复后新增了回归测试。
第 6–7 天：生产差距
- 写一页发布 Runbook。
- 列安全、监控、回滚三张清单。
- 找出所有“测试通过但线上仍可能失败”的地方。
可直接复制的总控提示词
我正在从 Vibe Coding 进入正式生产开发。请先判断我当前属于哪种场景，再选择最少必要的技能，不要一次调用全部技能。
请按以下格式开始：
1. 当前场景与判断依据；
2. 推荐技能顺序，以及每一步为什么现在需要；
3. 每一步要产出的文件或证据；
4. 哪些决定必须由我确认；
5. 哪些结论尚未验证。
如果是新功能且有项目目录，默认从 grill-with-docs 开始；如果是 bug，先建立稳定复现的反馈回路；如果工作很长，相关步骤继续使用同一目标并在阶段边界切小，只有需要可携带上下文时才生成 handoff。完成代码后，必须单独检查安全、发布、监控和回滚，不得把“测试通过”说成“已经可以生产上线”。
大项目第一次启动
这是一个包含多个业务模块的培训小程序，不可能在一次对话中设计完成。
请先检查项目是否已经运行过 setup-matt-pocock-skills；已有配置就不要重跑。然后用 wayfinder，把“形成可分期实施的第一版完整规格”作为目的地。
先广度优先识别课程与场次、报名与签到、支付与退款、学习与证书等候选业务上下文。请解释哪些只是界面功能，哪些真的需要独立 CONTEXT.md，并让我确认单上下文或多上下文布局。
建立决策地图后停止，不要直接写整个系统。后续每个会话只解决一张未被阻塞的决策票；每次决定新术语或重大取舍时，立即更新正确层级的 CONTEXT.md 或 ADR。
修改已有功能
我要修改已经存在的功能：[在这里描述变化]。
请先定位它属于哪个业务上下文，读取根 AGENTS.md、CONTEXT-MAP.md、该上下文的 CONTEXT.md、相关 ADR、旧规格和当前代码。先用白话告诉我：旧行为是什么、新行为是什么、哪些行为保持不变、影响哪些上下文。
然后使用 grill-with-docs 澄清变化。只有术语定义改变时才更新 CONTEXT.md；只有满足“难逆转、未来看会意外、存在真实取舍”时才新增 ADR。请创建新的变更规格并引用旧规格，不要悄悄改写历史。确认后再切票、逐票实现和审查。
新会话领取一张票
请只实现这张票：[票据路径或链接]。
开始前读取 AGENTS.md、CONTEXT-MAP.md、票据所属上下文的 CONTEXT.md 和 ADR，以及父规格。列出本票范围、依赖和验收条件；发现文档互相矛盾时先停止并指出，不要自行猜测。
实现时走 TDD 和小步验证。结束时分别报告：代码改动、测试证据、Spec 轴结果、Standards 轴结果，以及 CONTEXT / ADR / Spec / Runbook 是否需要同步。不要顺手实现下一张票，也不要把“测试通过”表述成“已经上线”。