Lite Deepen 用于发现代码库中的架构摩擦,并提出“加深”机会:把浅模块变成深模块,目标是可测试性与可导航性,而非整洁。整个流程在聊天中完成:定范围、探索、出卡片、追问、写简报;除经用户批准写入目标仓库的两处副作用外,只写一份简报。
使用前先读 VOCABULARY.md,严格使用 module、interface、implementation、depth、deep、shallow、seam、adapter、leverage、locality 等架构词汇,不用近义词替代;领域词汇取自目标仓库的 CONTEXT.md 术语表。
定范围优先采信用户指定的模块或痛点;否则按 git log --name-only 历史中的变更频率排序扫描。探索前读取目标仓库的 CONTEXT.md 与相关 ADR,二者可选;ADR 记录的决策本次不再重议。
探索由一个只读探索子代理执行,寻找四类摩擦:浅模块(用删除测试判断)、接缝泄漏、为可测试性抽取却无局部性、无法通过接口测试。最多返回 4 个候选,按强度排序,每项含涉及文件、摩擦类型、删除测试结论、file:line 证据、问题与解决方向。
在聊天中以卡片呈现去重排序后的 2–4 项,含标题、级别(Strong / Worth exploring / Speculative)、文件、问题、方案、收益,以及纯 ASCII 的 before/after 示意图(聊天会把 mermaid 渲染为原始文本,故用普通字符绘制)。可选结构伪代码与 ADR 提示。随后询问用户要推进哪个候选,一次一个追问循环。
追问按 INTERVIEW.md 进行,议程即决策树:约束、依赖、加深后模块的形态、接缝之后放什么、哪些测试存活。追问期间可向目标仓库写入两处副作用,均需先征得同意:新术语写入 CONTEXT.md;被否决的承重建议可记为 ADR。
最后按 ARTIFACT-HOME.md 将简报写入 .crank/<slug>/deepen-brief.md,并按 READBACK.md 回读。简报包含 Idea / Problem、Approach、Shape、Key decisions、Open questions、Grounding、Out of scope 等节,不写验收标准。完成回读后建议下一步运行 /crank-lite spec .crank/<slug>/deepen-brief.md。
子代理层级每次运行解析一次并复用,以本会话已加载的用户与项目级 CLAUDE.md / AGENTS.md 中的模型偏好为准;资料中该段落到此截断,未提供完整回退块。具体支持平台、费用与价格未提供。