# Agent 任务管理系统设计

> 创建日期：2026-03-18  
> 更新日期：2026-03-19  
> 参与者：比利哥（用户）、星枢（调度 Agent）

---

## 背景与目标

- 我（星枢）接收任务需求 → 写入 Notion 看板 → 执行 Agent 轮询领取 → 执行完成标记
- 全程可通过手机查看任务进度

---

## 系统架构

```
比利哥 → 星枢(规划确认) → Notion看板 → 云系Agent(轮询领取) → 标记完成
              ↑                                        │
              └──────────── 双通道通知 ←───────────────┘
```

**测试范围**：先从云系 Agent（Ubuntu2）开始，星系暂不动。

---

## Notion 数据库结构

### 1. 任务数据库

| 字段 | 类型 | 说明 |
|------|------|------|
| 任务名 | Title | 任务标题 |
| 任务类型 | Relation → TaskTypes | 关联类型 |
| 状态 | Select | TODO / 进行中 / 待验收 / 完成 / 需修复 |
| 执行者 | Relation → Agents | 谁来执行 |
| 验收者 | Relation → Agents | 谁来验收 |
| 优先级 | Select | 1-5（1最高） |
| 依赖任务 | Relation | 关联同一数据库的任务（前置任务） |
| 验收标准 | Text | 可量化标准 |
| 报告链接 | URL | 指向 Obsidian 笔记 |

### 2. Agents 数据库

| 字段 | 类型 | 说明 |
|------|------|------|
| Agent ID | Title | 如 yunjiang |
| 名称 | Text | 如 云匠 |
| 服务器 | Select | Ubuntu2 / Ubuntu1 / Mac Mini |
| 角色 | Select | 云系 / 风系 / 星系 |
| 可执行任务类型 | Relation → TaskTypes | 多对多 |
| 状态 | Select | 在线 / 离线 |

### 3. TaskTypes 数据库

| 字段 | 类型 | 说明 |
|------|------|------|
| 类型名 | Title | 如 开发、运维、监控、CI/CD |
| 描述 | Text | 类型说明 |
| 适用 Agent | Relation → Agents | 多对多 |

---

## 工作流程

### 1. 任务创建（星枢执行）

1. 比利哥给需求
2. 星枢分析需求、拆分子任务、指定执行 Agent、定义验收标准
3. 输出任务列表，与比利哥确认
4. 确认后写入 Notion 看板

### 2. 任务执行（Agent 轮询）

**每个 Agent 定时轮询（3-5 分钟）**：

1. 查询条件：状态=TODO AND 执行者=我 AND (无依赖 OR 依赖任务.状态=完成)
2. 领取任务：状态→进行中
3. 执行完成：
   - 推送消息到 Slack 通知比利哥
   - 创建 Obsidian 报告笔记
   - 状态→待验收
   - 填入报告链接到 Notion

### 3. 任务验收

- **暂缓**：验收者、验收流程后续再定

---

## 双通道通知

任务完成后，同时触发两个通道：

| 通道 | 方式 | 用途 |
|------|------|------|
| 即时通知 | Slack 消息 | 让您实时感知任务完成 |
| 报告存档 | Obsidian 笔记 | 详细执行记录持久化 |

### 报告模板（Obsidian）

```markdown
# 任务执行报告

**任务名**: xxx
**执行者**: yunjiang
**执行时间**: 2026-03-19 20:30
**状态**: 完成

## 执行内容
...

## 结果
...

## 下一步
...
```

---

## 关键设计决策

| 决策 | 说明 |
|------|------|
| 任务分配 | 直接指定执行 Agent，优先级驱动 |
| 依赖管理 | 通过 Relation 实现，支持多层级依赖 |
| 任务协作 | Agent 通过轮询感知依赖满足，被动触发（延迟分钟级） |
| 双通道通知 | 即时消息 + Obsidian 报告存档，两者并行 |

---

## 待实现

- [ ] Notion Integration 配置（用户创建，提供 Token）
- [ ] 创建三个数据库（任务、Agents、TaskTypes）
- [ ] Notion API 集成（创建/查询/更新任务）
- [ ] 云系 Agent 配置 Heartbeat 轮询
- [ ] 验证任务获取流程

---

## 相关 Agent

| Agent | 服务器 | 角色 |
|-------|--------|------|
| yunjiang | Ubuntu2 | 云匠 / 开发 |
| yunzhi | Ubuntu2 | 云织 / CI/CD |
| yunhan | Ubuntu2 | 云瀚 / 监控 |
| yunce | Ubuntu2 | 云策 / 架构 |

---

## 备注

- 2026-03-18：初始设计
- 2026-03-19：补充数据库 Relation 设计、先从云系测试、验收后续再定、双通道通知