信息卡

一句话定位

知名 TypeScript 教学者 Matt Pocock 将自己 `.agents` 目录里每天真实使用的 AI 编程代理技能整体开源，口号为 "Skills for Real Engineers"。与 GSD、BMAD、Spec-Kit 这类试图"接管全流程"的重量级框架不同，这套技能刻意保持小而精、易于修改和组合，可搭配任意模型使用，并明确鼓励用户改造成自己的版本。

趋势解读：为什么火

Agent Skills 正成为 AI 编程协作的新封装单位，竞争焦点已从"谁的框架更强"转向"谁的工作方法值得抄作业"。该仓库兼具顶级技术教育者信誉背书与明确的工程问题导向：它不再泛谈提示词技巧，而是逐一击破 LLM 编程的四类失败模式——没理解需求、输出啰嗦、代码跑不通、沦为泥球——方法论加流量双轮驱动，使其登顶月度趋势榜第一。

核心功能拆解

• 需求对齐：用 `/grill-me` 或 `/grill-with-docs` 发起拷问式对齐，逼代理先把需求问清楚再动手。
• 共享领域语言：建立团队术语表并写入 `CONTEXT.md`，把冗长描述压缩为固定短语，既提升一致性又降低 token 消耗。
• 反馈循环：以静态类型、浏览器访问和自动化测试闭环验证代码，配套 `/tdd`（红-绿-重构）与 `/diagnosing-bugs`。
• 防泥球设计：用 `/to-spec` 和 `/improve-codebase-architecture` 定期做架构巡检，作者强调"It is a survey, not a rescue"，建议每隔几天跑一次。
• 编排分层：Engineering 含 9 个用户级技能（ask-matt 路由、triage、to-tickets、wayfinder 大范围规划等）与 9 个模型级原语（prototype、research、domain-modeling、code-review 双轴子代理审查、wizard 生成交互式 bash 向导等）；Productivity 含 grill-me、handoff 对话压缩交接、teach 等。
• 配置向导：`setup-matt-pocock-skills` 引导选择 issue 跟踪器（GitHub/Linear/本地文件）、triage 标签与文档位置。

架构与技术栈浅析

仓库本质是一组扁平组织的 Markdown `SKILL.md` 文件，按 engineering 与 productivity 两类分目录存放，不依赖传统软件栈。用户级技能只能调用模型级原语，形成清晰的编排层次；分发走 Claude Code 插件市场与 skills.sh CLI 双通道，兼容 Codex 等其他代理（Codex 原生插件已在 ADR 路线图中）。

安装与环境要求

两种方式二选一（同时安装会导致技能重复）。方式一：Claude Code 官方插件市场托管只读自动更新；方式二：skills.sh 复制为可编辑文件，更新需手动执行 `npx skills update`。

claude plugins install mattpocock-skills   # 方式一
npx skills@latest add mattpocock/skills    # 方式二，勾选 setup-matt-pocock-skills

快速上手示例

每个仓库运行一次初始化，再按需显式调用用户级技能即可：

/setup-matt-pocock-skills   # 配置 issue 跟踪器、标签与文档位置
/grill-with-docs            # 开工前对齐需求
/to-spec                    # 把想法固化为规格

进阶使用要点

• 让代理主动调用模型级原语（grilling、research、wizard），无需手动指定。
• 善用 CONTEXT.md 术语压缩，长上下文场景能显著省 token。
• `/handoff` 可把超长会话压缩成交接文档，跨会话续工。
• `/improve-codebase-architecture` 输出可视化 HTML 扫描报告，定位结构性债务。

典型应用场景

• 新功能开发：先 `/grill-with-docs` 拷问需求，`/to-spec` 成规格后 `implement` 分步落地。
• 疑难 Bug 诊断：用 `/diagnosing-bugs` 做系统性根因排查，避免打补丁式修复。
• 架构健康巡检：每隔几天运行一次架构扫描，按报告渐进还债而非一次性大重写。
• 任务交接：用 `handoff` 把当前会话状态浓缩成文档交给同事或新会话。

同类生态位对比

相比 obra/superpowers 这种全流程强制方法论的"操作系统级"框架，本仓库更像一套可拆装的精品工具箱；相较 Spec-Kit 偏重规格驱动流程，它把重心放在日常实战纪律上，两者常被搭配使用。

资源导航

• 仓库：https://github.com/mattpocock/skills
• 作者 newsletter：Matt Pocock 约 6 万订阅者的 TypeScript 与 AI 工程通讯（见仓库内订阅入口）