第一章：工程技能完全指南

工程技能完全指南

工程技能是这套库每日都在用的核心，覆盖代码工作的全生命周期：从对齐、规格、拆解，到构建、测试、审查、调试、架构投资。本章按「用户触发 / 模型触发」组织，并串成一条可重复的主链路。

工程主链路

用户触发 vs 模型触发

本章技能一览

下列 17 个工程技能分为用户触发与模型触发两类。建议从 grill-with-docs 入手，沿主链路一路走到 code-review。

ask-matt：技能路由器

ask-matt 是真正工程师技能库里的路由器技能：当你不确定该用哪个技能或哪条流程时，它会根据你的处境帮你选对入口。适合在动手前先理清方向。

grill-with-docs：带文档的拷问式对齐

grill-with-docs 用一连串尖锐提问把你和 AI 代理的对齐做扎实，同时顺手建立项目的共享语言（领域模型），更新 CONTEXT.md 与架构决策记录。它是整个工程流程最值得用的入口。

triage：工单分诊状态机

triage 用一套角色化的状态机把问题单（issue）推进流转：从待分类、待澄清到待办、进行中、已完成。适合用 GitHub、Linear 或本地文件管理任务队列的团队。

improve-codebase-architecture：抢救大泥球

improve-codebase-architecture 会扫描代码库，找出可以「 deepening（深化）」的模块机会，生成可视化 HTML 报告，再陪你逐个 grill 选定要改造的点。建议每隔几天对你的代码库跑一次。

setup-matt-pocock-skills：一次性配置

setup-matt-pocock-skills 在每个仓库首次使用前跑一次：它会问你用哪个问题跟踪器、triage 用什么标签、文档存到哪里。配好后，其余工程技能才能正常协作。

to-spec：把对话变成规格

to-spec 把当前对话直接综合成一份规格（spec），发布到问题跟踪器。它不重新面试你——只是把你已经聊过的内容收敛成可执行的规格文档。

to-tickets：拆成追踪子弹工单

to-tickets 把任意计划、规格或对话拆成一组「追踪子弹（tracer-bullet）」工单，每张都声明自己的阻塞边。可写成本地文本，也可写成真实跟踪器上的原生阻塞链接。

implement：按规格构建

implement 负责把规格或一组工单真正构建出来：在事先约好的接缝上驱动 tdd 做测试先行开发，收尾再用 code-review 把关，最后才提交。它是工程主链路的「施工」环节。

wayfinder：超大任务探路

wayfinder 把一次会话装不下的超大块工作，规划成一张共享的「调查工单地图」放在问题跟踪器上，逐个攻克直到通往目标的路清晰可见。适合跨多个代理会话的大工程。

prototype：一次性原型

prototype 是模型触发的技能：用来搭一个用完即弃的原型，回答一个设计问题。可以是回答状态/逻辑问题的可运行终端程序，也可以是同一路由下可切换的多个 UI 变体。

diagnosing-bugs：纪律化调试循环

diagnosing-bugs 是模型触发的调试技能：用一套有纪律的循环对付难缠的 bug 和性能回退——复现、最小化、提假设、打埋点、修复、加回归测试。适合代理自动接手排查。

research：带引用的调研

research 是模型触发的技能：针对一个问题，依据高可信的一手来源做调研，把结论写成带引用的 Markdown 文件存进仓库，通常以后台代理方式运行。适合需要可靠依据再做决定的场景。

tdd：测试驱动开发

tdd 是模型触发的测试驱动开发技能：用一个行为一个行为的红-绿-重构循环把功能或修复「逼」出来。它只测预先约定的公共接缝，杜绝实现耦合与同义反复测试。可单独用，也被 implement 内部调用。

domain-modeling：领域建模

domain-modeling 是模型触发的领域建模技能：主动建立并打磨项目的领域模型——拿术语对照术语表挑战、用边界场景压测、并就地更新 CONTEXT.md 与架构决策记录。让代理和团队说同一种语言。

codebase-design：深模块设计

codebase-design 是模型触发的设计纪律：提供一套关于「深模块」的共享词汇与方法——用很小的接口藏住大量行为，放在干净的接缝上，且能透过接口测试。它回答的是「模块怎么切才优雅」。

code-review：双轴代码审查

code-review 是模型触发的代码审查技能：用两个互相独立的轴审查自某个固定点以来的改动——「规范」轴（是否符合仓库编码规范 + Fowler 坏味道基线）和「规格」轴（是否忠实实现了来源 issue/PRD）。两轴并行跑，互不污染。

resolving-merge-conflicts：解决合并冲突

resolving-merge-conflicts 是模型触发的技能：陪你逐个 hunk 地走过正在进行中的 git 合并或变基冲突，按意图（追溯双方的主要来源）来裁决，最后收尾整个操作——绝不用 --abort 草草放弃。

返回总览：总览与方法论