SuperAPI AI 工具集

decide

编程与开发

查看项目

更新于 10-30 16:29

技能介绍

用途

Decide 用于把设计讨论和代码审查从“一次性大段输出”变成“逐项确认的对话”。它覆盖两种场景:一是设计或实现决策的走查,二是对已完成代码的逐步审查。

主要能力

准备阶段:设计走查前先检查相关代码,把具体缺陷、不一致和决策点记录到 plans/<YYYYMMDD>-<topic>.md 或对应的应用作用域 plans/ 目录。保留已有修改,未经明确许可不丢弃推测性或用户编写的内容。决策按依赖关系和杠杆作用排序,而非按文档顺序。

决策走查:每项决策展示标题,给出二到四句基于真实文件或函数的上下文,一句话说明权衡,然后只问一个含二到四个互斥选项的交互问题。支持时使用 ask_user;在 Codex Plan 模式下使用 request_user_input。若仓库规范要求交互浮层,不用纯文本问题替代。选项标签不超过五个词,推荐项排首位并标注 (Recommended),每个选项用一句话解释与其权衡;客户端自动添加 Other 时不重复添加。回答后记录 Logged: <decision> 并继续;若用户只认可问题未作选择,则记录推荐选项并说明可纠正。最终输出 | # | Decision | Choice | 表,并可提出把审计转为实现计划,走查期间不写实现代码。

QA 走查:确定审查单元(提交、暂存差异、PR 或指定文件集),按依赖顺序拆成逻辑步骤。每轮展示一步:说明改了什么和为什么,给出带文件与行号引用的聚焦代码片段,提出一个裁决问题(Looks good, next step 为推荐项;Push back, change this;仅对非平凡代码提供 Pause, explain more),等待裁决后再继续。记录批准、收集修改请求,最后输出 | # | Step | Verdict | 表;若某步暴露真正的设计分叉,可暂停 QA 并切换到决策模式。

使用方式

通过技能调用触发,用户说出类似“带我过一遍……”的请求即可。交互问题依赖运行环境提供的 ask_user 或 request_user_input 工具。

适用场景

需要逐项敲定设计方案、在实现前厘清决策点,或希望按步骤审查提交、PR、差异与文件集时使用。

限制

资料未提供具体安装命令、平台支持范围、收费方式与效果数据。决策走查阶段不产出实现代码;交互浮层能力取决于运行环境,资料未说明不支持交互工具时的降级行为。