文档拷问对齐

方案还没写清就开始写代码

复杂需求里，术语混用、边界模糊、口头约定和实现不一致，往往在迭代后期才暴露。单靠一次性 PRD 或零散聊天，很难在设计树的每个分支上把依赖关系逐个敲定，也缺少一份只讲领域、不讲实现的共享词汇表。

技能如何工作

本技能把对话当成 relentless 访谈：一次只问一个问题，等你反馈后再继续；每个问题都会给出推荐答案，方便你快速拍板或反驳。若答案能靠读仓库得出，它会先探索代码库，而不是空问。

探索时会留意现有文档结构：多数仓库只有一个上下文；若根目录存在 CONTEXT-MAP.md，则按地图进入多上下文。术语在当场 resolved 后立刻写入 CONTEXT.md（懒创建：有内容才建文件）。CONTEXT.md 只做领域词汇表，禁止堆实现细节。

会话中的几条硬规则：

• Challenge Against the Glossary：你的说法若与 CONTEXT.md 冲突，会立刻指出并让你二选一。
• Sharpen Fuzzy Language：对「账户」「取消」等 overloaded 词，会逼你选定规范术语（例如 Customer vs User）。
• Discuss Concrete Scenarios：用边界场景 stress-test 概念关系。
• Cross-Reference With Code：陈述与代码不一致时，会把矛盾摆到桌面上。

ADR 只在同时满足三点时才建议写：难 reversal、缺上下文会令人费解、且来自真实 trade-off。会话结束后产出：CONTEXT.md、符合条件的 ADR 文件，以及已决事项与仍开放问题的摘要。

适用边界

适合方案/领域建模尚未收敛、需要与代码对齐的团队对话；不适合只想快速改 bug、或已有完整 spec 无需拷问的场景。访谈节奏较慢，需要你在每个问题上认真反馈。