用途:Oneshot Workflow 是 Exarchos 提供的一种精简工作流类型,用于规模太小、不值得走完整功能流程(ideate→plan→plan-review→delegate→review→synthesize→completed),但仍需事件溯源审计和规划步骤的改动。
主要能力:四阶段生命周期。plan 阶段生成轻量单页计划(目标、方法、涉及文件、测试用例),不写设计文档、不派发子智能体;implementing 阶段在会话内按 TDD 循环执行(先写失败测试,再写最小实现,再重构),逐步提交;finalize 时通过事件溯源 guard 决定走直接提交路径(completed)还是合成路径(synthesize,创建 PR);synthesize 阶段复用标准合成流程,通过 create_pr 等 MCP 动作自动路由到 GitHub、GitLab、Azure DevOps,无需 gh/glab/az 命令。
合成策略:synthesisPolicy 有三个取值。always 总是创建 PR;never 总是直接提交;on-request(默认)默认为直接提交,可在 implementing 期间调用 request_synthesize 选择加入 PR。策略优先于事件:即使存在 synthesize.requested 事件,never 仍路由到 completed。决策由状态与事件计数纯函数决定,可安全重放。
使用方式:先调用 exarchos_workflow 的 init(workflowType: 'oneshot',可选 synthesisPolicy),plan 阶段设置 artifacts.plan 并迁移到 implementing;实现完成后调用 finalize_oneshot 解决选择点;直接提交路径推送到当前分支即可,PR 路径转交 synthesis 流程。request_synthesize 可在 plan 与 implementing 阶段调用。
适用场景:README 错别字修复、依赖版本升级、单函数空值检查、CI YAML 调整、配置键重命名、一次性辅助脚本、探索性 spike 等单文件或 2-3 个紧耦合文件的有界改动。
限制:不适用于跨模块重构、多文件功能、需要设计探索或两阶段评审、需要与其他智能体团队协作、需要堆叠 PR 或书面设计文档的场景,此类情况应改用完整功能工作流。若开工后发现问题变大,建议取消后重新走 ideate。终态阶段不接受 request_synthesize。