SuperAPI AI 工具集

oneshot

通用与其它

查看项目

更新于 10-15 20:28

技能介绍

用途:oneshot 用于实现一个小而聚焦的代码改动,适合目标清晰的快速修复或小问题。若任务实际较复杂,资料建议改用 /apex。

主要能力与工作方式:先解析输入。若输入是 GitHub issue 引用(#N、owner/repo#N 或 issue URL),用 gh issue view 获取标题、正文与标签作为任务描述,正文中的任务清单或验收标准作为实现清单;取用前先检查 gh auth status,gh 不可用时按平台安装并登录后重跑,取用失败就如实报告错误而非臆造 issue 内容。

随后进入最小探索:用 Glob 按模式找 2-3 个文件、用 Grep 查找具体符号或字符串,遵循项目当前的文档查询策略;若一两次直接搜索找不到改动点,则派发单个 Explore 子代理提出具体问题,避免多轮搜索污染上下文;无子代理则就地探索。定位到改动目标即停止探索。

复杂度检查:若发现跨文件或跨系统的广泛改动、横切关注点(数据库迁移、含客户端更新的 API 变更等)或需求不清晰,先说明评估变化并重新规划再编辑;已授权的可逆工作可继续。

编辑与精炼:立即执行改动,复用既有内容、工具与约定,严格限定在任务范围内;随后按 references/quality-lens.md 审视任务产出并删除不需要的部分,涉及信任边界的改动套用其安全底线,机械性改动可跳过。

验证:从项目说明与清单中发现必要检查,为改动提供行为证据及适用的 lint/类型检查,修复新引入的失败并重跑受影响检查;不相关的基线失败只报告不扩大任务;必要时更新直接受影响的文档。实际未运行的验证应标注为未验证,只报告真实执行的命令与结果。

输出格式:成功时给出 Done 段,含任务、改动文件、精炼内容与验证结果;受阻时给出 Blocked 段,含尝试次数、具体阻碍与建议。约束包括:只做一个任务、不做顺带改进、不做范围外重构、注释仅在代码无法表达原因时添加。另含写法规则:语句以动作或结果开头,避免营销词与 AI 腔套话,清理私有计划标签与过程叙述。安装方式、具体价格与平台支持等信息暂未提供。