github.com/mattpocock/skills · v1.3

让 AI 编程助手先问清楚,再拆小,最后才动手

Matt Pocock 的这套 skill 解决两个常见问题:agent 做出来的东西不是你要的,以及上下文越用越乱。它把一件事拆成固定的几步:先追问对齐,再写成 spec 和小票,每张票在干净的上下文里实现、审查,最后复盘。下面先选你用的工具,页面里所有命令会跟着变。

我用的是
追问 写 spec 拆票 实现 审查 PR 复盘

三步开始

当前显示:

1

安装

    2

    每个仓库配一次

    在 agent 里运行 。它会依次问三件事,每题都有推荐答案:

    1. 议题放哪:GitHub Issues、GitLab,或者仓库里的本地 markdown 文件(.scratch/功能名/)。个人项目没有远程仓库时选本地。
    2. 分诊标签:默认五个标签,回答「用默认」即可。
    3. 术语表和决策记录放哪:默认是仓库根目录的 GLOSSARY.md 加 docs/adr/。

    做完会生成 docs/agents/ 下的几份说明,并在 CLAUDE.md 或 AGENTS.md 里加一段「Agent skills」,之后的 skill 都按它来读写。

    3

    开工

    有了想法,第一句永远是:

    你的想法

    不知道下一步用哪个 skill 时,运行 ,它会按你的情况指路。

    先分清两类 skill

    手动

    只有你输入它的名字才会运行,agent 不会自己调用,别的 skill 也调用不了它。流程里的关键节点都是这一类:追问、写 spec、拆票、实现、复盘。

    在你的环境里这样输入:

    自动

    agent 根据你说的话自己判断什么时候用,你也可以点名。比如你说「帮我 debug 一下」,它会用 diagnosing-bugs;写 PR 正文时,它会用 pr。

    想确保用上,就直接点名:「用 tdd 来写」。

    主流程:从想法到交付

    点左边的步骤看细节。第 1、3、4 步放在同一个对话里做完,中间不要清上下文,这样追问、spec 和拆票用的是同一份思考。

    走一遍完整示例

    项目是一个团队用的读书笔记应用,需求是「给笔记加标签,并能按标签筛选」。对话经过简化,用来说明每一步大致长什么样,不是真实输出。

    什么时候清空上下文

    只在一个阶段做完时判断,比如追问刚结束、准备开始实现。阶段做到一半不要切,要么继续,要么把剩下的拆给子 agent。模型保持清醒的范围大约是 15 万 token,Matt 叫它 smart zone。按顺序回答下面的问题:

    遇到这些情况用哪个

    点一个最像你现在处境的。

    全部 skill

    工程类与效率类,共 个。另有几个实验中和专用的没有列出。

    议题上的五个标签

    triage 和拆票用它们表示一张议题现在归谁。setup 时可以换成你议题系统里已有的标签名。

    needs-triage

    还没评估,等 triage 处理。

    needs-info

    在等提出人补充信息。

    ready-for-agent

    已经写清楚,agent 可以无人值守地做。

    ready-for-human

    需要人来做。

    wontfix

    决定不做。