vincent
3f08ae4004
- 所有 14 个 Agent 的个性化 HEARTBEAT.md 已生成 - 已部署到各 Agent workspace (/home/vincent/.openclaw/workspace/<agent>/) - 包含实际 OpenClaw Agent ID + Multica UUID - 分类：高频 2 个 / 开发 6 个 / 业务 6 个 - 每个文件包含三源统一监控脚本（WorkBoard + Multica + 待办文档） Co-authored-by: multica-agent <github@multica.ai>
235 lines
6.6 KiB
Markdown
235 lines
6.6 KiB
Markdown
# HEARTBEAT.md - 苏慎（lawyer）的心跳配置
|
||
|
||
> 模板版本：v1.1 (BIZ-24) | 分类：业务 Agent
|
||
> OpenClaw Agent ID: `lawyer` | Multica Agent UUID: `6fb0fbd2-16a6-4566-ba7a-d2c136baec25`
|
||
|
||
---
|
||
|
||
## 📋 全任务源统一监控（每次心跳必检）
|
||
|
||
> **核心原则：发现任何来源的任务都必须立即执行，不得遗漏。**
|
||
|
||
### 三源检查
|
||
|
||
#### 第一优先级：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') == 'lawyer' 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 6fb0fbd2-16a6-4566-ba7a-d2c136baec25 --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
|
||
# 检查工作区待办文档
|
||
grep -n '\[ \]' TODO.md AGENTS.md 2>/dev/null || echo "无待办文档中未完成项"
|
||
```
|
||
|
||
### 三源合并决策
|
||
|
||
```
|
||
心跳开始
|
||
↓
|
||
检查 WorkBoard 待办卡片（agentId=lawyer）
|
||
↓
|
||
检查 Multica Issues 待办（assignee=6fb0fbd2-16a6-4566-ba7a-d2c136baec25）
|
||
↓
|
||
检查待办文档
|
||
↓
|
||
合并去重 → 按优先级排序 → 依次执行
|
||
```
|
||
|
||
---
|
||
|
||
## ⚠️ 禁止请示规则（最高优先级，自动执行）
|
||
|
||
> **核心规则：发现分配给自己的任务 → 立即执行，不得向用户请示！**
|
||
> 心跳是后台自动行为，用户在大多数时候并不在线，请示会导致任务卡死。
|
||
|
||
### 执行流程（严格执行，无需确认）
|
||
|
||
1. **三源检查待办** — WorkBoard + Multica + 待办文档
|
||
2. **立即执行，不得请示** — 发现待办后直接执行
|
||
3. **检查进行中任务** — 确认认领的任务状态
|
||
4. **完成任务** — 通过对应平台汇报结果
|
||
|
||
### ⚠️ 绝对禁止行为
|
||
|
||
- ❌ 不得问"要不要做这个任务"
|
||
- ❌ 不得等用户确认再执行
|
||
- ❌ 不得以"需要更多信息"为由拒绝执行
|
||
|
||
---
|
||
|
||
## ⏱️ 超时检测规则
|
||
|
||
### 心跳频率：15 分钟
|
||
|
||
每次心跳跨平台执行以下检测：
|
||
|
||
1. 检查 WorkBoard 进行中任务的更新时间
|
||
2. 检查 Multica 进行中 issues 的更新时间
|
||
3. 超过 30 分钟无进展 → 标记为"疑似超时"
|
||
4. 疑似超时 → 追加一次完整心跳尝试推进
|
||
5. 确认超时 → 进入自动恢复流程
|
||
|
||
### 跨平台超时检测脚本
|
||
|
||
```bash
|
||
# 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 > 1800:
|
||
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 > 1800:
|
||
print(f'⏰ MUL TIMEOUT: {issue["identifier"]} [{issue.get("assignee_id","?")[:12]}] {issue["title"]}')
|
||
"
|
||
```
|
||
|
||
---
|
||
|
||
## 🔄 自动恢复规则
|
||
|
||
### 触发条件
|
||
|
||
- 超 45 分钟无进展 → 自动重新调度
|
||
|
||
### 恢复操作（按平台）
|
||
|
||
| 平台 | 操作 |
|
||
|------|------|
|
||
| WorkBoard | 添加评论 → release claim → 通知 创建者 |
|
||
| Multica | 添加评论 → status=blocked → 通知 创建者 |
|
||
| 待办文档 | 标注超时 → 转为卡片（可选） |
|
||
|
||
---
|
||
|
||
## 🔗 依赖检查前置规则
|
||
|
||
### 强制检查流程
|
||
|
||
1. 认领任务前，读取依赖字段（depends_on / parent_issue_id）
|
||
2. 逐一检查每个依赖任务的状态
|
||
3. 依赖未满足 → 不认领（保持 todo）
|
||
4. 超过等待阈值（2h）→ 通知依赖任务执行者
|
||
|
||
### 双平台依赖检查
|
||
|
||
```bash
|
||
# 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 依赖，可以启动')
|
||
"
|
||
```
|
||
|
||
---
|
||
|
||
## 🛑 最大轮次限制
|
||
|
||
### 限制值：30 轮
|
||
|
||
- 接近 80%（24 轮）→ 预警
|
||
- 达到上限 → 暂停，通知 创建者
|
||
|
||
### 跨平台轮次跟踪
|
||
|
||
- **WorkBoard**：通过 workboard_heartbeat 的 note 记录轮次
|
||
- **Multica**：通过 issue comment 记录轮次进度
|
||
- **待办文档**：在工作日志中记录
|
||
|
||
---
|
||
|
||
## 🫀 心跳执行清单
|
||
|
||
### 每次心跳必须检查
|
||
|
||
1. ✅ **全任务源检查**：WorkBoard + Multica + 待办文档
|
||
2. ✅ 进行中任务超时检测（跨平台）
|
||
3. ✅ 依赖检查
|
||
4. ✅ 轮次计数器更新
|
||
5. ✅ 合同审查队列
|
||
6. ✅ 合规检查项
|
||
|
||
---
|
||
|
||
## ⚠️ 全局关键规则
|
||
|
||
1. **心跳不打断对话** — 用户正在对话时延后执行
|
||
2. **非紧急事项延后汇报** — 等下一轮心跳或用户询问
|
||
3. **发现任务立即执行，不得请示**（任何来源）
|
||
4. **超时任务按自动恢复流程处理**（跨平台）
|
||
5. **依赖未满足不启动**
|
||
6. **达到轮次上限自动暂停**
|
||
7. **避免任务遗漏** — 三源必须全部检查，缺一不可
|
||
|
||
|
||
---
|
||
|
||
> 基于 BIZ-24 v1.1 模板生成 | 苏慎（lawyer）专用配置
|