Codex / Claude Code Cheatsheet

Matt Pocock Skills

按项目工作场景查命令。先初始化一次,再按“想清楚、拆 spec/tickets、写代码(逐个 ticket 或整份 spec 并发)、调问题、改结构、做 review、写 PR、收工复盘”选 skill。v1.3 起 $implement-spec、$pr、$retro 转正进 engineering,术语表改名 GLOSSARY.md。v1.3.2 收进此前 main 上的这些修补(见下方各项):$implement 先取 ticket 并复述标题,$tdd 的 seam 标注能抓什么 / 漏什么,$grilling 的问题改成「答 yes 即采纳推荐」。main@4ae2317:新增 in-progress 的 $software-factory 术语表;$chief-of-staff 优先复用共享 wiki,并把 retro / implement-spec 写成 procedures;$implement-spec 每个 ticket 派新的 implementer 子 agent;派子 agent 的 skill 统一要求新开上下文,不要 fork 当前会话;$setup-matt-pocock-skills 补齐可达仓库、legacy CONTEXT.md 与 tracker 模板。

upstream v1.3.2 main@4ae2317 更新于 2026-11-02
所有复制按钮都会复制可直接贴进 Codex 的提示词

最短记忆

不用记全套。主线是 grill → spec → tickets → implement(逐个)或 implement-spec(整份并发)→ code-review → retro。开 PR 时 agent 会自动套 $pr 正文模板(model-invoked)。收工在同一会话里跑 $retro:机械问题落成 deterministic checks。老项目的 CONTEXT.md 记得 git mv 成 GLOSSARY.md。

项目只跑一次

配置 issue tracker、triage labels、领域文档位置(GLOSSARY.md + docs/adr/)。之后其他 engineering skills 会读这些约定。

$setup-matt-pocock-skills

先把需求问清楚

新功能、重要改动、方案还模糊时用。会一边追问,一边把术语写进 GLOSSARY.md、把决定写成 ADR。

$grill-with-docs 我想做……

拆成 tickets

把方案、spec 或讨论结果拆成 tracer-bullet tickets,并声明 blocking edges。这些边决定之后能并发跑哪些 ticket。

$to-tickets 把上面的方案拆成 tickets

用测试驱动实现

逐个 ticket 用 $implement(内部跑 $tdd,ticket 之间清上下文);想一次跑完整份 spec 就用 $implement-spec。

$implement 实现这个 ticket

按场景查

你不需要记 skill 名。先找当前场景,再复制对应提示。

不知道该用哪个

万能入口。把你要做的事说出来,让它推荐流程。v1.3 起它也会把你路由到 $implement-spec、$pr 和 $retro。

路由新手优先
$ask-matt 我现在想……应该怎么走?

准备做新功能

先用文档化追问对齐需求(术语进 GLOSSARY.md,决定进 ADR),再需要的话转 spec 或 tickets。

需求领域语言ADR
$grill-with-docs 我想做……

上一句没听懂

立刻纠正啰嗦。让它带一点上下文、用简化英语、并用 GLOSSARY.md 里的项目术语重说上一句(多上下文仓库会顺着 GLOSSARY-MAP.md 找对那份)。只修这一条,不防下一句。

wait-what纠偏
$wait-what

遇到 bug 或性能问题

按复现、最小化、假设、插桩、修复、回归测试的诊断循环走。命令、输出和捕获物先脱敏。修好后在同一会话跑 $retro 问“什么能提前防住它”;若结论是缺一个能锁住它的 seam,再交给 $improve-codebase-architecture。

debug性能回归测试
$diagnosing-bugs 这个问题是……

一次跑完整份 spec

已有 spec + 带 blocking edges 的 tickets 时用(user-invoked)。把 tickets 当 task graph:对已就绪的 frontier 并发派 implementer 子 agent——每个 ticket 一个全新上下文的 implementer(不要 fork 当前会话),各自在独立 worktree/分支上用 $tdd 实现,完成前先把 integration 分支最新提交并进自己分支,再由 merger 子 agent 合入同一条 integration branch;全部完成后跑一次 $code-review,并用一个新的 implementer 统一修复。目标是 integration 分支,不是 PR:只有 tracker 靠 PR 关单或你要求时,才在第一次合并后开 draft PR。没配 tracker 会让你先跑 $setup-matt-pocock-skills。

implement-spec并发worktree
$implement-spec 实现这份 spec

Code review 一个分支或 PR

从指定 commit、branch、tag 或 merge-base 开始,对 diff 做 standards 和 spec 两条线审查。两条线并行派子 agent,各自新开上下文,再汇总。

code-reviewPRdiff
$code-review since main

写 PR 正文

v1.3 起转正进 engineering,随 Claude Code 插件一起装;model-invoked,agent 写 PR 时会自己套用(是格式参考,不是多步工作流)。模板:Summary(最能说明改动的最小视觉:伪代码 / call tree / 组件树 / 文件树 / Mermaid / diff,内容来自 issue/spec 等 primary source,不从 diff 推断;组件树示例现为纯文本缩进)、Evidence(before/after 证明它能用)、Merge Danger(Door:one-way / two-way;Blast Radius:先一词概括影响面,再可选展开)。术语用 GLOSSARY.md 里的。credits:Dex Horthy 的 show-me。

prformat referencemodel-invoked
$pr 按模板写这份 PR 正文

收工后给会话做复盘

v1.3 起转正进 engineering,是主流程最后一步($code-review 之后),user-invoked,不再标 stub。改的是 agent 的环境而不是代码:导航指针、自动检查、coding standards、steering 文件、tool 经济性、no-ops、信息获取,按严重程度排序。先读仓库已有的 lint/check/CI;完全没有 guardrail 本身就是 finding。机械违规默认落成 deterministic check(linter / pre-commit / CI),CODING_STANDARDS.md 只留给需要判断的 judgement calls。最好在被复盘的会话里、清上下文之前跑;清了就把会话日志指给它。

retrodeterministic checks主流程收尾
$retro 复盘刚才这轮会话

代码开始变乱

扫描正在改的区域,找 deepening 机会。先看你指定的方向,否则沿 commit 历史找热点,不扫没人动的角落。领域命名以 GLOSSARY.md 为准。探索子 agent 新开上下文。

架构复杂度模块边界
$improve-codebase-architecture

把讨论变 spec

不继续采访,直接把当前对话和项目理解整理成 spec,并发布到项目配置的 issue tracker。

spec原 PRD
$to-spec 把上面的讨论整理成 spec

把问题交给别人填

当关键事实或决策在别人那里时,生成一份 async discovery questionnaire。追问的是寄给谁、要什么,不是主题本身。

questionnaireasyncproductivity
$to-questionnaire 为……生成问卷

逐个 ticket 开发

已经有 spec 或 tickets、想自己一张张推进时用。在预先约定的 seam 上跑 $tdd,收尾再 $code-review;每张 ticket 之间清一次上下文。想让 agent 并发跑完整份 spec,改用 $implement-spec。

实现已有任务
$implement 实现这个 ticket

规划很大的工作

工作超出单轮上下文时,用 wayfinder 画 decision tickets 地图。地图清完后走 $to-spec,不要直接 $implement。research 子 agent 各自新开上下文。

wayfinder大项目
$wayfinder 我想规划……

让后台 agent 做研究

针对官方文档、源码、规范、第一方 API 做 primary-source research,并留下引用文档。后台研究子 agent 新开上下文,不 fork 当前会话。

researchprimary sources
$research 调查……

只有人能点的步骤

第三方后台、CI secrets、一次性迁移这类 agent 点不了的步骤,做成交互式 bash wizard。

wizard人工操作
$wizard 帮我生成配置……的 wizard

写给 agent 看的文档

写或改 skills、AGENTS.md / CLAUDE.md 时用。强调正向表述、环境即真相,不要把配置再抄进文档。$retro 第一步也会先读它。

writing-for-agents文档
$writing-for-agents 帮我改这个文档

merge/rebase 冲突

v1.3.0 移除了 $resolving-merge-conflicts,没有替代 skill:upstream 认为 agent 不靠专门 skill 也能处理进行中的 merge/rebase 冲突。直接用普通提示让它处理即可。旧文档页仍在 aihero.dev,标为 archived。

git已移除
当前有 merge 冲突,请解决

先做个原型验证

用一个可分享的 HTML 文件回答设计问题。原型是 primary source:丢到 prototype/<name> 分支上,结论再写进 issue/ADR。

原型探索
$prototype 我想验证……

安装与更新

main@49dd158 起 README 先推「会自己更新」的安装。Claude Code:claude plugin install mattpocock-skills@claude-plugins-official,默认自动更新。Codex:先 codex plugin marketplace add mattpocock/skills,再 codex plugin add mattpocock-skills@mattpocock,启动时自动更新。Copilot CLI:同样 marketplace add + install mattpocock-skills@mattpocock,再在 ~/.copilot/settings.json 里一次性开 autoUpdate: true;VS Code 用 Chat: Install Plugin From Source,每日更新。Gemini CLI 要按 bucket 各装一次且需手动重跑。其他 agent 用 skills.sh,手动 npx skills@latest update,新增 skill 要重新 add。插件和 skills.sh 二选一,别都装。

安装自动更新
claude plugin install mattpocock-skills@claude-plugins-official

想给上游提 issue 或建议

main@49dd158 新增 SCOPE.md:idea / 反馈 issue 只在同时满足两点时保持打开——有真实会话里的可观察失败(你跑了什么、skill 做了什么、你期望什么),且不属于 .out-of-scope/ 已否决的概念或只服务个人工作流的调整。反应和 +1 不计。misc/ 已冻结且 issue 全关;新增 skill 的提案和贡献关闭。无法判断的 issue 会被问一轮并打 needs-info,14 天无回复自动关闭。新 issue 一律先打 needs-triage,有表单(bug / idea)。问题和讨论去 GitHub Discussions。

SCOPE.mdneeds-info
$triage

设计一套 software factory

in-progress(main@4ae2317 新增,user-invoked)。给「由 agent 把 tickets / PR / 定时任务变成合并后的代码并部署」的系统设计统一术语:Task / Trigger / Run / Runner,以及 Ticket tracker、Ticket source、Git host、Orchestrator、Observability platform。从用户真实问题起步(未分流 tickets、等自动 review 的 PR、要迁移的更严检查),一次只加一个自动触发并配齐刹车;填槽位时读附带的 trackers / git hosts / runners / observability 调查。可与 grilling 同开。

software-factory术语表in-progress
$software-factory 我想设计……

把上下文交给下一轮

把当前对话压缩成 handoff 文档,适合换线程或让另一个 agent 接着做。

交接总结
$handoff 下一轮要继续……

常用流程

把多个 skill 串起来用,适合真实项目。

新功能从想法到代码

先对齐,再文档化,再拆 tickets,逐个实现并 review;开 PR 时 agent 自动套 $pr 模板;最后在同一会话里 $retro 收尾。grill → tickets 这段尽量放在同一个上下文窗口里。

$grill-with-docs→$to-spec→$to-tickets→$implement→$code-review→$retro

整份 spec 并发实现

tickets 已声明 blocking edges 时,让 $implement-spec 按 frontier 并发派子 agent,结果都落到一条 integration 分支上。它内部已含每张 ticket 的 $tdd 和最后一次 $code-review,不用再手动跑。

$to-spec→$to-tickets→$implement-spec→$retro

修一个难复现 bug

先诊断,确认根因后用回归测试锁住行为,命令和输出先脱敏。修好后同一会话跑 $retro 问能怎样提前防住;缺 seam 时再开 $improve-codebase-architecture。

$diagnosing-bugs→$tdd→$retro

规划超出单轮的大工作

wayfinder 只做决策地图。地图清完后并回主流程,不要从地图直跳实现。

$wayfinder→$to-spec→$to-tickets→$implement

做一轮架构整理

先找正在改的路径上的 deepening 机会,再设计边界,最后用测试保护改动。

$improve-codebase-architecture→$codebase-design→$tdd

不知道从哪开始

把目标说清楚,让路由 skill 选流程。看不懂回复时立刻 $wait-what。

$ask-matt→按它建议继续

实现后开 PR

实现并 review 完再写 PR 正文。$pr 现在是 engineering 里的 model-invoked 格式参考,agent 写 PR 时会自己调用;想强制用就显式写 $pr。Summary 来自 primary source,Merge Danger 里 Door 与 Blast Radius 分行。

$implement→$code-review→$pr

从 v1.2.x 升级到 v1.3

v1.3.0 起所有 skill 只认 GLOSSARY.md / GLOSSARY-MAP.md,不再读 CONTEXT.md / CONTEXT-MAP.md。已有项目先改名,再更新 skills(插件现在带 27 个,含新转正的三个)。

git mv CONTEXT.md GLOSSARY.md→git mv CONTEXT-MAP.md GLOSSARY-MAP.md→更新插件

完整索引

基于 upstream v1.3.2(含 main@4ae2317)整理的 39 个 skills(engineering 20 + productivity 7 + in-progress 8 + misc 4)。main@4ae2317 相对上一校对点 main@5beb35b(release 仍为 v1.3.2):新增 in-progress 的 $software-factory 术语表;$chief-of-staff 优先复用共享 wiki,并把 retro / implement-spec 写成 procedures;$implement-spec 每个 ticket 派全新 implementer;多个派子 agent 的 skill(code-review / research / wayfinder / grilling / improve-codebase-architecture / DESIGN-IT-TWICE / chief-of-staff)统一写明新开上下文、不 fork;$setup-matt-pocock-skills 补可达仓库、legacy CONTEXT.md 改名提示,以及 GitHub/GitLab tracker 模板(原生 blocking、关单评论、自有仓库、glab 链接查询等)。main@5beb35b 相对 main@49dd158:chief-of-staff 引入带日期与提交引用的 wiki。更早的 v1.3 / v1.2 变化见各条目。Claude Code 插件仍是 27 个 promoted skills;in-progress 与 misc 仍需单独安装(npx skills@latest add mattpocock/skills --skill=<name>)。日常优先用上面的主流程。

Skill 什么时候用 典型提示
$setup-matt-pocock-skills 每个项目第一次使用这套工程 skills 前。User-invoked。配置 tracker、labels,以及 GLOSSARY.md(多上下文用 GLOSSARY-MAP.md)和 ADR 的位置。main@49dd158 起,在 GitHub / GitLab 上跑完 triage 配置段后会把 tracker 里缺的 label 自动建出来(gh label create / glab label create);GitHub 列外部 PR 改走 REST pulls 接口,GitLab 列表改用 -O json。main@4ae2317:探测到 legacy CONTEXT.md / CONTEXT-MAP.md 时主动提议 git mv 并改写 docs/agents/domain.md;选 GitHub/GitLab 但 remote 不可达时,先要仓库 URL 并接线(必要时 git init + remote add),直到 gh/glab repo view 能打出项目;GitHub 模板补原生 blocking / 统计 open blockers、关单先评论再 close、只往用户自有仓库提单(勿误提进 mattpocock/skills);GitLab 模板补 child 与 map 的 relates_to 链接,以及按 map links 查 frontier。 配置 issue tracker、triage labels、domain docs。
$ask-matt 不确定该用哪个 skill 或流程。User-invoked 路由器;v1.3 起主流程以 $retro 收尾,并把 $implement-spec 列为逐个 $implement 的并发替代。main@49dd158 起它先读目标 skill 的 SKILL.md 再说「这个 skill 做什么」或建议跳过某步;自带的摘要只用于定向。 我想做……应该怎么走?
$wait-what 上一句没落地。让它带上下文、用简化英语和 GLOSSARY.md 术语重说(多上下文顺着 GLOSSARY-MAP.md 找)。User-invoked。 上一句没听懂,请重说。
$wayfinder 规划超过单轮上下文的大工作。产出 decision tickets,清完后走 $to-spec。main@49dd158 起:map 和 tickets 只带 wayfinder:<type> 标签,不再带 ready-for-agent 这类 triage 标签(它们是决策,不是实现工作);第二遍连线时用真实 id 写交叉引用(占位 #<n> 会自动链到无关 issue);处理 ticket 时按它的 wayfinder:<type> 标签判断类型;research 子 agent 推送 research/<name> 分支但不开 PR,因为永不合并。main@4ae2317:每个 research 子 agent 新开上下文。 把这个目标做成 wayfinder map。
$grill-with-docs 新功能、重要变更、需求不清楚。会边问边把术语写进 GLOSSARY.md、把决定写成 ADR。 我想做……先帮我把问题问清楚。
$grilling 底层追问循环。按 frontier 分轮提问,连续问题之间用分隔线隔开;事实交给环境,决策留给人。main@49dd158 起每个问题要措辞成「回答 yes 就是接受推荐答案」。main@4ae2317:查事实的子 agent 新开上下文。 请按 frontier 分轮追问。
$grill-me 非代码计划或设计也需要被追问。不在工作目录时用它,而不是 $grill-with-docs。 我有个计划……请拷问我。
$tdd 写功能或修 bug。红绿循环,只在预先约定的 seam 上测;测试命名跟 GLOSSARY.md 术语走。main@49dd158 起,提议每个 seam 时要各写一行「抓得到什么、抓不到什么」。 请用测试驱动实现……
$diagnosing-bugs 问题复杂、偶发、报错、慢、难定位。展示命令和输出前先脱敏。修好后建议同一会话跑 $retro。main@49dd158 起,如果红灯是靠改代码或 fixture 强行造出来的,要先和原始副本 diff 证明改动确实落地,再相信这个红。 这个问题是……请按诊断流程定位。
$improve-codebase-architecture 扫描正在改的区域,找 deepening 机会,再选一个深入讨论。main@4ae2317:探索子 agent 新开上下文;DESIGN-IT-TWICE 的并行设计子 agent 同样各自新开上下文。 扫描这个项目,找出最值得改进的点。
$codebase-design 设计模块接口、边界、可测试性。含 design-it-twice。 帮我设计这个模块的接口和边界。
$domain-modeling 讨论代码库术语、直接写或改 GLOSSARY.md、记录或修改 ADR 时触发。吸收了原 $ubiquitous-language。 帮我梳理这个领域概念并更新文档。
$prototype 用单个可分享 HTML 验证设计问题,并作为 primary source 留在 throwaway 分支。 我想验证这个交互或状态模型……
$to-spec 把已有讨论整理成 spec,并发布到配置好的 issue tracker。 把上面的讨论整理成 spec。
$to-tickets 把 plan、spec 或 conversation 拆成 tracer-bullet tickets 和 blocking edges。main@49dd158 起:来源是已有 issue 时,每张 ticket 作为它的 sub-issue 发布;用原生 blocking 关系时,ticket 模板里省略 Blocked by 小节。 把这个 spec 拆成可实现的 tickets。
$to-questionnaire 把你无法独自回答的问题转成给某个人填写的 questionnaire。追问的是“寄给谁、要什么”,不是主题本身。 为这个问题生成一份 questionnaire。
$triage 处理 issue 队列、分类和补充上下文。只处理不是你自己建的 issue;$to-tickets 产出的 tickets 不用 triage。 帮我 triage 当前 issues。
$implement 已经有 spec 或 tickets,逐个推进。在约定 seam 上跑 $tdd,完成后 $code-review 再提交;ticket 之间清上下文。main@49dd158 起:你传 ticket 引用时,先从 tracker 取下来并复述标题(引用含糊就问);调用 $tdd / $code-review 改为明确要求通过 Skill 工具调用,而不是写 /tdd、/code-review 斜杠。 请实现这个 spec 或 ticket。
$implement-spec Engineering,user-invoked(v1.3 转正)。按 task graph 对 frontier 并发派 implementer 子 agent(各自 worktree + $tdd,完成前并入 integration 最新提交),merger 子 agent 合入一条 integration 分支,最后一次 $code-review。默认不开 PR;tracker 靠 PR 关单或你要求时,第一次合并后开 draft PR。main@4ae2317:每个 ticket 一个全新上下文的 implementer(不要 fork);review 修复也用一个新的 implementer。 请把这份 spec 实现到一条 integration 分支上。
$code-review 从固定点审查 diff:Standards 与 Spec 两条线并行。Standards 含 Fowler smell baseline。main@49dd158 起:Standards 要搜索仓库里所有写代码规范的文件(有 CODING_STANDARDS.md / CONTRIBUTING.md 就必须列入);两条 sub-agent 调用要同时在前台发出并汇总返回的报告;tracker 说明不再硬编码 docs/agents/issue-tracker.md,没提供就让你跑 setup。main@4ae2317:每条 sub-agent 新开上下文。 请 review 从 main 到当前 HEAD 的改动。
$pr Engineering,model-invoked(v1.3 转正,随插件安装)。写 PR 正文的格式参考(非工作流):Summary / Evidence / Merge Danger;Summary 最小视觉来自 primary source;Evidence 要 before/after;Door 与 Blast Radius 分行。 请按 Summary / Evidence / Merge Danger 写这份 PR 正文。
$retro Engineering,user-invoked(v1.3 转正,主流程最后一步)。对编码会话做 retrospective,按严重程度给环境改进候选:先读仓库已有 checks;无 guardrail 本身是 finding;机械 standards 落成 deterministic check,judgement calls 才进 CODING_STANDARDS.md。 请复盘刚才这轮会话;机械问题优先落成 deterministic checks。
$research 让后台 agent 基于 primary sources 调查问题,并写成带引用的 Markdown。main@4ae2317:研究子 agent 新开上下文。 请基于 primary sources 调查这个问题。
$wizard 把只有人类能完成的步骤做成交互式 bash wizard。Model-invoked。main@49dd158 起模板更稳:ask 用 Readline 编辑并在 EOF 时失败;.env 值用单引号写入并能读回旧值(新建文件权限 0600,经 symlink 写、保留原权限);开浏览器失败时给出手动链接;整段步骤包进 run_wizard,bash 会先解析完整个文件,运行中改文件不会弄坏脚本。 帮我生成一个配置 X 的 wizard。
$git-guardrails-claude-code misc(需单独安装)。为 Claude Code 设置 hooks,阻止危险 git 命令。 帮我设置 Claude Code 的 git guardrails。
$migrate-to-shoehorn misc(需单独安装)。把测试里的 TypeScript as 断言迁移到 @total-typescript/shoehorn。 把这些测试迁移到 shoehorn。
$scaffold-exercises misc(需单独安装)。创建课程练习目录、题目、答案和讲解结构。 帮我 scaffold 这一节 exercises。
$setup-pre-commit misc(需单独安装)。配置 Husky pre-commit、lint-staged、Prettier、typecheck 和 tests。 帮这个项目设置 pre-commit hooks。
$setup-ts-deep-modules in-progress。用 dependency-cruiser 让 TypeScript 仓库里每个 package 都是 deep module:实现藏在子目录,只能经入口文件访问。 帮这个 TypeScript 项目设置 deep modules 约定。
$loop-me in-progress。梳理可重复、可委托的工作流规格。 帮我把这个反复做的流程梳理成 workflow spec。
$handoff 上下文需要搬走时用:新 harness、新目录、同事、或中途分叉。同一会话内优先 /compact。文件存到系统临时目录($TMPDIR,否则 /tmp;Windows 为 %TEMP%),不放当前 workspace(main@49dd158 起写明解析顺序)。 下一轮要继续……请写 handoff。
$chief-of-staff in-progress(main@49dd158 新增,实验性,user-invoked)。在一个长会话里围绕长期目标统筹子 agent 与定时任务:所有实际工作交给后台子 agent(各自新开上下文),自己保护上下文,只靠 context pointer 稀疏沟通;每次都先想「怎么改环境让下一个任务更顺」(受限 API、强制正确性的 lint、CODING_STANDARDS.md、日志 / 测试库 / 浏览器等数据源,以及不绕路 workaround 的规则)。main@5beb35b:记忆放进一份跨会话的 wiki。main@4ae2317:先找用户或其他 agent 已有的共享 wiki并按它的约定写入;没有才和用户约定位置。新增 Procedures:约 1/5 的子 agent 会话(含 implement-spec 派发的)跑 $retro(自己决定哪些候选值得追);大块工作走 $to-spec → $to-tickets → 发布 → $implement-spec。index.md 按类列出每页的链接和一行摘要,其余一页一事;来源只引用、不抄进来。用 ingest / query / lint 维护;主张带日期与提交引用,变化时追加新条目并标旧文被取代。 用 chief of staff 方式推进这个长期目标:……
$claude-handoff in-progress。把当前对话交给一个后台新 agent(claude --bg)立即接着做。main@49dd158 起先把摘要存成系统临时目录里的文件,再用 claude --bg --name "…" -- "$(cat <文件>)" 启动,避免摘要里的反引号或 $ 被 shell 展开。 帮我写一个 Claude handoff。
$teach 让 agent 在当前 workspace 里持续教你一个概念或技能。main@49dd158 起:./lessons/ 等 workspace 路径从你运行 /teach 的目录解析,只有 *-FORMAT.md 链接从 skill 目录解析;测验正确答案的位置要在各题之间变化,不再给格式或顺序上的线索。 教我……
$writing-for-agents 写给 agent 看的文档:skills、AGENTS.md/CLAUDE.md。v1.2.0 由 $writing-great-skills 改名。 帮我改进这个 skill 或 agent 文档。
$writing-fragments in-progress。写作探索阶段,先收集原始片段。 帮我围绕这个主题挖写作 fragments。
$writing-shape in-progress。把已有素材塑造成一篇文章,逐段成稿。 把这些素材 shape 成文章。
$writing-beats in-progress。把素材组织成文章节奏和叙事 beats。 帮我把这些素材组织成 writing beats。
使用习惯

在真实项目根目录中启动 Codex 或 Claude Code,然后先跑 $setup-matt-pocock-skills。不确定时用 $ask-matt。看不懂上一句用 $wait-what。grill → spec → tickets 尽量留在同一个上下文窗口;之后每个 $implement 从 ticket 重新开始,或者交给 $implement-spec 一次并发跑完(每个 ticket 一个全新上下文的 implementer,不要 fork)。派子 agent 的 skill 一律新开上下文。同一 harness、同一目录、到了阶段边界时,优先继续或 /compact,$handoff 只在上下文需要搬走时用。开 PR 时 agent 会自己套 $pr 模板。一轮编码收工后,在清上下文之前跑 $retro:先认清仓库已有的 lint/CI,再把机械 finding 建成 deterministic check,把真正需要判断的留给 CODING_STANDARDS.md。从 v1.2.x 升上来的项目,记得把 CONTEXT.md / CONTEXT-MAP.md 用 git mv 改成 GLOSSARY.md / GLOSSARY-MAP.md,否则 skills 读不到你的术语表。

已复制