skills

1. 项目概述

Skills（作者 Matt Pocock）是一个开源的 AI 智能体“技能”集合——可复用、可组合的指令集，教会 Claude Code、Codex 等编程智能体严谨、贴近真实世界的软件工程实践，而非快速但不可靠的代码生成。

2. 背景与定位

Skills 的诞生是为了解决开发者在与 AI 编程智能体协作时反复遇到的四类失败模式：

1. 开发者意图与智能体输出不一致——通过 grill-me 和 grill-with-docs 等结构化访谈技能加以缓解。
2. 智能体冗长输出掩盖项目清晰度——通过共享领域语言和 CONTEXT.md 约定，让智能体始终围绕项目术语展开工作。
3. 反馈循环薄弱导致代码缺陷——通过测试驱动开发（tdd）和结构化调试（diagnosing-bugs）加以解决。
4. 快速智能体驱动开发下的架构退化——通过 improve-codebase-architecture 等设计导向技能加以预防。

与大型“一体化智能体框架”项目不同，Skills 刻意保持轻量且不预设立场：每个技能都是独立、可编辑的 Markdown 文件，而非单体系统的一部分。这使得整个集合易于阅读、调整、分叉或精简到团队恰好所需，而无需采纳一整套规定性工作流。

3. 功能分类

🛠️ 工程技能——用户调用（8 个技能）：由开发者显式触发以编排工作流。

• ask-matt —— 路由器，帮助您找到适合当前任务的技能
• grill-with-docs —— 构建项目领域模型的访谈会话
• triage —— 管理与优先级排序问题状态
• improve-codebase-architecture —— 发现并提出架构改进建议
• implement —— 内置 TDD 的功能构建
  用途：为常见的高层工程工作流提供显式入口。

🤖 工程技能——模型调用（8 个技能）：智能体在任务过程中自行决定何时应用。

• tdd —— 强制执行测试驱动开发循环
• diagnosing-bugs —— 结构化、假设驱动的调试方法论
• research —— 要求引用来源的调查工作流
• domain-modeling —— 强化并维护一致的项目术语
• code-review —— 应用双轴（正确性 + 规范符合性）审查标准
  用途：将工程纪律直接内化到智能体的默认行为中，无需开发者主动要求。

📈 生产力技能——用户调用（4 个技能）：开发者触发的工作流辅助工具。

• grill-me —— 大型任务前的详尽规划访谈
• handoff —— 生成对话摘要，将工作交接给另一个智能体会话
• teach —— 多会话技能教学，用于新成员上手
• writing-great-skills —— 编写新技能的参考指南
  用途：优化规划、上手以及会话间连续性。

🔁 生产力技能——模型调用（1 个技能）：后台工作流支持。

• grilling —— 可复用的访谈循环，供其他技能调用
  用途：提供其他访谈类技能所依赖的共享构建块。

4. 核心亮点

• 天生可组合——每个技能都是独立的小型 SKILL.md 文件，团队可按需选用，其余部分可自由编辑。
• 双调用模型——技能分为用户调用（您主动请求）和模型调用（智能体自动应用）两类，可对智能体行为进行细粒度控制。
• 内置 TDD 纪律——tdd 和 implement 技能推动智能体先写测试再写代码，直接针对“反馈循环薄弱导致代码缺陷”这一失败模式。
• 结构化调试而非猜测——diagnosing-bugs 和 research 要求智能体形成假设并引用来源，而非自由发挥。
• 领域语言锚定——CONTEXT.md 和 domain-modeling 让智能体使用项目实际术语而非泛泛表述。
• 多种安装路径——既可作为受管、自动更新的 Claude Code 插件使用，也可通过 npx skills 以可编辑文件形式用于 Codex 及其他智能体。

5. 按角色划分的使用场景

• 普通开发者：使用 grill-me 和 implement 将模糊的功能请求转化为范围明确、有测试覆盖的实现，使用 handoff 跨会话恢复工作。
• 项目/技术负责人：使用 improve-codebase-architecture 和 code-review 在智能体贡献更多代码时保持架构与审查标准的一致性。
• 将 AI 智能体引入代码库的团队：使用 setup-matt-pocock-skills、CONTEXT.md 和 domain-modeling 为智能体提供共享词汇，从第一天起减少输出偏差。

6. 快速上手

找到所需技能——浏览仓库中的技能目录和分类，或在智能体会话中直接询问路由器技能：

/ask-matt

安装/集成：

# Claude Code 插件（受管、自动更新）
claude plugins install mattpocock-skills
# 或在 Claude Code 会话中：
/plugin install mattpocock-skills

# Codex 及其他智能体（可编辑本地文件）
npx skills@latest add mattpocock/skills

# 每个仓库一次性设置
/setup-matt-pocock-skills

贡献——技能刻意保持小巧且易于调整；分叉仓库，编辑或新增 SKILL.md，并按照 writing-great-skills 中的指南提交拉取请求。

7. 项目结构

skills/
├── .agents/            # 智能体配置文件
├── .claude-plugin/      # Claude Code 插件配置
├── .github/workflows/   # CI 工作流
├── docs/                # 文档
├── scripts/             # 构建与工具脚本
├── skills/
│   ├── engineering/     # 代码相关技能（tdd、code-review 等）
│   └── productivity/    # 通用工作流技能（grill-me、handoff 等）
├── AGENTS.md            # 面向智能体的文档
├── CLAUDE.md            # Claude 专属设置说明
├── CONTEXT.md           # 项目领域模型与术语
└── LICENSE              # MIT 许可证

每个技能都位于自己的目录中，配有专门的 SKILL.md 描述其使用时机与方式，使整个集合易于浏览和扩展。

8. 相关生态

• 依赖：Claude Code（Anthropic 的编程智能体 CLI）和 Codex，这两个技能所针对的主要智能体运行时；用于安装和更新的 skills npm 包/CLI（npx skills）。
• 互补工具：任何支持自定义技能/插件加载的 Markdown 驱动型智能体原则上都可以使用这些技能文件，因为每个 SKILL.md 都是自包含的指令集。

9. 许可证

✅ 允许将代码用于个人或商业项目的使用、修改和再分发（依据 MIT 许可证）。
✅ 允许分叉仓库并根据团队自身工作流调整个别技能。
❌ 再分发时不得移除原始版权和许可证声明。
ℹ️ MIT 许可证按“原样”提供软件，不附带任何担保——生产使用前请查阅仓库中的 LICENSE 文件了解完整条款。

10. 常见问题

问：使用这些技能必须用 Claude Code 吗？
答：不需要——Claude Code 用户可通过插件市场安装，而 Codex 及其他智能体用户可通过 npx skills@latest add mattpocock/skills 安装可编辑文件。

问：如何保持技能更新？
答：Claude Code 插件会自动更新；手动安装的文件可运行 npx skills update。

问：用户调用和模型调用技能有什么区别？
答：用户调用技能由您显式触发（如 /grill-me），而模型调用技能（如 tdd、diagnosing-bugs）由智能体在相关时自动应用。

问：我可以编写自己的技能吗？
答：可以——请参阅仓库中的 writing-great-skills 技能获取编写指南和约定。

问：安装后是否需要额外的设置步骤？
答：需要——每个仓库运行一次 /setup-matt-pocock-skills 以配置问题跟踪、分类标签和文档位置。

11. 快速链接

• 仓库：https://github.com/mattpocock/skills
• 许可证：https://github.com/mattpocock/skills/blob/main/LICENSE
• 问题：https://github.com/mattpocock/skills/issues
• 讨论/社区：通过仓库的 Issues 和 Pull Requests 进行

12. 总结

Skills 为团队提供了一套轻量、可编辑的工具包，让 AI 编程智能体表现得像严谨的工程师——编码前先规划，发布前先测试，并始终扎根于项目的真实领域语言。它最适合已经依赖 Claude Code 或 Codex、希望在无需引入重型框架的前提下获得更一致、可审查输出的开发者和技术负责人。