From b0cf98e422ebfab1ac2eefbb1c1398ee4cd44940 Mon Sep 17 00:00:00 2001 From: bizwings Date: Mon, 22 Jun 2026 23:42:37 +0800 Subject: [PATCH] =?UTF-8?q?feat(BIZ-24):=20v1.1=20-=20=E5=A2=9E=E5=8A=A0?= =?UTF-8?q?=E5=85=A8=E4=BB=BB=E5=8A=A1=E6=BA=90=E7=BB=9F=E4=B8=80=E7=9B=91?= =?UTF-8?q?=E6=8E=A7=EF=BC=88WorkBoard=20+=20Multica=20+=20=E5=BE=85?= =?UTF-8?q?=E5=8A=9E=E6=96=87=E6=A1=A3=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 变更： - 新增「规则 0: 全任务源统一监控」（规则从 5 项扩展为 6 项） - 三源监控脚本：WorkBoard、Multica issues、待办文档 - 超时检测扩展为跨平台（WorkBoard + Multica） - 自动恢复增加 Multica 恢复流程 - 依赖检查增加 Multica parent_issue_id - 心跳清单从 4 项扩展为 6 项 - 全局规则从 6 条扩展为 7 条 - 新增 Agent Multica UUID 映射表 - COO 专属全平台积压巡检脚本 Addresses Vincent's review feedback: 智能体监控应覆盖 Multica issues，避免工作遗漏 Co-authored-by: multica-agent --- plans/BIZ-24_HEARTBEAT增强模板方案.md | 517 +++++++++++++++++++------- 1 file changed, 383 insertions(+), 134 deletions(-) diff --git a/plans/BIZ-24_HEARTBEAT增强模板方案.md b/plans/BIZ-24_HEARTBEAT增强模板方案.md index 861a35f..7f346a6 100644 --- a/plans/BIZ-24_HEARTBEAT增强模板方案.md +++ b/plans/BIZ-24_HEARTBEAT增强模板方案.md @@ -1,23 +1,38 @@ # BIZ-24 HEARTBEAT.md 增强模板方案 -> Phase 1 of BIZ-13 运行稳定性保障方案 -> 版本：v1.0 -> 编制：陆怀瑾（COO） -> 日期：2026-06-22 -> 状态：待审阅 +> Phase 1 of BIZ-13 运行稳定性保障方案 +> 版本：v1.1（2026-06-22 优化：增加全任务源统一监控） +> 编制：陆怀瑾（COO） +> 日期：2026-06-22 +> 状态：待审阅 > 关联：[BIZ-13 运行稳定性保障方案](BIZ-13_运行稳定性保障方案.md) --- ## 一、目标 -为所有 Agent 的 HEARTBEAT.md 文件统一增强以下 5 项机制，解决任务停滞与运行异常问题： +为所有 Agent 的 HEARTBEAT.md 文件统一增强以下机制，解决任务停滞、运行异常与工作遗漏问题： -1. **禁止请示规则** — 消除"等待用户确认"导致的任务卡死 -2. **超时检测规则** — 按 Agent 类型差异化配置心跳频率 -3. **自动恢复规则** — 检测无进展时自动重新调度 -4. **依赖检查前置** — 任务启动前强制检查所有依赖 -5. **最大轮次限制** — 防止无限循环或资源耗尽 +1. **全任务源统一监控** — 覆盖 OpenClaw WorkBoard + Multica Issues + 待办文档，避免工作遗漏 +2. **禁止请示规则** — 消除"等待用户确认"导致的任务卡死 +3. **超时检测规则** — 按 Agent 类型差异化配置心跳频率 +4. **自动恢复规则** — 检测无进展时自动重新调度 +5. **依赖检查前置** — 任务启动前强制检查所有依赖 +6. **最大轮次限制** — 防止无限循环或资源耗尽 + +### 1.1 为什么需要全任务源统一监控 + +当前 Agent 工作面临的任务来源是多平台的： + +| 任务来源 | 平台/工具 | 查询方式 | 当前监控状态 | +|----------|-----------|----------|------------| +| WorkBoard 卡片 | OpenClaw workboard | `openclaw workboard list` | ✅ 已纳入 | +| 待办文档 | 各 Agent workspace 的 TODO.md / AGENTS.md | 文件读取 | ⚠️ 部分纳入 | +| Multica Issues | Multica 平台 | `multica issue list --assignee-id ` | ❌ 未纳入 | + +**问题**：Multica Issues 中分配给 Agent 的任务当前完全不在心跳监控范围内，Agent 可能永远不会发现并执行这些任务，导致工作永久遗漏。 + +**对策**：每次心跳同步检查以上三个来源，确保无一遗漏。 --- @@ -43,7 +58,117 @@ --- -## 三、五项增强规则详解 +## 三、六项增强规则详解 + +### 规则 0：全任务源统一监控 + +**问题**：Agent 的任务分布在多个平台（OpenClaw WorkBoard、Multica Issues、工作区待办文档），各平台独立存在，Agent 只监控其中一部分会导致工作任务被永久遗漏。 + +**规则文本**： +```markdown +## 📋 全任务源统一监控（每次心跳必检） + +> **核心原则：发现任何来源的任务都必须立即执行，不得遗漏。** +> 你的工作任务可能存在于三个地方：OpenClaw WorkBoard、Multica Issues、本地待办文档。 + +### 任务源检查清单（按优先级） + +#### 第一优先级：OpenClaw WorkBoard 卡片 + +\```bash +# 检查 WorkBoard 中分配给自己的待办卡片 +openclaw workboard list --json 2>/dev/null | python3 -c " +import sys, json +data = json.load(sys.stdin) +my_cards = [c for c in data.get('cards', []) + if c.get('agentId') == '' and c.get('status') == 'todo'] +for c in my_cards: + print(f'WORKBOARD TODO: {c[\"id\"][:8]} [priority={c.get(\"priority\",\"?\")}] {c[\"title\"]}') +" +\``` + +#### 第二优先级：Multica Issues + +\```bash +# 检查 Multica 中分配给自己的待办 Issue +multica issue list --assignee-id --status todo --output json 2>/dev/null | python3 -c " +import sys, json +data = json.load(sys.stdin) +for issue in data: + print(f'MULTICA TODO: {issue[\"identifier\"]} [{issue.get(\"priority\",\"?\")}] {issue[\"title\"]}') +" +\``` + +#### 第三优先级：待办文档 + +\```bash +# 检查工作区待办文档（TODO.md 或 AGENTS.md 中未完成的任务） +grep -n '\[ \]' TODO.md AGENTS.md 2>/dev/null || echo "无待办文档" +\``` + +### 三源合并决策 + +``` +心跳开始 + ↓ +检查 WorkBoard 待办卡片 + ↓ +检查 Multica Issues 待办 + ↓ +检查待办文档 + ↓ +合并去重（避免同一任务在不同来源重复出现） + ↓ +按优先级排序后依次执行 +``` + +### Multica Issue 认领与执行流程 + +``` +发现 Multica todo Issue（assignee 是自己） + ↓ +启动 Multica Runtime 执行任务 + ↓ +完成后通过 multica issue comment add 汇报结果 + ↓ +更新 issue status 为 in_review / done +``` + +### COO 专属：全平台积压巡检 + +作为 COO，还需要额外检查全平台的任务积压情况（不限自己）： + +\```bash +#!/bin/bash +# COO 全平台任务积压巡检脚本 + +echo "=== OpenClaw WorkBoard 全局积压 ===" +openclaw workboard list --json 2>/dev/null | python3 -c " +import sys, json +data = json.load(sys.stdin) +cards = data.get('cards', []) +todo = [c for c in cards if c.get('status') == 'todo'] +inprog = [c for c in cards if c.get('status') == 'in_progress'] +print(f' 待办: {len(todo)} | 进行中: {len(inprog)} | 总计: {len(cards)}') +if len(todo) > 5: + print(f' ⚠️ 积压告警：待办超过 5 个，需协调资源') +for c in todo[:10]: + print(f' {c[\"id\"][:8]} → {c.get(\"agentId\",\"?\")} - {c[\"title\"][:60]}') +" + +echo "" +echo "=== Multica Issues 全局积压 ===" +multica issue list --status todo --output json 2>/dev/null | python3 -c " +import sys, json +data = json.load(sys.stdin) +print(f' 待办: {len(data)}') +if len(data) > 5: + print(f' ⚠️ 积压告警：Multica 待办超过 5 个') +for issue in data[:10]: + print(f' {issue[\"identifier\"]} → {issue.get(\"assignee_id\",\"未分配\")[:12]} - {issue[\"title\"][:60]}') +" +\``` +``` ### 规则 1：禁止请示规则 @@ -53,7 +178,7 @@ ```markdown ## ⚠️ 禁止请示规则（最高优先级） -你在心跳中发现 WorkBoard 任务后，必须立即执行，绝对禁止向用户请示！ +你在心跳中发现任何来源的任务后，必须立即执行，绝对禁止向用户请示！ 原因： - 用户在大多数时候并不在线，请示会导致任务卡死数小时 @@ -61,10 +186,10 @@ - 你的职责是"主动完成交付"，而不是"等待指令" 正确做法： -1. 发现 status=todo 且 agentId=你的卡片 +1. 发现任何来源的待办任务（WorkBoard / Multica / 待办文档） 2. 立即认领并执行 3. 如遇信息不足，先按自己的最佳理解执行，执行中再调整 -4. 任务完成后，通知任务创建者 +4. 任务完成后，通过对应平台汇报结果 错误做法（绝对禁止）： - ❌ "我发现了一个任务，要不要做？" @@ -84,14 +209,15 @@ ### 心跳频率：10 分钟 每次心跳执行以下检测： -1. 检查所有进行中任务的最新更新时间 +1. 检查所有平台进行中任务的最新更新时间（WorkBoard + Multica） 2. 如超过 20 分钟无进展 → 标记为"疑似超时" 3. 疑似超时 → 立即追加一次完整心跳，尝试推进 4. 如确认超时 → 进入自动恢复流程 -### 检测脚本 +### 跨平台超时检测脚本 \```bash -# 检查进行中任务是否超时 +# 检查进行中任务是否超时（WorkBoard + Multica） +echo "=== WorkBoard 超时检测 ===" openclaw workboard list --json 2>/dev/null | python3 -c " import sys, json, time data = json.load(sys.stdin) @@ -101,8 +227,21 @@ for c in inprogress: updated = c.get('updated_at', '') if updated: age = now - time.mktime(time.strptime(updated[:19], '%Y-%m-%dT%H:%M:%S')) - if age > 1200: # 20 分钟 - print(f'⏰ TIMEOUT: {c[\"id\"][:8]} [{c.get(\"agentId\",\"?\")}] {c[\"title\"]}') + if age > 1200: + print(f'⏰ WB TIMEOUT: {c[\"id\"][:8]} [{c.get(\"agentId\",\"?\")}] {c[\"title\"]}') +" + +echo "=== Multica 超时检测 ===" +multica issue list --status in_progress --output json 2>/dev/null | python3 -c " +import sys, json, time +data = json.load(sys.stdin) +now = time.time() +for issue in data: + updated = issue.get('updated_at', '') + if updated: + age = now - time.mktime(time.strptime(updated[:19], '%Y-%m-%dT%H:%M:%S')) + if age > 1200: + print(f'⏰ MUL TIMEOUT: {issue[\"identifier\"]} [{issue.get(\"assignee_id\",\"?\")[:12]}] {issue[\"title\"]}') " \``` ``` @@ -111,7 +250,7 @@ for c in inprogress: ```markdown ### 心跳频率：15 分钟 每次心跳执行以下检测： -1. 检查所有进行中任务的最新更新时间 +1. 检查所有平台进行中任务的最新更新时间（WorkBoard + Multica） 2. 如超过 30 分钟无进展 → 标记为"疑似超时" ``` @@ -119,7 +258,7 @@ for c in inprogress: ```markdown ### 心跳频率：15 分钟 每次心跳执行以下检测： -1. 检查所有进行中任务的最新更新时间 +1. 检查所有平台进行中任务的最新更新时间（WorkBoard + Multica） 2. 如超过 30 分钟无进展 → 标记为"疑似超时" ``` @@ -133,7 +272,7 @@ for c in inprogress: ### 恢复流程 ``` -检测到超时（无进展超阈值） +检测到超时（跨平台无进展超阈值） ↓ 步骤 1：追加一次完整心跳，尝试推进任务 ↓ @@ -145,7 +284,7 @@ for c in inprogress: │ │ 重置超时计数器 步骤 3：通知 COO/创建者 │ │ -继续执行 步骤 4：标记为 blocked +继续执行 步骤 4：通过对应平台标记 blocked │ 步骤 5：重新调度（分配备用 Agent 或 等待人工介入） @@ -153,31 +292,23 @@ for c in inprogress: ### 自动恢复触发条件 - 高频 Agent：超 30 分钟无进展 → 自动重新调度 -- 开发 Agent：超 45 分钟无进展 → 自动重新调度 +- 开发 Agent：超 45 分钟无进展 → 自动重新调度 - 业务 Agent：超 45 分钟无进展 → 自动重新调度 -### 恢复操作 -1. 停止当前任务执行 -2. 在任务中添加评论说明超时原因 -3. 释放 Agent 认领（release claim） -4. 通知 COO 重新分配 -5. 如任务可重试 → 创建重新调度标记 +### 跨平台恢复操作 +**WorkBoard 任务**： +1. 添加评论说明超时原因 +2. 释放 Agent 认领（release claim） +3. 通知 COO 重新分配 -### 恢复脚本示例 -\```bash -# 自动恢复：重新调度超时任务 -openclaw workboard list --json 2>/dev/null | python3 -c " -import sys, json, time -data = json.load(sys.stdin) -timed_out = [c for c in data.get('cards', []) - if c.get('status') == 'in_progress' - and c.get('agentId') in ['agent_id_list']] -for c in timed_out: - # 检查是否超过自动恢复阈值 - # 如超过 → 释放认领，通知 COO - print(f'RECOVER: {c[\"id\"][:8]}') -" -\``` +**Multica Issue**： +1. `multica issue comment add` 说明超时原因 +2. `multica issue status blocked` +3. 通知 COO 重新分配 + +**待办文档任务**： +1. 在原文档中标注超时状态 +2. 如可转为 WorkBoard 卡片 → 创建卡片并通知 COO ``` ### 规则 4：依赖检查前置 @@ -191,14 +322,21 @@ for c in timed_out: ### 任务启动前强制检查 每次认领或启动任务前，必须执行依赖检查： +**WorkBoard 任务**： 1. 读取任务的 depends_on 字段 2. 逐一检查每个依赖任务的状态 3. 所有依赖 ready → 可以启动 4. 任一依赖未完成 → 禁止启动，标记为 blocked +**Multica Issue**： +1. 读取 issue 的 parent_issue_id +2. 检查父 issue 状态 +3. 父 issue 未完成 → 禁止启动 + ### 检查脚本 + +#### WorkBoard 依赖检查 \```bash -# 依赖检查 openclaw workboard read --json 2>/dev/null | python3 -c " import sys, json card = json.load(sys.stdin) @@ -207,11 +345,31 @@ if deps: for dep in deps: print(f'依赖: {dep[\"id\"]} → 状态: {dep.get(\"status\", \"?\")}') if dep.get('status') != 'done': - print(f'⛔ 依赖未满足，禁止启动任务 {card[\"id\"][:8]}') + print(f'⛔ WB 依赖未满足，禁止启动 {card[\"id\"][:8]}') sys.exit(1) - print('✅ 所有依赖已满足') + print('✅ 所有 WB 依赖已满足') else: - print('✅ 无依赖，可以启动') + print('✅ 无 WB 依赖，可以启动') +" +\``` + +#### Multica 依赖检查 +\```bash +multica issue get --output json 2>/dev/null | python3 -c " +import sys, json +issue = json.load(sys.stdin) +parent_id = issue.get('parent_issue_id') +if parent_id: + import subprocess + result = subprocess.run(['multica', 'issue', 'get', parent_id, '--output', 'json'], + capture_output=True, text=True) + parent = json.loads(result.stdout) + if parent.get('status') != 'done': + print(f'⛔ MUL 父 Issue {parent[\"identifier\"]} 未完成，禁止启动') + sys.exit(1) + print(f'✅ 父 Issue {parent[\"identifier\"]} 已完成') +else: + print('✅ 无父 Issue 依赖，可以启动') " \``` @@ -249,6 +407,11 @@ else: 4. COO 决定：重新分配 / 拆分任务 / 人工介入 ``` +### 跨平台轮次跟踪 +- **WorkBoard**：通过 workboard_heartbeat 的 note 记录轮次 +- **Multica**：通过 issue comment 记录轮次进度 +- **待办文档**：在工作日志中记录 + ### 计数器维护 \```bash # 每次心跳更新轮次计数 @@ -277,16 +440,29 @@ else: ```markdown # HEARTBEAT.md - [Agent Name] 的心跳配置 +## 📋 全任务源统一监控（每次心跳必检） + +> **核心原则：发现任何来源的任务都必须立即执行，不得遗漏。** + +### 三源检查 +1. **OpenClaw WorkBoard** — workboard list → 查找 agent_id=自己 & status=todo +2. **Multica Issues** — issue list --assignee-id --status todo +3. **待办文档** — 检查 TODO.md / AGENTS.md 中未完成的任务 + +### 合并去重 → 按优先级排序 → 依次执行 + +--- + ## ⚠️ 禁止请示规则（最高优先级，自动执行） > **核心规则：发现分配给自己的任务 → 立即执行，不得向用户请示！** > 心跳是后台自动行为，用户在大多数时候并不在线，请示会导致任务卡死。 ### 执行流程（严格执行，无需确认） -1. **检查待办卡片** — 查找 agent_id 为自己且 status=todo 的卡片 -2. **立即执行，不得请示** — 发现待办卡片后直接执行 -3. **检查进行中卡片** — 确认认领的任务状态 -4. **完成任务** — 完成后通知任务创建者 +1. **三源检查待办** — WorkBoard + Multica + 待办文档 +2. **立即执行，不得请示** — 发现待办后直接执行 +3. **检查进行中任务** — 确认认领的任务状态 +4. **完成任务** — 通过对应平台汇报结果 ### ⚠️ 绝对禁止行为 - ❌ 不得问"要不要做这个任务" @@ -298,11 +474,12 @@ else: ## ⏱️ 超时检测规则 ### 心跳频率：10 分钟 -每次心跳执行以下检测： -1. 检查进行中任务的最新更新时间 -2. 超过 20 分钟无进展 → 标记为"疑似超时" -3. 疑似超时 → 追加一次完整心跳尝试推进 -4. 确认超时 → 进入自动恢复流程 +每次心跳跨平台执行以下检测： +1. 检查 WorkBoard 进行中任务的更新时间 +2. 检查 Multica 进行中 issues 的更新时间 +3. 超过 20 分钟无进展 → 标记为"疑似超时" +4. 疑似超时 → 追加一次完整心跳尝试推进 +5. 确认超时 → 进入自动恢复流程 --- @@ -311,19 +488,19 @@ else: ### 触发条件 - 超 30 分钟无进展 → 自动重新调度 -### 恢复操作 -1. 停止当前任务执行 -2. 添加评论说明超时原因 -3. 释放 Agent 认领 -4. 通知 COO 重新分配 -5. 创建重新调度标记 +### 恢复操作（按平台） +| 平台 | 操作 | +|------|------| +| WorkBoard | 添加评论 → release claim → 通知 COO | +| Multica | 添加评论 → status=blocked → 通知 COO | +| 待办文档 | 标注超时 → 转为卡片（可选） | --- ## 🔗 依赖检查前置规则 ### 强制检查流程 -1. 认领任务前，读取 depends_on 字段 +1. 认领任务前，读取依赖字段（depends_on / parent_issue_id） 2. 逐一检查每个依赖任务的状态 3. 依赖未满足 → 不认领（保持 todo） 4. 超过等待阈值（1h）→ 通知依赖任务执行者 @@ -340,11 +517,12 @@ else: ## 🫀 心跳执行清单 -1. ✅ WorkBoard 任务检查 -2. ✅ 进行中任务超时检测 +1. ✅ **全任务源检查**：WorkBoard + Multica + 待办文档 +2. ✅ 进行中任务超时检测（跨平台） 3. ✅ 依赖检查 4. ✅ 轮次计数器更新 -5. ✅ [Agent 专属检查项] +5. ✅ 全平台积压巡检（仅 COO） +6. ✅ [Agent 专属检查项] --- @@ -352,10 +530,11 @@ else: 1. **心跳不打断对话** — 用户正在对话时延后执行 2. **非紧急事项延后汇报** — 等下一轮心跳或用户询问 -3. **发现任务立即执行，不得请示** -4. **超时任务按自动恢复流程处理** +3. **发现任务立即执行，不得请示**（任何来源） +4. **超时任务按自动恢复流程处理**（跨平台） 5. **依赖未满足不启动** 6. **达到轮次上限自动暂停** +7. **避免任务遗漏** — 三源必须全部检查，缺一不可 ``` ### 4.2 开发 Agent 完整模板（projectmanager / productmanager / architect / costcodev / designer / opengineer） @@ -363,16 +542,29 @@ else: ```markdown # HEARTBEAT.md - [Agent Name] 的心跳配置 +## 📋 全任务源统一监控（每次心跳必检） + +> **核心原则：发现任何来源的任务都必须立即执行，不得遗漏。** + +### 三源检查 +1. **OpenClaw WorkBoard** — workboard list → 查找 agent_id=自己 & status=todo +2. **Multica Issues** — issue list --assignee-id --status todo +3. **待办文档** — 检查 TODO.md / AGENTS.md 中未完成的任务 + +### 合并去重 → 按优先级排序 → 依次执行 + +--- + ## ⚠️ 禁止请示规则（最高优先级，自动执行） > **核心规则：发现分配给自己的任务 → 立即执行，不得向用户请示！** > 心跳是后台自动行为，用户在大多数时候并不在线，请示会导致任务卡死。 ### 执行流程（严格执行，无需确认） -1. **检查待办卡片** — 查找 agent_id 为自己且 status=todo 的卡片 -2. **立即执行，不得请示** — 发现待办卡片后直接执行 -3. **检查进行中卡片** — 确认认领的任务状态 -4. **完成任务** — 完成后通知任务创建者 +1. **三源检查待办** — WorkBoard + Multica + 待办文档 +2. **立即执行，不得请示** — 发现待办后直接执行 +3. **检查进行中任务** — 确认认领的任务状态 +4. **完成任务** — 通过对应平台汇报结果 ### ⚠️ 绝对禁止行为 - ❌ 不得问"要不要做这个任务" @@ -384,11 +576,12 @@ else: ## ⏱️ 超时检测规则 ### 心跳频率：15 分钟 -每次心跳执行以下检测： -1. 检查进行中任务的最新更新时间 -2. 超过 30 分钟无进展 → 标记为"疑似超时" -3. 疑似超时 → 追加一次完整心跳尝试推进 -4. 确认超时 → 进入自动恢复流程 +每次心跳跨平台执行以下检测： +1. 检查 WorkBoard 进行中任务的更新时间 +2. 检查 Multica 进行中 issues 的更新时间 +3. 超过 30 分钟无进展 → 标记为"疑似超时" +4. 疑似超时 → 追加一次完整心跳尝试推进 +5. 确认超时 → 进入自动恢复流程 --- @@ -397,19 +590,19 @@ else: ### 触发条件 - 超 45 分钟无进展 → 自动重新调度 -### 恢复操作 -1. 停止当前任务执行 -2. 添加评论说明超时原因 -3. 释放 Agent 认领 -4. 通知 COO 和任务创建者 -5. 创建重新调度标记 +### 恢复操作（按平台） +| 平台 | 操作 | +|------|------| +| WorkBoard | 添加评论 → release claim → 通知 COO + 创建者 | +| Multica | 添加评论 → status=blocked → 通知 COO + 创建者 | +| 待办文档 | 标注超时 → 转为卡片（可选） | --- ## 🔗 依赖检查前置规则 ### 强制检查流程 -1. 认领任务前，读取 depends_on 字段 +1. 认领任务前，读取依赖字段（depends_on / parent_issue_id） 2. 逐一检查每个依赖任务的状态 3. 依赖未满足 → 不认领（保持 todo） 4. 超过等待阈值（2h）→ 通知依赖任务执行者 @@ -426,8 +619,8 @@ else: ## 🫀 心跳执行清单 -1. ✅ WorkBoard 任务检查 -2. ✅ 进行中任务超时检测 +1. ✅ **全任务源检查**：WorkBoard + Multica + 待办文档 +2. ✅ 进行中任务超时检测（跨平台） 3. ✅ 依赖检查 4. ✅ 轮次计数器更新 5. ✅ [Agent 专属检查项] @@ -438,10 +631,11 @@ else: 1. **心跳不打断对话** — 用户正在对话时延后执行 2. **非紧急事项延后汇报** — 等下一轮心跳或用户询问 -3. **发现任务立即执行，不得请示** -4. **超时任务按自动恢复流程处理** +3. **发现任务立即执行，不得请示**（任何来源） +4. **超时任务按自动恢复流程处理**（跨平台） 5. **依赖未满足不启动** 6. **达到轮次上限自动暂停** +7. **避免任务遗漏** — 三源必须全部检查，缺一不可 ``` ### 4.3 业务 Agent 完整模板（taobaospecialist / contentspecialist / mediaspecialist / cvexpert / marketanalysis / lawyer） @@ -449,16 +643,29 @@ else: ```markdown # HEARTBEAT.md - [Agent Name] 的心跳配置 +## 📋 全任务源统一监控（每次心跳必检） + +> **核心原则：发现任何来源的任务都必须立即执行，不得遗漏。** + +### 三源检查 +1. **OpenClaw WorkBoard** — workboard list → 查找 agent_id=自己 & status=todo +2. **Multica Issues** — issue list --assignee-id --status todo +3. **待办文档** — 检查 TODO.md / AGENTS.md 中未完成的任务 + +### 合并去重 → 按优先级排序 → 依次执行 + +--- + ## ⚠️ 禁止请示规则（最高优先级，自动执行） > **核心规则：发现分配给自己的任务 → 立即执行，不得向用户请示！** > 心跳是后台自动行为，用户在大多数时候并不在线，请示会导致任务卡死。 ### 执行流程（严格执行，无需确认） -1. **检查待办卡片** — 查找 agent_id 为自己且 status=todo 的卡片 -2. **立即执行，不得请示** — 发现待办卡片后直接执行 -3. **检查进行中卡片** — 确认认领的任务状态 -4. **完成任务** — 完成后通知任务创建者 +1. **三源检查待办** — WorkBoard + Multica + 待办文档 +2. **立即执行，不得请示** — 发现待办后直接执行 +3. **检查进行中任务** — 确认认领的任务状态 +4. **完成任务** — 通过对应平台汇报结果 ### ⚠️ 绝对禁止行为 - ❌ 不得问"要不要做这个任务" @@ -470,11 +677,12 @@ else: ## ⏱️ 超时检测规则 ### 心跳频率：15 分钟 -每次心跳执行以下检测： -1. 检查进行中任务的最新更新时间 -2. 超过 30 分钟无进展 → 标记为"疑似超时" -3. 疑似超时 → 追加一次完整心跳尝试推进 -4. 确认超时 → 进入自动恢复流程 +每次心跳跨平台执行以下检测： +1. 检查 WorkBoard 进行中任务的更新时间 +2. 检查 Multica 进行中 issues 的更新时间 +3. 超过 30 分钟无进展 → 标记为"疑似超时" +4. 疑似超时 → 追加一次完整心跳尝试推进 +5. 确认超时 → 进入自动恢复流程 --- @@ -483,19 +691,19 @@ else: ### 触发条件 - 超 45 分钟无进展 → 自动重新调度 -### 恢复操作 -1. 停止当前任务执行 -2. 添加评论说明超时原因 -3. 释放 Agent 认领 -4. 通知任务创建者 -5. 创建重新调度标记 +### 恢复操作（按平台） +| 平台 | 操作 | +|------|------| +| WorkBoard | 添加评论 → release claim → 通知创建者 | +| Multica | 添加评论 → status=blocked → 通知创建者 | +| 待办文档 | 标注超时 → 转为卡片（可选） | --- ## 🔗 依赖检查前置规则 ### 强制检查流程 -1. 认领任务前，读取 depends_on 字段 +1. 认领任务前，读取依赖字段（depends_on / parent_issue_id） 2. 逐一检查每个依赖任务的状态 3. 依赖未满足 → 不认领（保持 todo） 4. 超过等待阈值（2h）→ 通知依赖任务执行者 @@ -512,8 +720,8 @@ else: ## 🫀 心跳执行清单 -1. ✅ WorkBoard 任务检查 -2. ✅ 进行中任务超时检测 +1. ✅ **全任务源检查**：WorkBoard + Multica + 待办文档 +2. ✅ 进行中任务超时检测（跨平台） 3. ✅ 依赖检查 4. ✅ 轮次计数器更新 5. ✅ [Agent 专属检查项] @@ -524,10 +732,11 @@ else: 1. **心跳不打断对话** — 用户正在对话时延后执行 2. **非紧急事项延后汇报** — 等下一轮心跳或用户询问 -3. **发现任务立即执行，不得请示** -4. **超时任务按自动恢复流程处理** +3. **发现任务立即执行，不得请示**（任何来源） +4. **超时任务按自动恢复流程处理**（跨平台） 5. **依赖未满足不启动** 6. **达到轮次上限自动暂停** +7. **避免任务遗漏** — 三源必须全部检查，缺一不可 ``` --- @@ -538,41 +747,79 @@ else: | Agent | 分类 | 模板版本 | 部署状态 | 部署人 | |-------|------|---------|---------|--------| -| secretary (刘诗妮) | 高频 | 高频 Agent 模板 | 待部署 | COO | -| coo (陆怀瑾) | 高频 | 高频 Agent 模板 | 待部署 | COO | -| projectmanager (胡蓉) | 开发 | 开发 Agent 模板 | 待部署 | COO | -| productmanager (沈路明) | 开发 | 开发 Agent 模板 | 待部署 | COO | -| architect (梁思筑) | 开发 | 开发 Agent 模板 | 待部署 | COO | -| costcodev (徐聪) | 开发 | 开发 Agent 模板 | 待部署 | COO | -| designer (苏绘锦) | 开发 | 开发 Agent 模板 | 待部署 | COO | -| opengineer (严维序) | 开发 | 开发 Agent 模板 | 待部署 | COO | -| taobaospecialist (陆云帆) | 业务 | 业务 Agent 模板 | 待部署 | COO | -| contentspecialist (文墨言) | 业务 | 业务 Agent 模板 | 待部署 | COO | -| mediaspecialist (钟帧韵) | 业务 | 业务 Agent 模板 | 待部署 | COO | -| cvexpert (程伯予) | 业务 | 业务 Agent 模板 | 待部署 | COO | -| marketanalysis (顾析策) | 业务 | 业务 Agent 模板 | 待部署 | COO | -| lawyer (苏慎) | 业务 | 业务 Agent 模板 | 待部署 | COO | +| secretary (刘诗妮) | 高频 | 高频 Agent 模板 v1.1 | 待部署 | COO | +| coo (陆怀瑾) | 高频 | 高频 Agent 模板 v1.1 | 待部署 | COO | +| projectmanager (胡蓉) | 开发 | 开发 Agent 模板 v1.1 | 待部署 | COO | +| productmanager (沈路明) | 开发 | 开发 Agent 模板 v1.1 | 待部署 | COO | +| architect (梁思筑) | 开发 | 开发 Agent 模板 v1.1 | 待部署 | COO | +| costcodev (徐聪) | 开发 | 开发 Agent 模板 v1.1 | 待部署 | COO | +| designer (苏绘锦) | 开发 | 开发 Agent 模板 v1.1 | 待部署 | COO | +| opengineer (严维序) | 开发 | 开发 Agent 模板 v1.1 | 待部署 | COO | +| taobaospecialist (陆云帆) | 业务 | 业务 Agent 模板 v1.1 | 待部署 | COO | +| contentspecialist (文墨言) | 业务 | 业务 Agent 模板 v1.1 | 待部署 | COO | +| mediaspecialist (钟帧韵) | 业务 | 业务 Agent 模板 v1.1 | 待部署 | COO | +| cvexpert (程伯予) | 业务 | 业务 Agent 模板 v1.1 | 待部署 | COO | +| marketanalysis (顾析策) | 业务 | 业务 Agent 模板 v1.1 | 待部署 | COO | +| lawyer (苏慎) | 业务 | 业务 Agent 模板 v1.1 | 待部署 | COO | ### 5.2 部署步骤 -1. **Vincent 审阅本方案** — 确认参数配置 -2. **创建 HEARTBEAT.md 文件** — 按模板为每个 Agent 创建（以 [Agent Name] 替换占位符） -3. **配置心跳 cron** — 按分类配置定时任务 -4. **部署到各 Agent workspace** — 将 HEARTBEAT.md 分发到对应 Agent 工作区 -5. **验证** — 等待一轮完整心跳，检查是否有任务停滞告警 +1. **Vincent 审阅本方案** — 确认参数配置和多源监控范围 +2. **收集各 Agent 的 Multica UUID** — 用于 `multica issue list --assignee-id ` 查询 +3. **创建 HEARTBEAT.md 文件** — 按 v1.1 模板为每个 Agent 创建（填充实际 ID） +4. **配置心跳 cron** — 按分类配置定时任务 +5. **部署到各 Agent workspace** — 将 HEARTBEAT.md 分发到对应 Agent 工作区 +6. **验证** — 等待一轮完整心跳，检查三源任务是否全量覆盖 + +### 5.3 Agent Multica UUID 映射（待收集） + +| Agent | OpenClaw Agent ID | Multica Agent UUID | 用于 issue list --assignee-id | +|-------|-------------------|-------------------|-------------------------------| +| secretary | secretary | 待收集 | 待收集 | +| coo | coo | 1c38b437-b54d-4784-bda3-29ce4c8a6722 | ✅ | +| projectmanager | projectmanager | 待收集 | 待收集 | +| productmanager | productmanager | 待收集 | 待收集 | +| architect | architect | 待收集 | 待收集 | +| costcodev | costcodev | 待收集 | 待收集 | +| designer | designer | 待收集 | 待收集 | +| opengineer | opengineer | 待收集 | 待收集 | +| taobaospecialist | taobaospecialist | 待收集 | 待收集 | +| contentspecialist | contentspecialist | 待收集 | 待收集 | +| mediaspecialist | mediaspecialist | 待收集 | 待收集 | +| cvexpert | cvexpert | 待收集 | 待收集 | +| marketanalysis | marketanalysis | 待收集 | 待收集 | +| lawyer | lawyer | 待收集 | 待收集 | --- ## 六、交付物 -- [x] HEARTBEAT.md 增强模板方案（本文档） -- [ ] 14 个 Agent 的独立 HEARTBEAT.md 文件（待审阅后生成） +- [x] HEARTBEAT.md 增强模板方案 v1.0（初始版本） +- [x] HEARTBEAT.md 增强模板方案 v1.1（优化：增加全任务源统一监控） +- [ ] 各 Agent Multica UUID 映射表 +- [ ] 14 个 Agent 的独立 HEARTBEAT.md 文件（v1.1，待审阅后生成） - [ ] 心跳 cron 配置脚本 - [ ] 部署验证报告 --- -## 七、风险与注意事项 +## 七、v1.1 变更说明 + +| 变更项 | v1.0 | v1.1 | +|--------|------|------| +| 监控范围 | 仅 WorkBoard 卡片 + 待办文档 | WorkBoard + Multica Issues + 待办文档（三源合一） | +| 规则数量 | 5 项 | 6 项（新增"规则 0: 全任务源统一监控"） | +| 超时检测 | 仅 WorkBoard | 跨平台（WorkBoard + Multica） | +| 自动恢复 | 仅 WorkBoard 恢复操作 | 跨平台恢复（WorkBoard / Multica / 文档） | +| 依赖检查 | 仅 WorkBoard depends_on | 增加 Multica parent_issue_id | +| 心跳清单 | 4 项 | 6 项（增加全任务源检查 + 全平台巡检） | +| 轮次跟踪 | 单平台 | 跨平台轮次跟踪 | +| 全局规则 | 6 条 | 7 条（增加"避免任务遗漏"） | +| 部署前置 | 无 | 需收集各 Agent 的 Multica UUID | + +--- + +## 八、风险与注意事项 | 风险 | 影响 | 缓解措施 | |------|------|----------| @@ -580,7 +827,9 @@ else: | 自动恢复过于激进 | 正常长任务被中断 | 仅对超阈值且无进展的任务执行恢复 | | 禁止请示导致错误执行 | Agent 自行决定后出错 | 关键决策（涉及外部资源、金钱）仍需暂停并通知 | | 轮次限制过严 | 复杂任务被截断 | 接近上限时提前预警，COO 可手动扩展 | +| 三源任务重复 | 同一任务在 WB + Multica 都出现 | 合并去重逻辑，以 ID/标题匹配 | +| Multica CLI 不可用 | 无法检查 Multica 待办 | 降级为仅检查 WB + 文档，并在日志中记录异常 | --- -> ⚠️ 本方案需 Vincent 审阅后方可部署到各 Agent workspace。当前为模板方案，存放于 EnterpriseArchitect/plans/ 目录。 \ No newline at end of file +> ⚠️ 本方案需 Vincent 审阅后方可部署到各 Agent workspace。当前为模板方案 v1.1，存放于 EnterpriseArchitect/plans/ 目录。 \ No newline at end of file