Decide 是一个按步骤推进设计与代码审查的交互式辅助工具,主要提供两种模式:设计决策走查和代码质量审查走查。
用途与准备 在开始设计走查之前,工具会先检查相关代码,把具体的 bug、不一致之处和需要决定的问题记录到 plans/<YYYYMMDD>-<topic>.md 或对应应用范围内的 plans/ 目录中。它会保留已有编辑内容,未经明确同意不会丢弃推测性或用户撰写的内容。决策按依赖关系和影响力排序,而不是按文档顺序。
设计决策走查 每个决策依次呈现:以“## Decision N: <标题>”开头;用两到四句话给出基于真实文件或函数的上下文;用一句话说明权衡;然后提出恰好一个问题,提供两到四个互斥选项。可用时使用 ask_user 交互提问;在 Codex Plan 模式下,当 request_user_input 是暴露的交互提问工具时使用它。若仓库规范要求交互式浮层,不用纯文本问题替代。选项标签不超过五个词,推荐项排在最前并加(Recommended)后缀,每个选项用一句话解释及其权衡;客户端自动添加 Other 选项时不再重复添加。用户回答后记录“Logged: <decision>.”并继续。若用户只是确认问题而未选择,则记录推荐选项并说明可以更正假设。结束时给出 | # | Decision | Choice | 表格,并可提议把审计转为实施计划;决策走查期间不编写实现代码。
QA 走查 当用户希望逐步审查已有代码时使用此模式。先确定审查单元:一个提交、暂存差异、PR 或明确的文件集;再按依赖顺序拆成逻辑步骤。每轮展示一步,包含“## Step N: <标题>”、一到两句说明改了什么及原因、带文件名与行号的聚焦真实代码片段,以及一道交互式裁决问题:Looks good, next step(推荐)、Push back, change this,以及仅对非平凡代码提供的 Pause, explain more。需等待裁决后才展示下一步,记录通过项、收集修改请求,最后给出 | # | Step | Verdict | 表格。若某一步暴露真正的设计分叉,会暂停 QA 走查并提议针对该分叉切换到决策模式。
适用场景与限制 适合设计评审、方案取舍讨论、提交/PR/差异的分步代码走查。走查过程强调一次一个决策或步骤、基于真实代码而非泛泛描述;不产出实现代码。关于支持的客户端、安装方式、收费与平台支持,资料未提供。