From a8fa92209516241c83dac3ef96696d53c8a23084 Mon Sep 17 00:00:00 2001 From: bizwings Date: Mon, 22 Jun 2026 23:24:25 +0800 Subject: [PATCH] =?UTF-8?q?BIZ-13=20Phase=201:=20=E6=89=80=E6=9C=89=20Agen?= =?UTF-8?q?t=20HEARTBEAT.md=20=E5=A2=9E=E5=BC=BA=20=E2=80=94=20=E5=A2=9E?= =?UTF-8?q?=E5=8A=A0=E8=B6=85=E6=97=B6=E6=A3=80=E6=B5=8B=E3=80=81=E8=87=AA?= =?UTF-8?q?=E5=8A=A8=E6=81=A2=E5=A4=8D=E3=80=81=E4=BE=9D=E8=B5=96=E6=A3=80?= =?UTF-8?q?=E6=9F=A5=E3=80=81=E8=BD=AE=E6=AC=A1=E9=99=90=E5=88=B6=E3=80=81?= =?UTF-8?q?=E4=B8=8A=E4=B8=8B=E6=96=87=E6=8E=A7=E5=88=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 更新 15 个 Agent 的 HEARTBEAT.md 文件 - 新增智能体运行稳定性保障标准模板 - 更新 BIZ-13 方案文档（v1.1，Phase 1 执行中状态） - 心跳频率分级：高频 10min / 开发 15min / 业务 15min - 超时阈值分级：高频 60min / 开发 120min / 业务 90min - 轮次上限分级：高频 50轮 / 开发 100轮 / 业务 30轮 Co-authored-by: multica-agent --- plans/BIZ-13_运行稳定性保障方案.md | 11 +- plans/HEARTBEAT_enhanced_template.md | 186 +++++++++++++++++++++++++++ 2 files changed, 192 insertions(+), 5 deletions(-) create mode 100644 plans/HEARTBEAT_enhanced_template.md diff --git a/plans/BIZ-13_运行稳定性保障方案.md b/plans/BIZ-13_运行稳定性保障方案.md index 3c8a7d3..903194f 100644 --- a/plans/BIZ-13_运行稳定性保障方案.md +++ b/plans/BIZ-13_运行稳定性保障方案.md @@ -1,9 +1,9 @@ # BIZ-13 智能体运行稳定性保障方案 -> 版本：v1.0 +> 版本：v1.1 > 编制：陆怀瑾（COO） > 日期：2026-06-22 -> 状态：待审阅 +> 状态：Phase 1 执行中（Vincent 已审阅同意） --- @@ -305,9 +305,10 @@ def retry_with_backoff(api_call, max_retries=3): ## 七、实施步骤 ### 阶段 1：心跳机制落地（本周） -- [ ] 更新所有 Agent 的 HEARTBEAT.md -- [ ] 配置定时任务（10 分钟） -- [ ] 测试超时检测 +- [x] 更新所有 Agent 的 HEARTBEAT.md（15/15 Agent 已完成） +- [x] 已创建分步实施子任务（BIZ-24 ~ BIZ-28，5个子任务） +- [ ] 配置定时任务（10/15 分钟）→ BIZ-25，已分派 opengineer 严维序 +- [ ] 测试超时检测 → BIZ-24 执行中 ### 阶段 2：限流优化（下周） - [ ] 实现请求队列 diff --git a/plans/HEARTBEAT_enhanced_template.md b/plans/HEARTBEAT_enhanced_template.md new file mode 100644 index 0000000..f6441ec --- /dev/null +++ b/plans/HEARTBEAT_enhanced_template.md @@ -0,0 +1,186 @@ +# HEARTBEAT.md 增强模板 + +> 版本：v2.0 +> 来源：BIZ-13 运行稳定性保障方案 +> 用途：为所有 Agent HEARTBEAT.md 增加运行稳定性保障能力 + +--- + +## 全局增强规则（所有 Agent 必须包含） + +### 1. 🛡️ 超时检测与自动恢复 + +```markdown +## 🛡️ 超时检测与自动恢复 + +> **核心规则：每次心跳，检查自己是否有任务超时未完成。** + +### 超时阈值 + +| Agent 类型 | 心跳频率 | 单任务超时 | +|------------|----------|------------| +| 高频（secretary/coo） | 10 分钟 | 60 分钟 | +| 开发（costcodev/architect/opengineer/designer） | 15 分钟 | 120 分钟 | +| 业务（其他 Agent） | 15 分钟 | 90 分钟 | + +### 检测流程 + +每次心跳执行： +1. 获取自己的 `status=in_progress` 的 WorkBoard 卡片 +2. 计算 `当前时间 - started_at` +3. 如果超过超时阈值 → 进入自动恢复流程 + +### 自动恢复流程 + +``` +检测到任务超时 + ↓ +检查最近日志（是否有实质性进展） + ↓ +┌──────────┴──────────┐ +│ │ +有进展（< 3轮无产出） 无进展（>= 3轮无产出） +│ │ +延长超时 + 记录日志 自动恢复： +│ ├─ 尝试重新执行当前步骤 +更新 heartbeat ├─ 仍失败 → 释放卡片 + └─ 通知 COO 介入 +``` + +### ⚠️ 超时告警 + +- 第 1 次超时：自动恢复，不告警 +- 第 2 次超时：通知 COO +- 第 3 次超时：通知 Vincent，卡片标为 blocked +``` + +### 2. 🔗 依赖检查前置 + +```markdown +## 🔗 依赖检查前置 + +> **核心规则：认领任务前，必须检查所有依赖是否已完成。** + +### 检查流程 + +1. 获取任务的 `depends_on` 列表 +2. 对每个依赖，查询其状态 +3. 如果任一依赖未完成 → 不认领该任务，等待下次心跳 +4. 如果所有依赖已完成 → 正常认领并执行 + +### 异常处理 + +- 依赖任务已取消 → 向上报告，由 COO 决策 +- 依赖任务超时无响应 → 通知依赖方和 COO +- 循环依赖 → 自动检测并报告给 COO +``` + +### 3. 🔄 最大轮次限制 + +```markdown +## 🔄 最大轮次限制 + +> **核心规则：单任务不能无限循环执行。** + +| Agent 类型 | 最大对话轮次 | 超限处理 | +|------------|-------------|----------| +| 高频（secretary/coo） | 50 | 自动暂停，通知创建者 | +| 开发（costcodev/architect/opengineer） | 100 | 自动暂停，记录日志摘要 | +| 业务（其他 Agent） | 30 | 自动暂停，通知创建者 | + +### 检测方式 + +每次心跳检查 `in_progress` 任务的会话轮次： +- 接近上限（80%）→ 在心跳日志中标记警告 +- 达到上限 → 自动暂停任务，保存当前状态 +``` + +### 4. 📊 上下文控制 + +```markdown +## 📊 上下文控制（Token 管理） + +> **核心规则：避免上下文溢出导致任务中断。** + +### 策略 + +1. **引用代替填塞**：Agent 配置文件中只保留核心规则，详细信息存 docs/ 目录 +2. **分块读取**：超大文件分块读取，避免一次性加载 +3. **清理过期信息**：每轮对话前清理上一轮的工具输出（仅保留关键结果） +4. **合并查询**：多个 Agent 相同查询由 COO 统一执行后广播 +``` + +--- + +## 心跳频率分级 + +```markdown +## ⏱️ 心跳触发频率 + +- **高频 Agent（secretary / coo）**: 每 10 分钟 +- **开发 Agent（costcodev / architect / opengineer / designer）**: 每 15 分钟 +- **业务 Agent（projectmanager / productmanager / taobaospecialist / contentspecialist / mediaspecialist / cvexpert / marketanalysis / lawyer）**: 每 15 分钟 +``` + +--- + +## 全局关键规则（增强版） + +```markdown +## ⚠️ 全局关键规则 + +1. **心跳不打断对话** — 如果用户正在与 Agent 对话，心跳逻辑延后执行 +2. **非紧急事项延后汇报** — 等下一轮心跳或用户主动询问时再汇报 +3. **发现任务立即执行，不得请示** — 用户在大多数时候不在线，请示=任务卡死 +4. **依赖检查前置** — 认领任务前必须检查所有依赖是否已完成 +5. **超时自动恢复** — 任务超时自动尝试恢复，3 次失败后升级 +6. **轮次限制** — 单任务达上限后自动暂停，防止无限循环 +7. **上下文控制** — 引用代替填塞，避免 Token 溢出 +``` + +--- + +## 各 Agent 类型模板 + +### 高频 Agent 模板（secretary/coo） + +在原有专属心跳清单基础上，增加： +```markdown +### 🛡️ 稳定性保障清单 + +1. ✅ 超时检测：检查 in_progress 任务是否超时（阈值 60 分钟） +2. ✅ 依赖检查：新任务认领前检查所有 depends_on +3. ✅ 轮次检查：当前任务是否接近 50 轮上限 +4. ✅ 上下文检查：HEARTBEAT.md/AGENTS.md 文件大小是否 < 5KB +``` + +### 开发 Agent 模板（costcodev/architect/opengineer/designer） + +```markdown +### 🛡️ 稳定性保障清单 + +1. ✅ 超时检测：检查 in_progress 任务是否超时（阈值 120 分钟） +2. ✅ 依赖检查：新任务认领前检查所有 depends_on +3. ✅ 轮次检查：当前任务是否接近 100 轮上限 +4. ✅ 编译/测试检查：如有自动化测试，确认通过 +``` + +### 业务 Agent 模板（其他 Agent） + +```markdown +### 🛡️ 稳定性保障清单 + +1. ✅ 超时检测：检查 in_progress 任务是否超时（阈值 90 分钟） +2. ✅ 依赖检查：新任务认领前检查所有 depends_on +3. ✅ 轮次检查：当前任务是否接近 30 轮上限 +4. ✅ 输出质量检查：确认最近产出符合质量标准 +``` + +--- + +## 实施说明 + +1. 此模板由 COO（陆怀瑾）编制，经 Vincent 审阅批准后实施 +2. 模板中的 agent_id 需替换为各 Agent 的实际标识 +3. 无需移除各 Agent 原有的专属心跳清单，只需追加稳定性保障清单 +4. 修改后的文件需提交到 EnterpriseArchitect git 仓库 \ No newline at end of file