Optio

面向 AI 编码智能体的全链路工作流编排工具，从任务领取到 PR 合并。

Optio 能够将代码任务转化为合并后的 Pull Request，且无需人工干预。你只需提交任务（手动提交、通过 GitHub Issue 或 Linear），剩下的工作全部由 Optio 处理：配置隔离环境、运行 AI 智能体、提交 PR、监控 CI 状态、触发代码审查、自动修复错误，并在测试通过后完成合并。

其核心优势在于反馈闭环。当 CI 失败时，智能体会自动携带错误上下文重新启动；当审查人员提出修改建议时，智能体会读取审查意见并进行修复；当所有流程通过后，PR 会被 Squash 合并，任务随之关闭。你只需描述需求，Optio 会负责将其执行到底。

• 仪表板 — 实时查看运行中的智能体、Pod 状态、成本消耗及近期活动。
• 任务详情 — 实时流式输出智能体运行日志、流水线进度、PR 跟踪及成本明细。

工作原理

You create a task          Optio runs the agent           Optio closes the loop
─────────────────          ──────────────────────         ──────────────────────

  GitHub Issue              Provision repo pod             CI fails?
  Manual task       ──→     Create git worktree    ──→       → Resume agent with failure context
  Linear ticket             Run Claude Code / Codex        Review requests changes?
                            Open a PR                        → Resume agent with feedback
                                                           CI passes + approved?
                                                             → Squash-merge + close issue

1. 接收 (Intake) — 任务源自 Web UI、GitHub Issues（一键分配）或 Linear 票据。
2. 配置 (Provisioning) — Optio 为仓库查找或创建 Kubernetes Pod，并创建 git worktree 以确保隔离性。
3. 执行 (Execution) — AI 智能体（Claude Code 或 OpenAI Codex）基于你配置的提示词、模型和设置运行。
4. PR 生命周期 — Optio 每 30 秒轮询一次 PR，以获取 CI 状态、审查进度及合并就绪情况。
5. 反馈闭环 (Feedback loop) — CI 失败、合并冲突及审查反馈会自动携带上下文恢复智能体运行。
6. 完成 (Completion) — PR 进行 Squash 合并，关联的任务被关闭，成本被记录。

核心功能

• 自动化反馈闭环 — 在 CI 失败、合并冲突和审查反馈时自动恢复智能体运行；在所有检查通过后自动合并。
• Pod-per-repo 架构 — 每个仓库对应一个长生命周期的 Kubernetes Pod，支持 git worktree 隔离、多 Pod 扩展及空闲资源清理。
• 代码审查智能体 — 自动将审查任务作为子任务启动，并使用独立的提示词和模型进行评估。
• 仓库级配置 — 每个仓库均可自定义模型、提示词模板、容器镜像、并发限制及初始化命令。
• GitHub Issues 与 Linear 集成 — 可通过 UI 或票据同步将问题分配给 Optio。
• 实时仪表板 — 提供实时日志流、流水线进度、成本分析及集群健康状态监控。

架构

┌──────────────┐     ┌────────────────────┐     ┌───────────────────────────┐
│   Web UI     │────→│    API Server      │────→│      Kubernetes           │
│   Next.js    │     │    Fastify         │     │                           │
│   :3100      │     │                    │     │  ┌── Repo Pod A ───────┐  │
│              │←ws──│  Workers:          │     │  │ clone + sleep       │  │
│  Dashboard   │     │  ├─ Task Queue     │     │  │ ├─ worktree 1  ⚡    │  │
│  Tasks       │     │  ├─ PR Watcher     │     │  │ ├─ worktree 2  ⚡    │  │
│  Repos       │     │  ├─ Health Mon     │     │  │ └─ worktree N  ⚡    │  │
│  Cluster     │     │  └─ Ticket Sync    │     │  └─────────────────────┘  │
│  Costs       │     │                    │     │  ┌── Repo Pod B ───────┐  │
│  Issues      │     │  Services:         │     │  │ clone + sleep       │  │
│              │     │  ├─ Repo Pool      │     │  │ └─ worktree 1  ⚡    │  │
│              │     │  ├─ Review Agent   │     │  └─────────────────────┘  │
│              │     │  └─ Auth/Secrets   │     │                           │
└──────────────┘     └─────────┬──────────┘     └───────────────────────────┘
                               │                  ⚡ = Claude Code / Codex
                        ┌──────┴──────┐
                        │  Postgres   │  Tasks, logs, events, secrets, repos
                        │  Redis      │  Job queue, pub/sub, live streaming
                        └─────────────┘

任务生命周期

  ┌──────────────────────────────────────────────────┐
  │                     INTAKE                       │
  │                                                  │
  │   GitHub Issue ───→ ┌──────────┐                 │
  │