解决真正工程问题的 Skills：Skills For Real Engineers 作者 @mattpocockuk 公开了自己 .claude/ 目录中每天在用的 Agent Skills 集合...
TL;DR · AI 摘要
Matt Pocock 公开其日常使用的 Claude Agent Skills 集合，聚焦解决工程落地中四类根本失败模式：沟通鸿沟、语言缺失、反馈断裂与熵增失控，并通过结构化 Slash Command 实现从对齐到守护的闭环。
核心要点
- 用 /grill-with-docs 和 /grill-me 在编码前强制反向拷问，弥合人与 Agent 的意图鸿沟
- 维护 CONTEXT.md + ADR 构建共享领域语言，显著提升命名一致性与代码可导航性
- 将 TDD、诊断循环（/diagnose）和架构审视（/zoom-out /improve-codebase-architecture）嵌入 Agent 工作流，形成可持续反馈与设计投资机制
结构提纲
按章节快速跳转。
介绍 Matt Pocock 公开的 .claude/ Skills 集合，强调其目标是解决一线工程师的真实痛点。
系统梳理沟通鸿沟、语言缺失、反馈断裂、熵增失控四大问题及其对应 Skill 修复方案。
Engineering/ Productivity/ Misc 三类 Slash Command 技能，构成从对齐→落地→守护的协同工作流。
领域词典与架构决策记录是构建共享语言、降低认知负荷、抑制熵增的基础设施。
通过 /tdd、/diagnose 等技能将类型检查、测试、复现诊断等反馈机制直接注入 Agent 对话。
/zoom-out 和 /improve-codebase-architecture 强制系统视角与定期重构，对抗软件熵增。
思维导图
用一张图看清主题之间的关系。
查看大纲文本（无障碍 / 无 JS 友好）
- Skills For Real Engineers
- 四类失败模式
- 沟通鸿沟 → /grill-me, /grill-with-docs
- 语言缺失 → CONTEXT.md + ADR
- 反馈断裂 → /tdd, /diagnose
- 熵增失控 → /zoom-out, /improve-codebase-architecture
- Skill 分类
- Engineering：grill-with-docs, tdd, diagnose...
- Productivity：grill-me, caveman, write-a-skill
- Misc：git-guardrails, migrate-to-shoehorn...
- 基础设施支撑
- CONTEXT.md（领域词典）
- docs/adr/（架构决策记录）
- 项目根目录标准化约定
金句 / Highlights
值得收藏与分享的关键句。
没人确切知道自己想要什么。——《The Pragmatic Programmer》；修复方式：在动工前先被 Agent 反向拷问（/grill-me /grill-with-docs）
共享语言带来的连锁收益：命名一致 → 代码可导航 → 思考 token 更少；作者称其为‘整个 repo 里最酷的技术’
反馈速率就是你的速度上限。——《The Pragmatic Programmer》；修复方式：把静态类型 / 浏览器 / 自动化测试的反馈接回 Agent 工作流
每天投资设计，深模块（窄接口、厚实现）优先。——Kent Beck & John Ousterhout；修复方式：/to-prd /zoom-out /improve-codebase-architecture
各 Skill 不是孤立的，而是一条从对话到落地的流水线：grill-with-docs → tdd → diagnose → zoom-out → improve-architecture
作者 @mattpocockuk 公开了自己 .claude/ 目录中每天在用的 Agent Skills 集合，目标读者是在做真正工程的人们，解决真正的工程问题。
真正想解决的四类失败模式
- Agent 没做对你想要的事 —— 沟通鸿沟
引用 The Pragmatic https://t.co/SENI50VVRN" / X
解决真正工程问题的 Skills：Skills For Real Engineers 作者
公开了自己 .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 ──┘ 项目地址github.com/mattpocock/ski