解决真正工程问题的 Skills：Skills For Real Engineers

作者 @mattpocockuk 公开了自己 .claude/ 目录中每天在用的 Agent Skills 集合，目标读者是在做真正工程的人们，解决真正的工程问题。

# 真正想解决的四类失败模式

1. Agent 没做对你想要的事 -- 沟通鸿沟 引用 The Pragmatic Programmer："没人确切知道自己想要什么。" 修复：在动工前先被 Agent 反向拷问。 · /grill-me：通用版逼问 · /grill-with-docs：工程版逼问，同时维护项目术语表与 ADR 这是作者明说的"最受欢迎的两个 Skill"。

2. Agent 太啰嗦 -- 缺少共享语言 引用 Eric Evans 的 DDD：领域专家与开发者一开始说的就不是同一种语言，Agent 也一样。 修复：项目根目录维护一份 CONTEXT.md（领域词典）+ docs/adr/（架构决策记录）。 作者举了自己 course-video-manager 仓库的例子： · Before："a lesson inside a section of a course is made 'real' …" · After："problem with the materialization cascade" 共享语言带来的连锁收益：命名一致 → 代码可导航 → 思考 token 更少。这一条被作者称为"整个 repo 里最酷的技术"。

3. 代码跑不通 -- 反馈回路缺失 引 Pragmatic Programmer："反馈速率就是你的速度上限。" 修复：把静态类型 / 浏览器 / 自动化测试的反馈接回来。 · /tdd：强制 red-green-refactor，并明确反对"horizontal slicing"（先把所有测试写完再实现）--只能 vertical slice，一次一个 tracer bullet · /diagnose：固定的"复现 → 最小化 → 假设 → 插桩 → 修 → 回归测试"诊断循环

4. 系统变成屎山 -- Agent 加速软件熵增 引 Kent Beck 与 John Ousterhout：每天投资设计，深模块（窄接口、厚实现）优先。 修复： · /to-prd 在写 PRD 前会问"这个改动到底碰哪些模块"； · /zoom-out 强制 Agent 把局部代码放回系统全景里讲； · /improve-codebase-architecture 是"周期性救火"--作者建议每隔几天对代码库跑一次。

# Skill 清单结构 仓库分三类，命名上都是 Slash Command 风格：

Engineering（日常代码工作） grill-with-docs、tdd、diagnose、to-prd、to-issues、triage、improve-codebase-architecture、zoom-out、setup-matt-pocock-skills

Productivity（通用工作流） grill-me、caveman（极简通信模式，省 ~75% token）、write-a-skill

Misc（不常用工具） git-guardrails-claude-code、migrate-to-shoehorn、scaffold-exercises、setup-pre-commit

各 Skill 之间不是孤立的，而是一条从对话到落地的流水线： 对齐与设计 落地与守护 ────── ──────── grill-with-docs → tdd ↓ ↓ to-prd diagnose ↓ ↓ to-issues zoom-out ↓ ↓ triage ───→ improve-architecture ↑ ↓ └──── CONTEXT.md / ADR ──┘