Agent Skills 工程化实践 06：把人的判断留在回路里

一套流程不应该把人从系统里移除

Agent Skills 的目标不是把所有判断都自动化，而是把不同类型的判断放到合适的位置：事实由工具查，重复纪律由 Skill 固定，产品取舍和不可逆操作由人确认。

这也是 productivity bucket 存在的原因。它处理的不是某个框架的 API，而是 phase boundary、知识交接、外部信息和写作质量——这些地方如果缺少人工参与，自动化越顺滑，错误越难被发现。

先安装，再做一次 per-repo setup

中文仓库是 upoahz/mattpocock-skills-zh 的私有 fork，README 同时记录了两条互斥的入口：把仓库作为 Claude Code plugin 使用，或通过 skills.sh 把普通 Skill files 复制到项目。两种方式不要叠加，否则同一个 Skill 会出现两份。

安装之后，在真正工作的 repo 中运行一次 /setup-matt-pocock-skills。它会确认 issue tracker、triage labels、CONTEXT.md/ADR 布局，并在 AGENTS.md 或 CLAUDE.md 中加入指针。它是 prompt-driven bootstrap，不是把默认配置无声写进去的脚手架。

这些工具分别把什么交给人

research：查事实，不替你做决定

research 适合 external API behavior、版本声明和规范 wording。它只使用 official docs、source code、specs 和 first-party API 等 primary sources，并在 repo 留下一份带 citations 的 Markdown。研究结果提供 facts，最终选择仍回到 grilling 或 grill-with-docs。

wizard：把只能由人完成的步骤结构化

Provisioning、credential setup、CI secret、陌生 dashboard、不可逆 migration 都不该被 Agent 假装完成。wizard 会生成带 progress、confirmation gate、hidden secret input 和 closing summary 的 interactive bash script；Agent 负责把步骤整理清楚，人负责真正的权限和操作。

handoff：在 phase boundary 交接 context

当需要换目录、换 harness、交给同事或开启 side task 时，用 handoff 把当前状态压缩成可继续的 Markdown。它引用已有 specs、ADRs、issues、commits 和 diffs，而不是复制一大段内容；新 session 只需要知道下一步、artifact path 和 suggested skills。

ask-matt 与 wait-what：降低导航成本

不确定处于 idea、bug、planning、implementation 还是 review 阶段时，先问 /ask-matt；如果上一条解释没有被理解，用 /wait-what 重新表达，而不是继续堆 jargon。前者是 flow router，后者是 corrective，它们都不应该替用户执行真正的 change。

一条渐进采用路线

可以按下面的顺序把仓库带进团队，而不是一次性追求“全技能覆盖”：

1. 先采用 grill-with-docs，建立 glossary 和决策记录；
2. 用 to-spec → to-tickets → implement 交付一个真实的小功能；
3. 加入 tdd 和 review checkpoint，让每次 change 有反馈和 fixed point；
4. 遇到 hard bug 时再启用 diagnosing-bugs，不要把完整流程套到 typo 上；
5. 最后根据重复出现的摩擦，补充 research、wizard、handoff 或 architecture health。

这条路线的重点不是记住 25 个 Skill 的名字，而是让一个团队逐渐形成自己的 trigger vocabulary：什么时候是 frontier，什么时候需要 seam，什么时候应该建立 checkpoint，什么时候必须停下来等人。

系列结语：好的自动化会留下接管点

如果 Agent 做得很好，结果不应该是“没人知道它怎么做到的”，而应该是：下一个人能读懂 context、验证 behavior、审查 diff，并在任何一个 phase boundary 接手。

这套 Skills 最值得带走的原则可以压缩成一句话：让每一步都更容易被验证、交接和复盘。自动化不是把人从 loop 中删除，而是让人只在真正需要判断的地方出现。

来源与版本

• 中文仓库：upoahz/mattpocock-skills-zh
• 中文教程：docs/中文使用教程.md
• 安装与路由规则：README.md
• 参考分支：main · 核验 commit：022fcc3 · 核验日期：2026-08-12