SuperAPI AI 工具集

clarify-confirm-continue

办公与效率

查看项目

更新于 10-15 23:45

技能介绍

用途:在跨代码库、文档树与项目工作区的多步骤或复杂请求中,让代理与用户在开始任何修改或大范围执行之前充分对齐。它可作为流程化的工作流使用,资料提到可与 grilling 技能配合,用于先进行多轮架构式质询再起草计划。

主要能力与流程: 第一阶段为事实核查与分叉查找。先用只读工具(grep_search、view_file、list_dir、code_search、moma_search)自主检查环境,包括函数签名、类型定义、约定、既有测试套件,以及 Markdown 文档、设计文档(g3doc/、docs/)、笔记、规范、参考资料与 schema。原则是绝不向用户询问工作区中已可验证的事实。随后把未决事项分类:工作区事实用检查工具获取,永不提问;虚假两难(明显正确与明显错误、标准最佳实践)不提问,直接执行;真实决策分叉(两条以上可行且有真实权衡的路径,如 API 设计、文档框架、破坏性变更)需先澄清再总结。若存在真实分叉,应在单次 ask_question 中并列呈现独立分叉,依赖型分叉逐个询问,说明权衡并给出推荐及理由;不得把未决分叉转化为未经验证的假设。 第二阶段为结构化总结与就绪门。用 ask_question 呈现 markdown 总结,包含目标、非目标与范围边界、已定决策与不变量、执行计划,并附推荐选项(继续、在 artifact 中打开、在聊天中调整)。为防止界面折叠,总结应嵌入 ask_question 的 question 参数。 第三阶段处理选择:继续则进入执行;在 artifact 中打开则用 write_to_file 保存总结与计划为 .md,并配置交互审批;若在聊天中调整则应用反馈并在重大变更后重新确认。

限制与安全不变量:第一阶段和第二阶段不得编辑工作区文件、创建分支或运行变更命令;必须经 ask_question 或写入式批准后才进入执行;确认门授权后,AGENTS.md 中版本控制、推送、PR 与落地等标准审批门仍独立严格执行。平台支持情况与安装方式暂未提供。