matt pocock 把自己 Claude Code 里实际用的 Skills 全开源了,专治 Agent 瞎编、啰嗦、跑不通和屎山,grill-me 反向拷问和共享语言这两招很开眼。
作者@mattpocockuk公开了其.claude/目录下的实用Agent Skills集合,旨在解决四大工程痛点:1) 通过/grill-me等技能在动工前对齐需求,修复沟通鸿沟;2) 维护CONTEXT.md与ADR建立共享语言,提升代码一致性;3) 利用/tdd和/diagnose建立快速测试与诊断反馈回路;4) 通过/to-prd、/zoom-out等技能对抗代码熵增,持续投资设计。这些技能分为工程、效率与工具三类,形成从需求对齐到代码落地的完整工作流。
解决真正工程问题的 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 ──┘