用途
Vibe Code Orchestrator(VCO)是一个受治理的运行时入口,面向需要冻结需求、限定执行范围并强制验证与阶段清理的复杂任务。它被设计为一种与宿主语法无关的技能契约,用户可通过显式调用 $vibe、/vibe 或名为 vibe 的技能进入。
该入口不会将每一个松散相关的任务都纳入治理流程;轻量问答、单命令检查,或更适合由其他显式请求技能处理的任务,可在未显式调用本入口时继续在 vibe 之外执行。
主要能力
- 需求共识与冻结:使用
deep_interview直到用户与 Agent 就目标、范围、约束、交付物、相关未知项与完成标准达成一致,随后冻结需求。首轮澄清作为对话输入,而非最终冻结结果。 - 受治理的渐进式停止:设置
requirement_doc、xl_plan和phase_cleanup三个渐进式治理停止点。当bounded_return_control.explicit_user_reentry_required = true时,必须停止当前助手回合,等待后续用户消息批准或修订当前边界。 - 硬停止与再进入:这是一个硬运行时边界,优先于宿主通常的自动执行规则。详细原始请求不等于对冻结需求或计划的批准。再进入时需检查
runtime-summary.json中的bounded_return_control.host_decision_contract,推断用户意图,并写出结构化的宿主决策 JSON 文件,复用同一run_id、bounded_reentry_token与稳定的workspace_root。 - 固定状态机:包含六个阶段:
skeleton_check、deep_interview、requirement_doc、xl_plan、plan_execute、phase_cleanup。简单工作可让阶段变轻,但不能被静默跳过。 - 技能组织与 L/XL 工作流分级:批准需求后,Agent 必须把工作拆分为模块,对每个模块搜索本地技能根,阅读保留候选的
SKILL.md,并组织 L/XL 计划。L 为最小完整组织,XL 为有界多泳道组织。在xl_plan之前,宿主必须把验证后的结果放入HostDecisionJson.agent_skill_organization。 - 模块化执行与验证:以可验证工作单元组织每个确认模块,保留输出、检查、绑定理由与依赖关系。选用技能成为模块绑定的执行单元。完成需要可观察的模块结果与
protocols/runtime.md中定义的模块验收。 - XL 委派治理:根/子层级保持受治理。仅
root_governed可冻结规范需求/计划或作出最终完成声明;child_governed泳道继承冻结上下文,留在指定写入范围内,校验delegation-envelope.json,且只发出本地回执。
使用方式
用户通过显式调用 $vibe、/vibe 或 vibe 技能进入规范 vibe。在规范启动前,只执行启动所需的最小操作:解析 skill_root 与 workspace_root;将当前用户任务逐字作为任务规范传入(不得摘要、改写或简化为关键词),并保留精确输入路径、输入不可变约束、精确输出根、合成数据证据边界、模块依赖与安全并行边界以及验收标准。
启动前不要在安装根中搜索规范证明文件,不要检查仓库、协议文档或先前运行输出,不要模拟阶段或把包装器文本当作证明,不要手工创建 outputs/runtime/vibe-sessions/<run-id>/,不要把 Vibe 安装根用作受治理产物根。
规范入口命令形态:
$env:PYTHONPATH = "<skill_root>/apps/vgo-cli/src"
py -3 -m vgo_cli.main canonical-entry --repo-root "<skill_root>" --artifact-root "<workspace_root>" --prompt "<current user task, verbatim>"
在 PowerShell 中,不要将 $env:PYTHONPATH=... 放入双引号 -Command 字符串内,宿主插值可能将其破坏为 :PYTHONPATH。Bash 类宿主(包括 Claude Code)在外层 shell 设置 PYTHONPATH 并直接调用 Python;按可用性依次尝试 py -3、python、python3。
REPO_ROOT='<skill_root>'
WORKSPACE_ROOT="${WORKSPACE_ROOT:-$PWD}"
PYTHONPATH="$REPO_ROOT/apps/vgo-cli/src" python -m vgo_cli.main canonical-entry --repo-root "$REPO_ROOT" --artifact-root "$WORKSPACE_ROOT" --prompt "<current user task, verbatim>"
--host-id 与 --entry-id 仅保留用于包装器或旧自动化兼容;正常启动时应省略。仅在 canonical-entry 返回 session_root 后校验规范证明产物。启动证明需要 host-launch-receipt.json、runtime-input-packet.json、governance-capsule.json、stage-lineage.json。若规范启动失败,应报告 blocked 并给出具体失败原因,而不是模拟缺失阶段或证明产物。
适用场景
适合需要受治理需求/计划/执行闭环的复杂任务,以及用户显式调用该入口的场景。也可用于需要在执行前冻结需求、约束执行范围、并在完成前进行验证和阶段清理的工作。用户指令(包括 CLAUDE.md、GEMINI.md、AGENTS.md 以及 TDD 例外等直接工作流限制)保持最高优先级,规范启动与证明规则需在这些限制内保留。
限制
- 不将每个松散相关任务都路由进
vibe。 - 需求摘要、澄清输入不等于冻结结果,详细原始请求不等于批准。
- 硬停止后不得在治理再进入之外执行等价手工工作。
- 不得发明技能、提升路由候选、隐藏技能会话或开启另一个需求/计划/运行时表面。
- 不得添加模拟成功路径、吞掉错误或仅为通过结果的模板。
- 脚手架或草稿产物应视为
needs_execution且proof_ready = false,不得称为已完成工作。 - 模块验收标准不得要求清理回执、交付验收或完成语言许可。
- 文档未提供具体收费、价格或平台支持信息。