mattpocock/skills

这是作者本人在日常开发中使用的 Agent 技能集，目标是用编码 Agent 做"真正的工程"，而不是"vibe coding"。每个技能是小的、可修改的 Markdown 文件，作者称其适用于任何模型；内容分为工程类（规划、规格、工单、TDD、Bug 诊断、架构改进、代码评审）和通用效率类。由于它们服务于写代码和维护代码的 Agent，本项目属于开发者工具，而非通用 AI 应用框架。

工作流上的实际变化

这套技能不是由某个工具接管整个流程，而是按名称调用的编排组件。典型流程是：先用 /grill-with-docs 反复追问你的改动，并把项目术语提炼进 GLOSSARY.md 和 ADR；再用 /to-tickets 把规格拆成带阻塞关系的「曳光弹」工单；最后由 /implement 逐张实现，过程中驱动 /tdd，收尾执行 /code-review。另一种方式是 /implement-spec，在同一个集成分支上按任务图的就绪前沿并行派发子 Agent 来实现整份规格。调用方式分两类：用户调用型需要你手动输入，负责编排；模型调用型既可由你触发，也可由 Agent 在任务合适时自行使用。用户调用型可以调用模型调用型，但用户调用型之间不能互相调用（README 参考章节）。

关键机制

• 用共享语言代替啰嗦。 /grill-with-docs 与 /domain-modeling 把约定术语写入词表，并把难以解释的决策记入 ADR。作者认为这还能让命名保持一致，并减少 Agent 在推理上的 token 消耗（grill-with-docs、domain-modeling）。
• 反馈回路决定速度上限。 /tdd 强制以小的纵向切片执行 red-green-refactor；/diagnosing-bugs 则执行分阶段把关的循环，先做出能失败的复现，再提出假设并修复（tdd、diagnosing-bugs）。
• 把设计当作持续工作。 /improve-codebase-architecture 会扫描代码库，以报告形式给出可加深模块的候选，再就你选中的那项继续追问。作者明确说明它只是勘察而非抢救，对真正陈旧的代码库会找到真实候选，但不会替你理清烂摊子（improve-codebase-architecture）。

安装与适用范围

每个 Agent 只选一种安装途径：Claude Code 和 Codex 插件可自动更新；GitHub Copilot（CLI 与 VS Code）需要一次性写入配置，之后每日更新；Gemini CLI 为手动安装，需重跑命令来更新；其他 Agent 或想要可编辑文件时使用 skills CLI，安装时勾选列表中必须包含 setup-matt-pocock-skills，否则需重跑 add 补齐。插件和复制文件两种方式同时安装会让每个技能出现两次（安装章节）。安装后每个仓库运行一次 /setup-matt-pocock-skills，回答使用哪种 issue tracker、分诊标签和文档存放位置——多个技能依赖这项配置。项目采用 MIT 许可证。README 没有提供测试套件、基准或效果评估；现有依据是作者对自身日常实践的描述。