Agent 研发工作台设计：任务、上下文、执行记录与人工审批

flowchart TB
  A["任务列表"] --> B["任务详情"]
  B --> C["上下文包"]
  B --> D["执行时间线"]
  B --> E["验证结果"]
  B --> F["审批面板"]
  D --> G["工具调用详情"]
  E --> H["测试报告 / 构建日志 / 安全扫描"]

stateDiagram-v2
  [*] --> Draft
  Draft --> Ready: context_pack_ready
  Ready --> Planning: start
  Planning --> WaitingApproval: risky_plan
  WaitingApproval --> Executing: approved
  WaitingApproval --> Rejected: rejected
  Planning --> Executing: safe_plan
  Executing --> Verifying: patch_created
  Verifying --> WaitingApproval: risky_result
  Verifying --> Completed: checks_passed
  Verifying --> Failed: checks_failed
  Failed --> Ready: retry
  Completed --> [*]

CREATE TABLE agent_tasks (
  id TEXT PRIMARY KEY,
  project_key TEXT NOT NULL,
  source_type TEXT NOT NULL,
  source_url TEXT,
  title TEXT NOT NULL,
  instruction TEXT NOT NULL,
  status TEXT NOT NULL DEFAULT 'draft',
  priority TEXT NOT NULL DEFAULT 'P2',
  risk_level TEXT NOT NULL DEFAULT 'medium',
  created_by TEXT NOT NULL,
  assigned_agent TEXT,
  target_branch TEXT,
  acceptance JSONB NOT NULL DEFAULT '[]',
  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
  updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
);

CREATE TABLE agent_task_events (
  id BIGSERIAL PRIMARY KEY,
  task_id TEXT NOT NULL REFERENCES agent_tasks(id),
  event_type TEXT NOT NULL,
  title TEXT NOT NULL,
  detail JSONB NOT NULL DEFAULT '{}',
  risk_level TEXT NOT NULL DEFAULT 'low',
  created_by TEXT NOT NULL DEFAULT 'agent',
  created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);

POST /api/agent/tasks
Content-Type: application/json

{
  "project_key": "payment-api",
  "source_type": "manual",
  "title": "修复退款状态没有同步到订单的问题",
  "instruction": "定位 refund succeeded 后 order.status 没有变成 refunded 的原因，并补充回归测试。",
  "priority": "P1",
  "target_branch": "main",
  "acceptance": [
    "新增 refund success 的回归测试",
    "pytest tests/payment -q 通过",
    "不能修改支付网关回调签名逻辑"
  ]
}

POST /api/agent/tasks/{task_id}/approvals
Content-Type: application/json

{
  "event_id": 921,
  "decision": "approved",
  "reason": "允许在测试环境执行数据库迁移 dry-run，不允许连接生产库。",
  "scope_override": {
    "allowed_commands": ["alembic upgrade head --sql"],
    "expires_in_minutes": 30
  }
}

<template>
  <section class="task-panel">
    <header>
      <h2>{{ task.title }}</h2>
      <span :class="['status', task.status]">{{ task.status }}</span>
    </header>

    <ol class="timeline">
      <li v-for="event in events" :key="event.id">
        <strong>{{ event.title }}</strong>
        <span>{{ event.event_type }}</span>
        <button
          v-if="event.event_type === 'approval_required'"
          @click="$emit('approve', event)"
        >
          审批
        </button>
      </li>
    </ol>
  </section>
</template>

<script setup>
defineProps({
  task: { type: Object, required: true },
  events: { type: Array, default: () => [] }
})

defineEmits(['approve'])
</script>