mattpocock/skills
这是什么
Matt Pocock（Total TypeScript 作者）公开的 .agents 技能目录：41 个技能按六桶组织。设计哲学是"技能即纪律"——每个技能不接管整个开发流程，只在一个决策点上施加约束：先写测试、先定术语、先把计划拆成工单。桶的划分本身就是演化史：deprecated 留旧设计、in-progress 放实验品、engineering 是验证过的主力。整个仓库还是一个可运行的方法论闭环：setup 技能配好 issue 跟踪器后，triage → to-spec → to-tickets → implement → code-review 首尾相接。
使用建议
不要全量安装。先挑 engineering 桶里和你工作流重合的 3-5 个装进 .agents/skills，用两周再决定加不加。in-progress 桶别装，看思路就好。二开方向：照它的结构写自己的技能，比改它的技能更值。
先看这几个
ask-matt— 全库路由器，不知道用哪个技能就先问它grill-me / grilling— 拷问式规划访谈，本站的蓝图、记忆库、本页面都是这套流程的产物tdd— 工程桶核心，red-green-refactor 纪律的落地to-tickets— 把计划拆成带阻塞关系的可执行工单，方法论闭环的关键一环wayfinder— 规划单会话装不下的大工程：决策工单地图 + 多会话接力
技能目录
deprecated 4
已被新设计取代的旧技能，留着当演化史看。
design-an-interface模型可载（已弃用）用并行子代理为模块生成多个截然不同的接口设计。
qa模型可载（已弃用）对话式 QA：用户口述 bug，agent 后台探索代码库并整理成 GitHub issue。
request-refactor-plan模型可载（已弃用）通过访谈制定小步提交的重构计划，归档为 GitHub issue。
ubiquitous-language手动调用（已弃用）从当前对话提取 DDD 式统一语言词汇表，标记歧义、提议规范术语。
engineering 17
核心桶。覆盖 spec、工单、实现、审查、诊断的完整工程循环，多数技能需要 setup-matt-pocock-skills 先跑一次配好 issue 跟踪器。
ask-matt手动调用技能路由器：描述你的处境，它告诉你该用哪个技能或流程。
code-review模型可载双轴审查某个基准点以来的变更：是否符合本仓库编码规范 + 是否实现原始需求，并行子代理出报告。
codebase-design模型可载深模块设计的共享词汇表：接口设计、模块加深、可测试性与 AI 可导航性。
diagnosing-bugs模型可载疑难 bug 与性能回归的诊断循环。
domain-modeling模型可载构建并维护项目的领域模型：术语、统一语言、架构决策记录。
grill-with-docs手动调用拷问式访谈打磨方案，过程中同步产出 ADR 和术语表。
implement手动调用按 spec 或工单集实现一个工作单元。
improve-codebase-architecture手动调用扫描代码库的模块加深机会，生成可视化 HTML 报告，再对选定项拷问落地。
prototype模型可载为回答一个设计问题而建的即用即弃原型：状态模型、逻辑手感、UI 形态。
research模型可载针对问题调研高信任度一手资料，结论落盘为仓库内 Markdown。
resolving-merge-conflicts模型可载解决进行中的 git merge / rebase 冲突。
setup-matt-pocock-skills手动调用首次使用前的一次性配置：issue 跟踪器、triage 标签体系、领域文档布局。
tdd模型可载测试驱动开发，red-green-refactor。
to-spec手动调用把当前对话直接合成为 spec 并发布到 issue 跟踪器，无访谈环节。
to-tickets手动调用把计划 / spec / 对话拆成一组带阻塞关系的 tracer-bullet 工单。
triage手动调用把 issue 和外部 PR 推过分诊状态机：分类、验证、拷问、写成 agent 可执行的简报。
wayfinder手动调用规划单会话装不下的大工程：决策工单地图，逐个解决直到路径清晰。
in-progress 9
实验田。思路值得看（尤其写作三件套），但别装——作者自己还在改。
batch-grill-me手动调用批量拷问：一轮问出所有关键问题，逐轮推进。
claude-handoff手动调用把当前对话交接给一个新的后台 agent 立即继续。
loop-me手动调用围绕你想构建的工作流，在本工作区内拷问出 spec。
setup-ts-deep-modules手动调用把 dependency-cruiser 接入 TS 仓库，强制每个包成为深模块。
to-questionnaire手动调用把你答不了的决策变成问卷，转给能回答的人。
wizard手动调用生成交互式 bash 向导，带人走完手工流程：第三方配置、一次性迁移、状态转换。
writing-beats手动调用写作·组装：把素材组织成节拍递进的旅程，先立术语再推进。
writing-fragments手动调用写作·探索：挖掘原始碎片，尚无结构。
writing-shape手动调用写作·成型：把素材逐段打磨成文章。
misc 4
单点小工具：git 安全护栏、测试迁移、pre-commit 钩子，各自独立。
git-guardrails-claude-code模型可载给 Claude Code 配 hooks，在危险 git 命令（push、reset --hard、clean 等）执行前拦截。
migrate-to-shoehorn模型可载把测试中的 as 断言迁移到 @total-typescript/shoehorn。
scaffold-exercises模型可载生成课程练习目录结构：分节、题目、答案、讲解。
setup-pre-commit模型可载配置 Husky + lint-staged 的提交前钩子：格式化、类型检查、测试。
personal 2
作者个人工作流（写作、Obsidian），参考价值大于直接复用。
edit-article手动调用改文章：重构章节、提升清晰度、收紧行文。
obsidian-vault模型可载在 Obsidian vault 里搜索、创建、管理笔记（wikilinks + 索引笔记）。
productivity 5
通用生产力：拷问、交接、教学、写作方法论。与具体代码库无关，任何项目都能用。
grill-me手动调用拷问式规划访谈：连续追问，把模糊想法逼成可执行蓝图（手动调用）。
grilling模型可载模型侧的拷问技能：对用户的计划、决策或想法穷追猛打。
handoff手动调用把当前对话压缩成交接文档，交给另一个 agent 继续。
teach手动调用在本工作区内教你一项新技能或概念。
writing-great-skills手动调用写好技能的参考手册：让技能可预测的词汇与原则。
目录结构
.agents/
.agents/adr/
.changeset/
.claude-plugin/
.github/
.github/workflows/
.out-of-scope/
docs/
docs/engineering/
docs/productivity/
scripts/
skills/
skills/deprecated/
skills/engineering/
skills/in-progress/
skills/misc/
skills/personal/
skills/productivity/