38 个技能，
你真正需要的是其中 3 个

路由器。你描述处境，它告诉你该用哪个技能、哪条流。有一条硬规矩：在陈述某技能做什么之前，必须先读那个 SKILL.md 全文，不能靠摘要回答。

一次性配置。探查仓库 → 确认 issue tracker（GitHub / GitLab / 本地 markdown / 自定义）→ 确认 triage 五个标签字符串 → 确认 GLOSSARY.md 单上下文还是多上下文 → 把摘要写进 AGENTS.md 或 CLAUDE.md 的 ## Agent skills 块。

关键细节：两个文件都已存在时只改已有的那个，绝不新建另一个；triage 标签只在装了 triage 技能时才问。

全文只有一句：调用 grilling 和 domain-modeling。它是"访谈 + 边聊边写 GLOSSARY.md 和 ADR"的组合入口。作者本人说这是整个库最酷的技术。

不访谈，只把已有对话综合成 spec 发到 tracker。模板含问题陈述、解决方案、超长用户故事清单、实现决策、测试决策、范围外、备注。硬性要求：先画出准备在哪几个 seam 上测，确认后再写，理想数量是 1 个。

把 spec 拆成追踪弹垂直切片，每张票声明阻塞边。核心纪律三条：一张票切穿所有层（不是后端票 / 前端票 / 测试票）、一张票一个上下文、一张票能独立演示。

最有价值的是那段例外：宽范围机械改动禁止切片（改字段名、批量换接口），因为任何一张票都无法独立转绿，要走"先并存 → 分批迁移 → 最后删旧形态"。拆完必须向用户确认粒度才能发布。

按 spec 或票实现。指定票时先报出票标题；逐处调用 tdd；经常跑类型检查和单文件测试，最后跑全量；收尾调用 code-review；提交到当前分支。总共不到十行，是个薄包装。

整份 spec 一次性落地到一个集成分支。把票当任务图读，按前沿并发铺实现子代理，每个子代理独占 worktree 和分支；完成一个就用 merger 子代理合回集成分支，前沿变化后立刻补发新子代理。全部完成后对整个集成分支跑一次 code-review。通信靠上下文指针，不复制信息。

处理"比一个会话大得多、且还没看清路"的工作。在 tracker 上画一张共享地图，子票是决策票（research / prototype / grilling / task 四型），一次只解一张。核心概念是战争迷雾：地图故意不完整，"Not yet specified" 记录你感觉到但还说不清的决策，能说清才开票。它只产出决策不产出交付物，路清了就交棒给 to-spec。

issue 状态机：两个分类角色（bug / enhancement）+ 五个状态角色（needs-triage / needs-info / ready-for-agent / ready-for-human / wontfix）。动作序列是收集上下文 → 查重（按领域概念搜现有实现，不按请求字面）→ 查历史拒绝记录 .out-of-scope/ → 先验证再访谈（bug 要复现，PR 要跑）→ 需要时 grilling → 出 ready-for-agent 简报。所有评论必须以 AI 生成免责声明开头。

架构体检。先用 git log 找热点（YAGNI：只深挖近期改动多的区域，不搞全量扫描）→ 派子代理有机走查，找浅模块 → 生成自包含 HTML 报告写到操作系统临时目录（不进 repo），每个候选含前后对比图和建议强度徽章（Strong / Worth exploring / Speculative）→ 你挑一个，进入 grilling。会主动检查是否与已有 ADR 冲突。

回顾会，但改进对象是代理的环境而不是代码。七类候选：导航指针、自动化检查、编码标准、全局 AGENTS.md 瘦身、工具经济性、无效指令、信息获取。

两个核心论点值得直接采纳：① 机械性错误做成确定性检查，判断性错误才写进标准；② review 代理该背标准，实现代理不该，因为实现代理的上下文压力最大。

主动打磨领域模型。术语与 GLOSSARY.md 冲突时当场指出；模糊词提出精确规范词（"你说的 account 是 Customer 还是 User？"）；用构造的边界场景压测概念；与代码对照，发现矛盾就摊开。术语一敲定立刻写进去，不攒批。

ADR 只在三条同时满足时才提议：难以回退、脱离上下文会让人困惑、是真实权衡的结果。任何一条不满足就跳过。

深模块词汇表，且明确禁止你说 component / service / API / boundary，只准用 module / interface / depth / seam / adapter / leverage / locality。核心判据三条：删除测试（删掉这个模块，复杂度是消失了还是转移了？消失就是直通层）、接口即测试面、一个 adapter 是假 seam，两个才是真 seam。

附 DEEPENING.md（按依赖类型深挖）和 DESIGN-IT-TWICE.md（并行派子代理用几种截然不同的方式设计同一接口再比较）。

红绿循环参考手册。三个反模式写得很准：实现耦合（重构就挂说明测错了）、同义反复（expect(add(a,b)).toBe(a+b)，断言用代码的方式重算期望值，构造上就不可能失败）、横向切片（先写一堆测试再写实现，等于在理解实现之前就锁死测试结构）。改走垂直切片。它还明确说：重构不属于这个循环，归 review。

硬 bug 的诊断纪律，六阶段严格闸门。Phase 1 就是全部：必须造出一个"已经在这个 bug 上变红"的紧致反馈环，列出 10 种造法（失败测试 / curl / CLI / 无头浏览器 / 回放抓包 / 一次性 harness / 模糊测试 / 二分 harness / 差分对比 / 人工脚本兜底），并要求继续收紧：更快、信号更尖、更确定。

完成判据是四条勾选：红能力、确定性、秒级、可无人值守。建不出环就停下来说，绝不允许"先读代码猜原因"，那正是它要防的失败模式。后面才是复现 → 最小化 → 3~5 个可证伪假设 → 插桩（日志必须带 [DEBUG-xxxx] 前缀，收尾一次 grep 清干净）→ 修 + 回归。

一次性原型回答设计问题。先分叉：问"逻辑 / 状态模型对不对"→ 单文件 HTML（按钮 + 标签页引导，非程序员也能开）；问"该长什么样"→ 同一路由下几套截然不同的 UI，URL 参数切换。

铁律：明确标记一次性、一条命令能跑、默认不持久化、跳过打磨、每次操作后把状态全打出来、做完把结论折回真代码、原型本身留到 prototype/<name> 分支当一手来源。

派后台代理去查，你继续干活。只信一手来源（官方文档、源码、规范、一方 API），每条论断追到拥有它的源头，产出带引用的 Markdown 落到 repo 已有的笔记位置，没有约定就放个合理位置并说明。

双轴审查，从固定基点（commit / branch / tag / merge-base）取 diff：Standards 轴看是否遵守本仓文档化标准 + 一套 Fowler 坏味道基线；Spec 轴看是否忠实实现原始 issue / spec。两轴并行子代理跑，绝不合并、绝不跨轴排名。

这个设计理由很实在：只过一轴是常态（"完全合规但做错了事" / "做对了事但破坏了约定"），合并会互相掩盖。坏味道基线里"仓库已文档化的标准永远覆盖基线"这条很关键。

PR 正文模板三段：Summary（选最小的可视化：伪代码 / 调用树 / 组件树 / 文件树 / Mermaid / diff）、Evidence（before + after）、Merge Danger（单向门还是双向门 + 爆炸半径一个词）。

生成交互式 bash 脚本，带人走只有人能做的事：开基础设施、配凭据 / CI secret、点不熟悉的第三方后台、跑一次性迁移或割接。模板 template.sh 已经把进度、确认闸门、跨平台开 URL、隐藏输入密钥、幂等写 .env、gh secret 写入、收尾汇总做好了，你只负责划阶段，绝不手改模板库。

访谈原语。把设计当成决策树，按轮推进：每一轮问完当前前沿（所有前置已定的问题），每题编号并附上推荐答案，然后等回答再算下一轮。铁律是找事实是代理的活，不是用户的：需要环境事实就派子代理去查，别问用户；决策才是用户的。

全文一句：调用 grilling。无状态，不落任何文件。给"没有工作目录"的场景用：打磨方案、设计、一篇文稿。

把当前对话压成交接文档存到操作系统临时目录（不是工作区）。三条要求：不重复其他产物已有的内容（spec / 计划 / ADR / issue / commit / diff 用路径或 URL 引用）、脱敏、末尾附建议调用的技能清单。

把当前目录变成有状态的私人课堂。产物结构：MISSION.md（为什么想学）、RESOURCES.md、lessons/0001-*.html（每课一个自包含 HTML）、reference/*.html（速查表，可打印）、learning-records/（类似 ADR 的学习记录）、assets/（可复用组件）。

理论内核是区分流畅度强度（当场想起来）和存储强度（长期留存），靠"合意困难"（提取练习、间隔、交错）来造后者。它还强调"绝不相信自己的参数化知识"，一切以一手资源为准。

把"你一个人答不了的决定"变成给别人的问卷。关键反直觉点：只访谈"发送"这件事，不访谈主题：问清对方是谁、你要拿回什么，然后问题瞄准两者之间的缺口。

全文一段话，纯纠正机制："刚才那条我没听懂，重讲一遍：给点上下文，用 ASD-STE100 简化技术英语，用 GLOSSARY.md 的词汇。"

写给代理读的文档的方法论，全库理论密度最高的一篇。要点：上下文指针（一行 AGENTS.md 引用的措辞而非目标，决定代理会不会去读；必须前置引导词、每个分支一个触发词）；两种负载（上下文负载 = 常驻 token；认知负载 = 人要知道有哪些文档）；信息层级（文件内步骤 > 文件内参考 > 披露式参考）。

反直觉的两条：否定式指令是反模式（"别想大象"，禁令把被禁行为拉进上下文反而更可得，要正面描述目标行为）；逐句猎杀 no-ops（模型默认就会照做的指令，付了负载却没改变行为）。

用子代理在单会话内推进长期目标。双轨思维：战术（怎么完成眼前任务）+ 战略（怎么改造环境让下一个任务更好）。核心是 wiki：互相链接的 markdown 页面文件夹，跨会话存活。三条铁律是"写历史不写现在"：每条断言带日期，涉及代码的必须引用 commit，变化时新增带日期的断言并把旧的标为 superseded，不要改写旧的。

handoff 的加强版：写完摘要直接用 claude --bg --name "<名字>" 拉起一个后台代理接着干，参数用文件传入（避免 shell 解释反引号和 $）。

只产出工作流 spec 的有状态 grilling。用"人生是环环相扣的循环"这个透镜找值得委托的重复模式，词表是 trigger / checkpoint / push right（把人介入点尽量推后，一次问、晚点问、带齐东西问）/ brief（人读的是决策级摘要，不是草稿）。完成判据：实现代理拿到能不问任何问题就开工。

给 TS 仓库装 dependency-cruiser，把每个 package 变成深模块：package 根目录文件是入口点（公开），任何子目录都是私有。四条 error 级规则（入口点边界 / 包内自由 / 测试只穿入口点 / 无环）。

最值得抄的是它的验收方式：要求证明规则真的会咬人，先通过 → 故意加一个深层 import 必须失败 → 回滚必须再通过，三步全部观察到才算完成。

写作"探索"阶段：只挖碎片不做结构。碎片用 --- 分隔，不写小标题不打标签。最值钱的碎片类型是引导词：一个能承担整篇文章的紧凑隐喻。

把素材堆成一段段节拍，选自己的冒险式推进。每次只写当前这一拍，写完停下来给 2~3 个下一拍候选。核心约束是接地：每个概念要么是读者自带的前置，要么已被前面某一拍接住，否则读者会掉线。

把素材整理成文章，逐段进行，每一段都要论证格式选择（散文还是列表？引用还是转述？表格还是重复结构？）。对弱过渡句很强硬："删掉这段会坏什么？"

装 PreToolUse hook，在 Claude 执行前拦截危险 git 命令：git push（含 --force）、reset --hard、clean -f/-fd、branch -D、checkout . / restore .。被拦时告诉 Claude 它没有权限。会问清装本仓库还是全局，合并进已有 settings 不覆盖。

装 Husky + lint-staged（Prettier）+ 在 pre-commit 里跑 typecheck 和 test。先探测包管理器（看 lock 文件），没有 typecheck / test 脚本就省略并告知。

把测试里的 as 断言迁到 @total-typescript/shoehorn：fromPartial() 传部分数据、fromAny() 故意传错类型、fromExact() 强制全量。只在测试代码用。

造课程练习目录（XX-section/XX.YY-exercise/{problem,solution,explainer}），靠 pnpm ai-hero-cli internal lint 校验。