用途:把代码库从“感觉有问题”推进到“问题已被定位、排序并修复”,全程由人工在每个关卡控制。改进引擎基于深模块理念(John Ousterhout《A Philosophy of Software Design》):深模块以小接口隐藏大实现,更易测试、更易被 AI 导航,并可在边界而非内部测试。Deepen 阶段目标是把浅而紧耦合的簇变成深模块。技能自包含(Python/TS),worker 角色默认内联运行,也可在明确授权下委派。
流程分三阶段。Stage 1 Map:只读映射仓库形态,检测 Python(pyproject.toml/requirements.txt/setup.py)与 TypeScript(package.json/tsconfig.json);两者都无则停止,两者都有则各自作为独立项目。做轻量结构扫描,可选读取已存在的 BLUEPRINT.md 作为锚点,不阻塞。
Stage 2 Audit:按扫描结果把仓库切分作用域,每个模块一个审计 worker,另加一个横切 worker(重复、依赖方向、过期依赖、仓库级密钥),worker 只读。汇总去重、赋 ID、按严重度排序,展示发现清单后进入 Checkpoint A。
Stage 3 Deepen(递归):探索摩擦点(候选、依赖类别、测试影响)→ Checkpoint B 选候选 → 框定问题空间 → 运行 3 个以上设计角色产出不同接口(最小接口、最大灵活性、最常见调用者优化、跨边界用端口适配器)→ Checkpoint C 选接口 → 写成 RFC 到 docs/ → 可选实现走 TDD+评审+QA 质量循环(Checkpoint D)→ 每轮后 Checkpoint E 决定递归方式:分解、再探索、再审计或停止。递归默认深度上限 3 层,每层都需用户确认。
配置默认值:MAX_QUALITY_ITERATIONS=3、REVIEW_BLOCKING_SEVERITY=high、GIT_STRATEGY=branch。产物:发现清单默认在对话中,RFC 存 docs/<rfc-slug>.md,QA 计划存 docs/qa/test-plan-<branch>.md,代码改动在分支 improve/<rfc-slug>。限制:不自动递归、不自动提交/推送/开 PR、不做大爆炸重写,不在用户选定前提出接口或实现;未经授权时不声称 worker 并行隔离,内联角色按串行运行。