总览与方法论

总览与方法论

欢迎来到《真正工程师的技能》体系化中文教程。这套技能库的核心主张是：做真正的工程，而不是「氛围编码」。它把数十年工程经验浓缩成一组小巧、易改、可组合的技能，适用于任何模型。本教程按「支柱页—集群页」结构组织，每一章是一个支柱页，每个技能是一篇集群页。

它解决什么：四大失败模式

作者构建这些技能，是为了修复使用 AI 编码代理时最常见的四类失败。每个失败模式，都有对应的技能去化解：

1. 代理没做我想要——靠「拷问式对齐」化解（grill-me、grill-with-docs）。
2. 代理太啰嗦——靠共享语言与 CONTEXT.md 压缩沟通。
3. 代码跑不起来——靠反馈闭环（tdd 红绿循环、diagnosing-bugs 调试循环）。
4. 变成大泥球——靠持续的设计投资（improve-codebase-architecture、codebase-design）。

两种触发方式：用户触发 vs 模型触发

技能按「谁能调用」分为两类。理解这一点，是用好整套库的关键：

• 用户触发（User-invoked）：只有你主动输入时才可达（如 /grill-me），职责是「编排」。
• 模型触发（Model-invoked）：你和代理都能用，任务契合时代理会自动选用（如 /tdd），职责是「沉淀可复用纪律」。
• 用户触发技能可以调用模型触发技能，但绝不会调用另一个用户触发技能。

工程主链路

大多数真实工程任务，都走这条主链路。它把「对齐—规格—拆解—构建—审查」串成一条可重复的流水线：

其中 implement 内部驱动 tdd 做测试先行开发，code-review 是提交前的强制关卡。

章节导航

• 工程技能完全指南
• 效率技能完全指南
• 杂项技能完全指南
• 个人技能完全指南
• 实验性与已弃用技能

设计哲学

• 小巧：每个技能只做一件事，容易读懂。
• 易适应：文件就在项目里，可以随便改，让它变成你自己的。
• 可组合：技能之间能像乐高一样拼起来。
• 模型无关：不绑定任何特定模型。

作者有一句原话：去 hack 它们，让它们成为你自己的，然后享受。