用途:把方案从草图推进到可承诺状态,在写任何代码之前先解决所有未决决策。适合用户在实施前想对设计做压力测试的场景。
主要能力:先用一段话复述方案并与用户确认,确认无误后才继续;从方案中抽取决策树,把每个分支点作为节点,标记为未决或已解决,已解决节点需带来源标签(user 表示用户回答,inferred 表示由代码库或既有约束确定);按依赖顺序解决,只有当节点所依赖的节点全部解决后该节点才算就绪。
使用方式:对每个就绪的未决节点只问一个问题,问题尽量简洁、二元或少量选项;每个问题都附上推荐答案和一句话理由,用户可确认、另选或反驳。提问前先检查答案是否已在代码库、历史提交或现有文档中,若已存在则跳过并标记 inferred: <path>。仅当零个未决节点时退出,并以扁平列表输出决策树:Decision - Choice - Source (user | inferred: <path>)。
产出:决策台账(始终产出,即上述扁平列表);当拷问暴露出项目专有术语时,产出 CONTEXT.md,每行一个术语及在项目语境中的一句话定义,重跑时原地合并新术语;仅对存在争议或难以逆转的节点写决策记录,放在 docs/decisions/NNNN-slug.md,编号取现有最大记录之后,避免冲突,琐碎选择不记录。用户拒绝决定时标记 DEFERRED 并附用户给出的原因,这与未决不同。
限制与反模式:不要一次问多个问题;不要未先探索就提问,十五秒能读到的答案应先读;不要只提问不给推荐(无立场的问题等于把设计推给用户);不要跳过未解决节点继续向下提问。输出契约是用户可直接粘贴进方案文档的决策台账,不写散文式总结、不含糊其辞。资料未提供安装命令、价格或平台信息。