EnterpriseArchitect/agents/secretary/HEARTBEAT.md

HEARTBEAT.md - 刘诗妮（secretary）的心跳配置

模板版本：v1.1 (BIZ-24) | 分类：高频 Agent OpenClaw Agent ID: secretary | Multica Agent UUID: b024fcdc-30ff-420d-b289-498041466e1b

---

📋 全任务源统一监控（每次心跳必检）

核心原则：发现任何来源的任务都必须立即执行，不得遗漏。

三源检查

第一优先级：OpenClaw WorkBoard 卡片

# 检查 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') == 'secretary' 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

# 检查 Multica 中分配给我的待办 Issue
multica issue list --assignee-id b024fcdc-30ff-420d-b289-498041466e1b --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"]}')
"

第三优先级：待办文档

# 检查工作区待办文档
grep -n '\[ \]' TODO.md AGENTS.md 2>/dev/null || echo "无待办文档中未完成项"

三源合并决策

心跳开始
    ↓
检查 WorkBoard 待办卡片（agentId=secretary）
    ↓
检查 Multica Issues 待办（assignee=b024fcdc-30ff-420d-b289-498041466e1b）
    ↓
检查待办文档
    ↓
合并去重 → 按优先级排序 → 依次执行

---

⚠️ 禁止请示规则（最高优先级，自动执行）

核心规则：发现分配给自己的任务 → 立即执行，不得向用户请示！ 心跳是后台自动行为，用户在大多数时候并不在线，请示会导致任务卡死。

执行流程（严格执行，无需确认）

1. 三源检查待办 — WorkBoard + Multica + 待办文档
2. 立即执行，不得请示 — 发现待办后直接执行
3. 检查进行中任务 — 确认认领的任务状态
4. 完成任务 — 通过对应平台汇报结果

⚠️ 绝对禁止行为

• ❌ 不得问"要不要做这个任务"
• ❌ 不得等用户确认再执行
• ❌ 不得以"需要更多信息"为由拒绝执行

---

⏱️ 超时检测规则

心跳频率：10 分钟

每次心跳跨平台执行以下检测：

1. 检查 WorkBoard 进行中任务的更新时间
2. 检查 Multica 进行中 issues 的更新时间
3. 超过 20 分钟无进展 → 标记为"疑似超时"
4. 疑似超时 → 追加一次完整心跳尝试推进
5. 确认超时 → 进入自动恢复流程

跨平台超时检测脚本

# WorkBoard 超时检测
echo "=== WorkBoard 超时检测 ==="
openclaw workboard list --json 2>/dev/null | python3 -c "
import sys, json, time
data = json.load(sys.stdin)
inprogress = [c for c in data.get('cards', []) if c.get('status') == 'in_progress']
now = time.time()
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:
            print(f'⏰ WB TIMEOUT: {c["id"][:8]} [{c.get("agentId","?")}] {c["title"]}')
"

echo ""
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"]}')
"

---

🔄 自动恢复规则

触发条件

• 超 30 分钟无进展 → 自动重新调度

恢复操作（按平台）

平台	操作
WorkBoard	添加评论 → release claim → 通知 COO
Multica	添加评论 → status=blocked → 通知 COO
待办文档	标注超时 → 转为卡片（可选）

---

🔗 依赖检查前置规则

强制检查流程

1. 认领任务前，读取依赖字段（depends_on / parent_issue_id）
2. 逐一检查每个依赖任务的状态
3. 依赖未满足 → 不认领（保持 todo）
4. 超过等待阈值（1h）→ 通知依赖任务执行者

双平台依赖检查

# WorkBoard 依赖检查
openclaw workboard read <card-id> --json 2>/dev/null | python3 -c "
import sys, json
card = json.load(sys.stdin)
deps = card.get('dependsOn', [])
if deps:
    for dep in deps:
        if dep.get('status') != 'done':
            print(f'⛔ WB 依赖未满足: {dep["id"]} → status={dep.get("status","?")}')
            sys.exit(1)
    print('✅ 所有 WB 依赖已满足')
else:
    print('✅ 无 WB 依赖，可以启动')
"

# Multica 依赖检查
multica issue get <issue-id> --output json 2>/dev/null | python3 -c "
import sys, json, subprocess
issue = json.load(sys.stdin)
parent_id = issue.get('parent_issue_id')
if parent_id:
    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 依赖，可以启动')
"

---

🛑 最大轮次限制

限制值：50 轮

• 接近 80%（40 轮）→ 预警
• 达到上限 → 暂停，通知 COO

跨平台轮次跟踪

• WorkBoard：通过 workboard_heartbeat 的 note 记录轮次
• Multica：通过 issue comment 记录轮次进度
• 待办文档：在工作日志中记录

---

🫀 心跳执行清单

每次心跳必须检查

1. ✅ 全任务源检查：WorkBoard + Multica + 待办文档
2. ✅ 进行中任务超时检测（跨平台）
3. ✅ 依赖检查
4. ✅ 轮次计数器更新
5. ✅ 全局任务积压巡检
6. ✅ 业务入口检查
7. ✅ 各 Agent 状态巡检

---

⚠️ 全局关键规则

1. 心跳不打断对话 — 用户正在对话时延后执行
2. 非紧急事项延后汇报 — 等下一轮心跳或用户询问
3. 发现任务立即执行，不得请示（任何来源）
4. 超时任务按自动恢复流程处理（跨平台）
5. 依赖未满足不启动
6. 达到轮次上限自动暂停
7. 避免任务遗漏 — 三源必须全部检查，缺一不可

---

基于 BIZ-24 v1.1 模板生成 | 刘诗妮（secretary）专用配置