Skip to content

PIPELINE.md

Latest commit

 

History

History
114 lines (96 loc) · 3.56 KB

PIPELINE.md

File metadata and controls

114 lines (96 loc) · 3.56 KB

ArgusBot Pipeline

1. 目标

ArgusBot 的执行目标是：让主代理持续实现任务，由评审代理把关，由规划代理维护整体框架和下一步建议，只有在“任务完成 + 验收检查通过”时才停止循环。

2. 端到端流程总览

flowchart TD
    A[CLI 解析参数] --> B[初始化 Runner / Reviewer / Planner / 可选 Dashboard / Telegram]
    B --> C[发出 loop.started]
    C --> D[开始第 N 轮 round.started]
    D --> E[主代理执行 codex exec 或 resume]
    E --> F[执行验收检查 --check]
    F --> G[评审代理输出 done/continue/blocked]
    G --> H[规划代理更新表格 / 风险 / 下一步]
    H --> I{done 且 checks 全通过?}
    I -- 是 --> J[规划代理生成最终 Markdown + follow-up objective]
    J --> K[loop.completed success=true]
    I -- 否 --> L{blocked?}
    L -- 是 --> M[规划代理生成最终 Markdown]
    M --> N[loop.completed success=false]
    L -- 否 --> O{连续无进展超阈值?}
    O -- 是 --> P[规划代理生成最终 Markdown]
    P --> Q[loop.completed success=false]
    O -- 否 --> R{达到 max_rounds?}
    R -- 是 --> S[规划代理生成最终 Markdown]
    S --> T[loop.completed success=false]
    R -- 否 --> U[构造继续提示并进入下一轮]
    U --> D
Loading

3. 每轮（Round）详细步骤

  1. 发出 round.started 事件。
  2. 主代理执行（首轮 exec，后续基于 session_id resume）。
  3. 记录主代理结果：
    • exit_code
    • turn_completed / turn_failed
    • fatal_error
    • last_message
  4. 运行所有 --check 命令，收集每条检查的通过状态。
  5. 调用评审代理，产出结构化决策：
    • status: done / continue / blocked
    • confidence
    • reason
    • next_action
  6. 调用规划代理，更新：
    • 工作流表格（已完成 / 进行中 / 待做 / 阻塞）
    • 当前 session 剩余项与风险
    • Explorer backlog（缺失数据、外部 API、相似项目）
    • 若 session 终止则生成下一次可执行 objective
  7. 产出 RoundSummary 并可选写入 --state-file、--plan-report-file 和 --plan-todo-file。
  8. 根据停止条件决定结束或继续下一轮。

4. 停止条件（按优先级）

  1. review.status == done 且所有 checks 通过 -> 成功结束。
  2. review.status == blocked -> 失败结束。
  3. 连续无进展轮数达到 max_no_progress_rounds -> 失败结束。
  4. 到达 max_rounds -> 失败结束。

5. 关键事件流

  • loop.started
  • round.started
  • round.main.completed
  • round.checks.completed
  • round.review.completed
  • plan.updated
  • plan.finalized
  • loop.completed

这些事件会同时驱动可选能力：

  • Dashboard 状态更新
  • Telegram 通知
  • 终端实时消息输出

6. 输入与输出

输入

  • 必填：objective
  • 常用控制项：
    • --max-rounds
    • --max-no-progress-rounds
    • --check（可重复）
    • --state-file
    • --plan-report-file
    • --session-id（续跑）

输出

  • 终端 JSON 总结：
    • success
    • session_id
    • stop_reason
    • rounds[]（每轮关键指标）
  • 可选状态文件（--state-file）：
    • 全量轮次信息、最新评审状态与最新规划快照
  • 可选规划 Markdown（--plan-report-file）：
    • 可直接展示给 Web/Telegram 的经理报告
  • 可选 TODO Markdown（--plan-todo-file）：
    • 持续维护的工作流表格、优先队列与探索 backlog

7. 最小使用示例

argusbot-run \
  --max-rounds 10 \
  --check "pytest -q" \
  "帮我在这个文件夹写一下pipeline"