SuperAPI AI 工具集

oneshot

办公与效率

查看项目

更新于 10-16 00:02

技能介绍

用途:oneshot 是 Exarchos 中面向小改动的精简工作流,适用于改动有界(通常单文件或 2-3 个紧耦合文件)、无需子智能体分派、无需设计文档、无需两阶段评审的任务,例如修 README 错字、升级依赖、补一个 null 检查、改 CI YAML、重命名配置键、加一次性脚本或探索性验证。跨模块重构、多文件功能、需要设计探讨或 spec/quality 两阶段评审、需多智能体协作、需分阶段落地 PR 或需书面设计文档的场景不应使用,应改用完整功能流程 ideate。

主要能力:四阶段 plan → implementing → synthesize(可选)→ completed;通过 Exarchos MCP 动作(create_pr、merge_pr 等)自动路由到 GitHub、GitLab、Azure DevOps,无需 gh/glab/az 命令。synthesisPolicy 三种取值:always(始终走 PR)、never(始终直接提交)、on-request(默认,直接提交,但可在 implementing 中调用 request_synthesize 转为 PR)。决策由纯事件溯源守卫决定,policy 优先于事件,重复 request_synthesize 路由幂等。

使用方式:先 init:exarchos:exarchos_workflow({ action: "init", featureId: "...", workflowType: "oneshot", synthesisPolicy: "on-request" }),落在 plan;plan 阶段写一页计划并 update 写入 artifacts.plan 与 oneshot.planSummary,再 transition 到 implementing;implementing 阶段在主会话内实现并验证,按风险分级(默认低层静态分析,涉及 schema/type/API/共享契约或跨 I/O 边界时加测试,命名 Method_Scenario_Outcome),逐逻辑改动原子提交。完成后调用 finalize_oneshot 解析分支:直接提交路径执行 git push 即结束;PR 路径交接给 synthesize 流程,使用 prepare_synthesis(需传 repoRoot 绝对路径)、validate_pr_body、create_pr,合并后经 mergeVerified 守卫进入 completed。中途想开 PR 可调用 exarchos:exarchos_orchestrate({ action: "request_synthesize", featureId, reason }),plan 和 implementing 阶段均可调用,终态会被拒绝。

限制:无子智能体分派、无独立评审阶段,PR 评审是唯一评审;若发现改动变大,应取消并改用 ideate,不能中途把 oneshot 长成功能流程。具体价格、平台支持详情、性能效果等资料暂未提供。