一句话

Matt Pocock 日常自用的 agent 技能集：小而可组合、不接管流程，主线是 grill-with-docs 到 spec 到 tickets 到 implement 到 PR，靠上下文卫生（智能区约 150k）和阶段边界五选项把多会话工程串起来。

定位与安装

• 哲学：GSD、BMAD、Spec-Kit 想拥有流程，这套技能只提供小工具，由你保有控制权；面向 Claude Code、Codex 等编码 agent。
• 安装：Claude Code 用 claude plugin install mattpocock-skills@claude-plugins-official（自动更新）；其他 agent 用 npx skills@latest add mattpocock/skills -a <agent>；每个 agent 只装一份，装重了技能会翻倍。
• 装完每 repo 跑一次 /setup-matt-pocock-skills：配 issue tracker、triage 标签、领域文档布局。
• 分桶：engineering/ 和 productivity/ 是 promoted（插件发布、有 docs 页）；misc/ 留着不主推；in-progress/ 是 beta，要用 --skill=<name> 单独装；deprecated/ 已弃。

入口与用法

• 用户调用 vs 模型调用：用户调用的技能带 disable-model-invocation: true（Codex 是 agents/openai.yaml 里 policy.allow_implicit_invocation: false），只能你敲 /命令 触发；模型调用的技能描述里写足触发语，agent 看任务合适会自取，你也能手敲。
• matt-ask-matt 是路由器：不知道用哪个技能就问它，它只回答下一步该敲什么。
• 主线流程（idea 到 ship）：
  1. /grill-with-docs 访谈定计划（不在工作目录用 /grill-me）。
  2. 谈话定不下的设计问题绕行 /handoff 出 → /prototype → /handoff 回。
  3. 多会话工程：/to-spec → /to-tickets（带 blocking edges 的纵切票）→ 每票 /implement（票间 /clear）或一次 /implement-spec 并行跑任务图。
  4. 构建内部靠模型调用的 matt-tdd（红绿竖切）和 matt-code-review（Standards+Spec 双轴）。
  5. 提 PR 时 matt-pr 定 body 形状；/retro 收尾复盘环境。
• 上下文卫生：智能区（smart zone）约 150k token，模型在此内推理才锐利；grill 到 to-tickets 留在同一窗口不 compact。阶段边界只在阶段交界处决定，五选项按序问：Continue（下一棒需要本阶段当 primary source，先排除）→ /clear（上下文无关就最便宜）→ /handoff（仅换 harness/目录/交同事/分叉支线）→ subagent（能 AFK 的活）→ /compact（兜底默认，不是首选）。
• 入口匝道：别人来的 issue 走 matt-triage；硬 bug 走 matt-diagnosing-bugs；超大模糊工程走 matt-wayfinder 画决策地图；定期保养走 matt-improve-codebase-architecture。

技能索引

engineering

• matt-ask-matt：技能路由器，回答下一步敲什么。
• matt-setup-matt-pocock-skills：每 repo 一次的初始化（tracker、标签、域文档）。
• matt-grill-with-docs：在 repo 里的访谈，顺手写 GLOSSARY.md 和 ADR。
• matt-triage：别人的 issue/外部 PR 过状态机，产出 agent-ready brief。
• matt-diagnosing-bugs：硬 bug 六阶段诊断，先造变红反馈环。
• matt-wayfinder：超大工程画共享决策地图。
• matt-improve-codebase-architecture：扫 deepening 机会出 HTML 报告。
• matt-to-spec：会话综合成 spec 发到 tracker。
• matt-to-tickets：拆成带 blocking edges 的纵切票。
• matt-implement：一票一会话实现，调 tdd+code-review。
• matt-implement-spec：整 spec 并行跑完，落 integration branch。
• matt-tdd：约定 seam 上的红绿竖切参考。
• matt-code-review：Standards+Spec 双轴评审。
• matt-codebase-design：深模块词汇（interface/depth/seam/leverage/locality）。
• matt-domain-modeling：打磨领域模型、写 GLOSSARY.md 和 ADR。
• matt-prototype：一次性原型回答设计问题。
• matt-research：后台 agent 读一手来源出带引用的 md。
• matt-pr：PR body 形状（Summary/Evidence/Merge Danger）。
• matt-wizard：生成带人走手动步骤的 bash 向导。
• matt-retro：复盘会话，改进 agent 环境。

productivity

• matt-grill-me：无 repo 时的同款访谈，stateless。
• matt-grilling：访谈原语，被各外层技能内部调用。
• matt-handoff：会话压成可携带的交接文档。
• matt-teach：目录变教学工作区，跨会话教主题。
• matt-to-questionnaire：给「脑子里有答案的人」写问卷。
• matt-wait-what：没听懂时的三行纠偏命令。
• matt-writing-for-agents：写给 agent 的文档规范。

misc（frozen，不主推）

• matt-git-guardrails-claude-code：Claude Code 钩子拦危险 git 命令。
• matt-migrate-to-shoehorn：测试 as 迁到 shoehorn。
• matt-scaffold-exercises：课程练习目录脚手架。
• matt-setup-pre-commit：Husky+lint-staged 提交前检查。

in-progress（beta，插件不装）

• matt-chief-of-staff：长期目标的 DRI，子代理+wiki。
• matt-claude-handoff：claude --bg 起后台 agent 接着干。
• matt-loop-me：访谈出可实现的工作流 spec。
• matt-setup-ts-deep-modules：dependency-cruiser 强制 TS 深模块。
• matt-writing-beats：beat 之旅式写文章。
• matt-writing-fragments：攒写作碎片素材。
• matt-writing-shape：素材逐段塑形成文。

本机状态

• ~/.agents/skills 安装情况（manifest local 统计）：same 19、outdated 17、missing 2。
• missing：ask-matt、chief-of-staff。
• outdated 里大部分是 CONTEXT.md → GLOSSARY.md 的改名；少数还有真实行为差（implement-spec、implement、to-tickets、wayfinder、claude-handoff、diagnosing-bugs、code-review 等），对应笔记里有「本机版本差异」框。

使用建议

• 省 token：grill 到 to-tickets 三步留同一窗口别 compact；之后每张票 /clear 再 /implement；implement-spec 并行快但 token 高；research、扫描、探索都派子代理只拿回文件或摘要。
• 技能越少越稳：AGENTS.md/CLAUDE.md 只放指针，按需触发；misc 和 in-progress 不装也不影响主线。
• 换 tracker 不用改技能：改 docs/agents/*.md，技能运行时读它。

关联

• 总览：00-首页 · 术语：01-术语表 · 对比：02-仓库对比 · 选工作流：00-怎么选工作流
• 工作流：W1-快修、W2-单会话功能、W3-多会话功能、W4-大型模糊项目、W5-接手老项目与技术调研、W7-交付与运维循环