Agent Skills 收集

Agent Skills 收集

这页放在 docs 里。原因很直接：skills 更像长期更新的工具索引，适合放安装命令、适用场景和使用顺序。博客更适合写完整经验和复盘。

这一组都是写代码时用的 skills。我会按两条线理解：

• DDD / docs：先把项目语言、领域词、决策背景收清楚。
• TDD / delivery：把计划拆成可验证的垂直切片，再用测试和架构反馈推进。

一次性安装

npx skills add https://github.com/mattpocock/skills --skill grill-with-docs
npx skills add https://github.com/mattpocock/skills --skill improve-codebase-architecture
npx skills add https://github.com/mattpocock/skills --skill tdd
npx skills add https://github.com/mattpocock/skills --skill to-issues
npx skills add https://github.com/multicul-silver-wolf/agent-docs-system-skill --skill project-docs-system

DDD / docs

grill-with-docs

来源：mattpocock/skills

用来把一个方案放到项目已有领域模型里拷问。它会追问术语、边界、场景和决策依据，适合在开始大改之前把模糊语言压实。

我会在这些场景用它：

• 新功能概念还没讲清楚。
• 业务词和代码里的词可能冲突。
• 需要补 CONTEXT.md、glossary 或 ADR。

project-docs-system

来源：multicul-silver-wolf/agent-docs-system-skill

用来建立和维护项目文档系统。它强调把知识按项目级、领域级、子领域级分层放好，避免所有规则都堆进一个 README。

我会在这些场景用它：

• 新仓库需要 agent 可读的文档入口。
• 某个模块出现长期约束，需要沉淀到文档。
• 用户纠正了项目惯例，需要记录给后续 agent 使用。

TDD / delivery

to-issues

来源：mattpocock/skills

用来把 plan、spec 或 PRD 拆成 issue。重点是按 tracer bullet 垂直切片拆，避免按数据库、API、UI 这种横向层级拆。

我会在这些场景用它：

• 一个需求太大，需要拆成可独立领取的任务。
• 想把每个 issue 都做成可验证、可 demo 的小闭环。
• 需要区分哪些切片能 AFK 执行，哪些切片需要 HITL 决策。

tdd

来源：mattpocock/skills

用来按红绿灯推进实现。重点是一次只写一个行为测试，通过公开接口验证行为，再补最小实现，最后重构。

我会在这些场景用它：

• 修 bug 时需要先复现行为。
• 新功能有清楚的核心契约。
• 重构前需要一组能守住行为的测试。

improve-codebase-architecture

来源：mattpocock/skills

用来找架构加深机会。它会关注模块是否太浅、接口是否暴露太多、复杂度是否散在调用方，以及测试面是否真正落在公开接口上。

我会在这些场景用它：

• 代码能跑，但越来越难测、难改、难让 agent 理解。
• 逻辑被拆得很碎，理解一个概念要跳很多文件。
• 想把关键模块做成更深的模块，让小接口承接更多稳定行为。

推荐使用顺序

实际使用时不要一次把所有 skill 都打开。先看任务阶段：

1. 概念、术语、边界还不稳：先用 grill-with-docs。
2. 项目缺少长期文档承接：用 project-docs-system。
3. 需求已经成型，需要拆任务：用 to-issues。
4. 已经进入实现或修 bug：用 tdd。
5. 代码结构开始拖慢交付：用 improve-codebase-architecture。

这组 skills 和我的 Harness Engineering 配方 是同一条线：让 agent 不只会写补丁，还能沿着术语、文档、issue、测试和架构反馈持续推进。