AI技能工具集

项目概述

Skills For Real Engineers 是一套面向真实软件工程的 AI 代理技能合集。它不接管开发流程，而是在关键环节提供小型、可组合、可改写的实践指导，与 Claude Code、Codex、GitHub Copilot、Gemini CLI 等多种主流编程代理无缝协作。

30 秒安装

每个代理只能选用一种安装方式，避免技能重复。

Claude Code

claude plugin install mattpocock-skills@claude-plugins-official

默认自动更新。

Codex

codex plugin marketplace add mattpocock/skills
codex plugin add mattpocock-skills@mattpocock

启动时自动更新。

GitHub Copilot（CLI 与 VS Code）

copilot plugin marketplace add mattpocock/skills
copilot plugin install mattpocock-skills@mattpocock

随后一次性写入 ~/.copilot/settings.json：

{
  "extraKnownMarketplaces": {
    "mattpocock": {
      "source": { "source": "github", "repo": "mattpocock/skills" },
      "autoUpdate": true
    }
  }
}

VS Code 中执行 Chat: Install Plugin From Source，输入仓库 URL。

Gemini CLI（需手动更新）

gemini skills install https://github.com/mattpocock/skills.git --path skills/engineering
gemini skills install https://github.com/mattpocock/skills.git --path skills/productivity

其它代理或可编辑文件

npx skills@latest add mattpocock/skills -a <agent>

<agent> 可填 cursor、opencode、devin、windsurf、amp、pi；省略 -a 则交互式选择。更新时执行 npx skills@latest update。

初始化

在代理中运行 /setup-matt-pocock-skills，按提示选择问题追踪器（GitHub、GitLab、本地文件或其它）、分诊标签、文档保存目录。每个仓库只需运行一次。

设计动机：四类常见失败

1. 代理未做出想要的结果

最大失败模式是沟通错位。在动手前用 /grill-me（非编码场景）或 /grill-with-docs（编码场景）进行深度访谈，让代理反复追问需求细节。

2. 代理过于啰嗦

通过建立共享语言解决：维护 GLOSSARY.md 等术语表，让 1 个词替代 20 个词的表达。/grill-with-docs 在访谈过程中自动沉淀领域模型与架构决策记录（ADR）。附带收益是变量命名一致、代码导航成本下降、代理思考所需的 token 减少。

3. 代码无法运行

需要稳定的反馈环：静态类型、浏览器访问、自动化测试。使用 /tdd 强制红绿重构循环；排查棘手缺陷时调用 /diagnosing-bugs，按阶段执行"建立反馈环 → 最小化 → 假设 → 插桩 → 修复 → 回归测试"。

4. 代码库沦为泥球

代理加速编码的同时也加速复杂度膨胀。/to-spec 在创建规格前先确认涉及模块；/improve-codebase-architecture 周期性扫描代码库寻找"深模块"机会（功能多但接口简洁），生成可视化 HTML 报告。注意它是勘察工具，不会自动解耦既有混乱。

技能参考

技能分为两类：用户调用 仅能通过 /xxx 显式触发，负责编排；模型调用 既可手动触发也可被代理按需选用，承载可复用纪律。用户调用型可调用模型调用型，但不能反过来。

工程类

用户调用：ask-matt（路由器）、grill-with-docs、triage（分诊状态机）、improve-codebase-architecture、setup-matt-pocock-skills、to-spec、to-tickets（生成追踪子弹票）、implement、implement-spec（整规格分支实现）、wayfinder（大型任务决策地图）、retro（会话后改进代理环境）。

模型调用：prototype（可分享 HTML 原型）、diagnosing-bugs、research（后台调研并输出带引用的 Markdown）、tdd、domain-modeling、codebase-design（模块设计守则）、code-review（并行双轴评审：标准与规格一致性）、pr（生成带可视化证据与合并风险评估的 PR 描述）、wizard（生成引导人类执行专属操作的 bash 向导）。

通用效率类

用户调用：grill-me、handoff（压缩会话交接文档）、teach（多会话教学）、to-questionnaire（生成异步问卷）、wait-what（消息未理解时立刻重述）。

模型调用：grilling（访谈原语，被多个用户调用技能复用）、writing-for-agents（编写技能文档与代理导航文件）。