Skills For Real Engineers
手动触发管编排、自动触发管纪律的可改技能集,两种装法二选一。
它解决什么问题
Matt Pocock 把自己日常真做工程用的技能从 .agents 目录开源出来,给 Claude Code、Codex 这类编程 Agent 用。典型一轮操作:敲 /grill-me,Agent 把需求盘问透才动手;/implement 在约定好的接缝驱动 /tdd,提交前先过 /code-review。README 点名 GSD、BMAD、Spec-Kit 这类方案的问题是「接管」流程——想改改不动,流程自身的 bug 也难查;这套反着来:小、可自由改造、可组合,不挑模型,一次只让 Agent 干一件事,步骤之间留人工反馈点。
它对着四个常见失败模式给解法:
- Agent 没听懂需求:grilling 盘问环节逼 Agent 把问题问透再动手,对应
/grill-me与/grill-with-docs - Agent 废话太多:
/grill-with-docs顺手沉淀项目术语表CONTEXT.md和 ADR,建立共享语言 - 代码跑不通:补齐测试、类型、浏览器反馈环,
/tdd强制红-绿-重构循环 - 代码库变泥球:
/improve-codebase-architecture定期扫出「深模块化」候选点
怎么使用
两条安装路径哲学不同,二选一,都装会让每个技能出现两份:
# 路径一:Claude Code 官方市场插件,整包只读,随作者发布自动更新
claude plugins install mattpocock-skills
# 路径二:skills.sh 安装器,把技能文件复制进你的仓库,可自由改造
npx skills@latest add mattpocock/skills路径一是「订阅」,适合只想用;路径二是「fork」,Codex 等其他 Agent 走这条路,装时可挑选技能,更新要手动跑 npx skills update。装完每个仓库跑一次 /setup-matt-pocock-skills,它会问 issue tracker 用哪个(GitHub、Linear 或本地文件)、triage 打什么标签、文档存哪。不知道从哪开始就问 /ask-matt,它给这套技能当路由。
输入与结果
全部技能按「谁能触发」分两层:
- user-invoked:只有手动敲命令才跑,负责编排,如
/grill-me、/triage、/to-spec、/wayfinder、/implement;可调用 model-invoked 技能,不能调用另一个 user-invoked - model-invoked:也可手动调,Agent 遇到合适任务会自己伸手拿,承载可复用纪律,如
/tdd、/code-review、/diagnosing-bugs、/research
输入是当前对话、计划或代码库,产出是规格、工单、HTML 架构报告或代码改动。/grilling 是底层盘问原语,grill-me、triage、wayfinder 都建在它上面;/code-review 按 Standards 与 Spec 两个维度并行审 diff。
适合谁
已经在 Claude Code、Codex 这类编程 Agent 里跑真实项目、又不想把工程流程整个交给某个框架的工程师。需求说不清、要按测试—实现—评审闭环推进的代码库,收益最直接。
使用边界
插件是托管只读整包,更新跟着作者发布走,改不了内容;skills.sh 装进来的是归你所有的普通文件,不会背后自己更新。MIT 许可,README 原话是「hack around with them, make them your own」。这套技能不替代项目自己的测试、类型检查和浏览器反馈;/improve-codebase-architecture 只是 survey 不是 rescue——老代码库能扫出真候选,但不会替你解开泥球。