一句话

面对陌生代码库先摸底不动手：配好上下文、查一手资料、读懂架构、立质量底线、给要改的区域补特征测试，产出交给 W2 或 W3。

适用

• 适合：接手别人的仓库、大改之前先调研、技术选型要查官方资料。
• 不适合：已熟悉的项目里做功能（直接 W2-单会话功能 或 W3-多会话功能）。

步骤

1. 配上下文：addy-context-engineering 写规则文件（CLAUDE.md、AGENTS.md），按五层 hierarchy 打包，超预算时知道先砍什么。
2. 查一手资料：matt-research 派后台子代理对官方文档、源码、spec 出带引用的笔记；实现要贴着当前版本文档走的用 addy-source-driven-development，代码里引出处。
3. 读懂代码：借鉴 pstack-how 拿一份架构级讲解、pstack-why 考据关键决定为什么成立（两者依赖 Cursor，可选/借鉴；本机用只读子代理做同样的分工）。
4. 找加深机会：matt-improve-codebase-architecture 扫一遍出 HTML 报告，只勘察不改代码。
5. 立底线：addy-constraint-driven-development 把现有质量水平写进 CONSTRAINTS.md，先防 agent 降标。
6. 补测试：在接下来要改的区域用 addy-test-driven-development 补特征测试，锁住现有行为。

大量阅读全部交给子代理，主线只收摘要和文件指针；每个调研主题一个子代理窗口。

token 与旋钮

• 省：只做第 1、3、5 步，架构报告和考据留到要用时再补。
• 标准：六步全走，调研子代理串行。
• 加强：research 和考据并行派多个子代理，最多嵌套一层。

进入与退出

• 进入：代码库陌生，或改动前要先知道「现在长什么样、为什么长这样」。
• 完成判据：规则文件落盘、底线写好、要改的区域有特征测试、报告和调研笔记在仓库里。
• 之后：产出交给 W2-单会话功能 或 W3-多会话功能 执行改动。

常见坑

• 没立底线就开工，agent 顺手把覆盖率和断言降下来没人发现。
• 主线自己读几千行源码把上下文读爆；阅读必须委派。
• 摸底阶段顺手重构；重构等特征测试补上后走正常 build 流程。

关联

• 入口：00-怎么选工作流 · 下游：W2-单会话功能、W3-多会话功能 · 相关：W4-大型模糊项目