vibe-run

vibe-run 是 Vibe 编码代理生态系统的核心组件，旨在将非结构化的编码任务转化为严谨、具备状态感知且可重现的工作流。它作为一个编排层，超越了简单的一次性提示词响应，实现了长周期的自主运作。通过使用基于 .vibe/ 目录下文件（特别是 STATE.md、PLAN.md 和 CONTEXT.md）的共享契约，vibe-run 允许代理程序在多个会话中保持连续性、从中断中恢复并提供可验证的进度。此工具适用于软件工程师与开发者，旨在自动化复杂的待办事项、多步骤重构与持续性文档撰写，同时确保对代理决策过程的掌控。

• 通过反复调用调度引擎 (agentctl) 并执行建议的提示词，来编排连续的代理循环。

• 维护持久的工作区状态，确保代理程序遵循预先定义的确定性检查点序列，而非随意创建工作流。

• 具备强大的错误处理机制，仅在收到 'stop' 角色信号或确认关键阻碍时停止运行，确保产出符合运维信任标准。

• 支持多种操作模式，包括交互式终端使用、非交互式 headless CI 自动化以及模拟运行 (dry-run)。

• 通过强制性的 LOOP_RESULT JSON 结构标准化输出，为下一次循环迭代提供清晰的审计追踪与可执行的反馈。

• 系统依赖于 .vibe/ 状态文件；若需在不同会话间追踪工作流历史，请确保这些文件已纳入版本控制。

• 使用 vibe_run.py 等核心脚本进行标准操作，或使用如 continuous_refactor.py 的特定包装器进行领域专属自动化。

• 预期的输入包括已正确初始化的存储库（含 .vibe/ 元数据）以及可访问的 template_prompts.md 目录。

• 执行协议遵循：调度、获取提示词、执行、记录结果与重复循环；当 STATE.md 中出现阻塞性问题时，请确保适时的人工介入。

• 运行器可处理如换行符差异等机械杂讯，但若状态追踪文件中标记为 'BLOCKED'，则需开发者手动更新状态以解除阻塞。