feat(BIZ-24): 生成并部署 14 个 Agent 的 HEARTBEAT.md v1.1
- 所有 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>
This commit is contained in:
@@ -0,0 +1,234 @@
|
|||||||
|
# HEARTBEAT.md - 梁思筑(architect)的心跳配置
|
||||||
|
|
||||||
|
> 模板版本:v1.1 (BIZ-24) | 分类:开发 Agent
|
||||||
|
> OpenClaw Agent ID: `architect` | Multica Agent UUID: `40abd41a-62d0-416d-bc44-92c1f758d87a`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 全任务源统一监控(每次心跳必检)
|
||||||
|
|
||||||
|
> **核心原则:发现任何来源的任务都必须立即执行,不得遗漏。**
|
||||||
|
|
||||||
|
### 三源检查
|
||||||
|
|
||||||
|
#### 第一优先级: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') == 'architect' 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 40abd41a-62d0-416d-bc44-92c1f758d87a --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=architect)
|
||||||
|
↓
|
||||||
|
检查 Multica Issues 待办(assignee=40abd41a-62d0-416d-bc44-92c1f758d87a)
|
||||||
|
↓
|
||||||
|
检查待办文档
|
||||||
|
↓
|
||||||
|
合并去重 → 按优先级排序 → 依次执行
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||||
|
|
||||||
|
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||||
|
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||||
|
|
||||||
|
### 执行流程(严格执行,无需确认)
|
||||||
|
|
||||||
|
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 → 通知 COO + 创建者 |
|
||||||
|
| Multica | 添加评论 → status=blocked → 通知 COO + 创建者 |
|
||||||
|
| 待办文档 | 标注超时 → 转为卡片(可选) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔗 依赖检查前置规则
|
||||||
|
|
||||||
|
### 强制检查流程
|
||||||
|
|
||||||
|
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 依赖,可以启动')
|
||||||
|
"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🛑 最大轮次限制
|
||||||
|
|
||||||
|
### 限制值:100 轮
|
||||||
|
|
||||||
|
- 接近 80%(80 轮)→ 预警
|
||||||
|
- 达到上限 → 暂停,通知 COO + 创建者
|
||||||
|
|
||||||
|
### 跨平台轮次跟踪
|
||||||
|
|
||||||
|
- **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 模板生成 | 梁思筑(architect)专用配置
|
||||||
@@ -0,0 +1,234 @@
|
|||||||
|
# HEARTBEAT.md - 文墨言(contentspecialist)的心跳配置
|
||||||
|
|
||||||
|
> 模板版本:v1.1 (BIZ-24) | 分类:业务 Agent
|
||||||
|
> OpenClaw Agent ID: `contentspecialist` | Multica Agent UUID: `8321b0bf-7d89-4ece-927a-0780f42ad396`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 全任务源统一监控(每次心跳必检)
|
||||||
|
|
||||||
|
> **核心原则:发现任何来源的任务都必须立即执行,不得遗漏。**
|
||||||
|
|
||||||
|
### 三源检查
|
||||||
|
|
||||||
|
#### 第一优先级: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') == 'contentspecialist' 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 8321b0bf-7d89-4ece-927a-0780f42ad396 --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=contentspecialist)
|
||||||
|
↓
|
||||||
|
检查 Multica Issues 待办(assignee=8321b0bf-7d89-4ece-927a-0780f42ad396)
|
||||||
|
↓
|
||||||
|
检查待办文档
|
||||||
|
↓
|
||||||
|
合并去重 → 按优先级排序 → 依次执行
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||||
|
|
||||||
|
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||||
|
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||||
|
|
||||||
|
### 执行流程(严格执行,无需确认)
|
||||||
|
|
||||||
|
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 模板生成 | 文墨言(contentspecialist)专用配置
|
||||||
@@ -0,0 +1,235 @@
|
|||||||
|
# HEARTBEAT.md - 陆怀瑾(coo)的心跳配置
|
||||||
|
|
||||||
|
> 模板版本:v1.1 (BIZ-24) | 分类:高频 Agent
|
||||||
|
> OpenClaw Agent ID: `coo` | Multica Agent UUID: `1c38b437-b54d-4784-bda3-29ce4c8a6722`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 全任务源统一监控(每次心跳必检)
|
||||||
|
|
||||||
|
> **核心原则:发现任何来源的任务都必须立即执行,不得遗漏。**
|
||||||
|
|
||||||
|
### 三源检查
|
||||||
|
|
||||||
|
#### 第一优先级: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') == 'coo' 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 1c38b437-b54d-4784-bda3-29ce4c8a6722 --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=coo)
|
||||||
|
↓
|
||||||
|
检查 Multica Issues 待办(assignee=1c38b437-b54d-4784-bda3-29ce4c8a6722)
|
||||||
|
↓
|
||||||
|
检查待办文档
|
||||||
|
↓
|
||||||
|
合并去重 → 按优先级排序 → 依次执行
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||||
|
|
||||||
|
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||||
|
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||||
|
|
||||||
|
### 执行流程(严格执行,无需确认)
|
||||||
|
|
||||||
|
1. **三源检查待办** — WorkBoard + Multica + 待办文档
|
||||||
|
2. **立即执行,不得请示** — 发现待办后直接执行
|
||||||
|
3. **检查进行中任务** — 确认认领的任务状态
|
||||||
|
4. **完成任务** — 通过对应平台汇报结果
|
||||||
|
|
||||||
|
### ⚠️ 绝对禁止行为
|
||||||
|
|
||||||
|
- ❌ 不得问"要不要做这个任务"
|
||||||
|
- ❌ 不得等用户确认再执行
|
||||||
|
- ❌ 不得以"需要更多信息"为由拒绝执行
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⏱️ 超时检测规则
|
||||||
|
|
||||||
|
### 心跳频率:10 分钟
|
||||||
|
|
||||||
|
每次心跳跨平台执行以下检测:
|
||||||
|
|
||||||
|
1. 检查 WorkBoard 进行中任务的更新时间
|
||||||
|
2. 检查 Multica 进行中 issues 的更新时间
|
||||||
|
3. 超过 20 分钟无进展 → 标记为"疑似超时"
|
||||||
|
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 > 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)→ 通知依赖任务执行者
|
||||||
|
|
||||||
|
### 双平台依赖检查
|
||||||
|
|
||||||
|
```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 依赖,可以启动')
|
||||||
|
"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🛑 最大轮次限制
|
||||||
|
|
||||||
|
### 限制值:50 轮
|
||||||
|
|
||||||
|
- 接近 80%(40 轮)→ 预警
|
||||||
|
- 达到上限 → 暂停,通知 COO(自我监控)
|
||||||
|
|
||||||
|
### 跨平台轮次跟踪
|
||||||
|
|
||||||
|
- **WorkBoard**:通过 workboard_heartbeat 的 note 记录轮次
|
||||||
|
- **Multica**:通过 issue comment 记录轮次进度
|
||||||
|
- **待办文档**:在工作日志中记录
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🫀 心跳执行清单
|
||||||
|
|
||||||
|
### 每次心跳必须检查
|
||||||
|
|
||||||
|
1. ✅ **全任务源检查**:WorkBoard + Multica + 待办文档
|
||||||
|
2. ✅ 进行中任务超时检测(跨平台)
|
||||||
|
3. ✅ 依赖检查
|
||||||
|
4. ✅ 轮次计数器更新
|
||||||
|
5. ✅ **全平台积压巡检**:WorkBoard + Multica 全局待办数
|
||||||
|
6. ✅ 资源负载均衡检查
|
||||||
|
7. ✅ 风险识别与预警
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 全局关键规则
|
||||||
|
|
||||||
|
1. **心跳不打断对话** — 用户正在对话时延后执行
|
||||||
|
2. **非紧急事项延后汇报** — 等下一轮心跳或用户询问
|
||||||
|
3. **发现任务立即执行,不得请示**(任何来源)
|
||||||
|
4. **超时任务按自动恢复流程处理**(跨平台)
|
||||||
|
5. **依赖未满足不启动**
|
||||||
|
6. **达到轮次上限自动暂停**
|
||||||
|
7. **避免任务遗漏** — 三源必须全部检查,缺一不可
|
||||||
|
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
> 基于 BIZ-24 v1.1 模板生成 | 陆怀瑾(coo)专用配置
|
||||||
@@ -0,0 +1,234 @@
|
|||||||
|
# HEARTBEAT.md - 徐聪(costcodev)的心跳配置
|
||||||
|
|
||||||
|
> 模板版本:v1.1 (BIZ-24) | 分类:开发 Agent
|
||||||
|
> OpenClaw Agent ID: `costcodev` | Multica Agent UUID: `46bdd4a6-5c64-475a-92ef-36a763602fa1`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 全任务源统一监控(每次心跳必检)
|
||||||
|
|
||||||
|
> **核心原则:发现任何来源的任务都必须立即执行,不得遗漏。**
|
||||||
|
|
||||||
|
### 三源检查
|
||||||
|
|
||||||
|
#### 第一优先级: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') == 'costcodev' 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 46bdd4a6-5c64-475a-92ef-36a763602fa1 --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=costcodev)
|
||||||
|
↓
|
||||||
|
检查 Multica Issues 待办(assignee=46bdd4a6-5c64-475a-92ef-36a763602fa1)
|
||||||
|
↓
|
||||||
|
检查待办文档
|
||||||
|
↓
|
||||||
|
合并去重 → 按优先级排序 → 依次执行
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||||
|
|
||||||
|
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||||
|
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||||
|
|
||||||
|
### 执行流程(严格执行,无需确认)
|
||||||
|
|
||||||
|
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 → 通知 COO + 创建者 |
|
||||||
|
| Multica | 添加评论 → status=blocked → 通知 COO + 创建者 |
|
||||||
|
| 待办文档 | 标注超时 → 转为卡片(可选) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔗 依赖检查前置规则
|
||||||
|
|
||||||
|
### 强制检查流程
|
||||||
|
|
||||||
|
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 依赖,可以启动')
|
||||||
|
"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🛑 最大轮次限制
|
||||||
|
|
||||||
|
### 限制值:100 轮
|
||||||
|
|
||||||
|
- 接近 80%(80 轮)→ 预警
|
||||||
|
- 达到上限 → 暂停,通知 COO + 创建者
|
||||||
|
|
||||||
|
### 跨平台轮次跟踪
|
||||||
|
|
||||||
|
- **WorkBoard**:通过 workboard_heartbeat 的 note 记录轮次
|
||||||
|
- **Multica**:通过 issue comment 记录轮次进度
|
||||||
|
- **待办文档**:在工作日志中记录
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🫀 心跳执行清单
|
||||||
|
|
||||||
|
### 每次心跳必须检查
|
||||||
|
|
||||||
|
1. ✅ **全任务源检查**:WorkBoard + Multica + 待办文档
|
||||||
|
2. ✅ 进行中任务超时检测(跨平台)
|
||||||
|
3. ✅ 依赖检查
|
||||||
|
4. ✅ 轮次计数器更新
|
||||||
|
5. ✅ 代码开发进度
|
||||||
|
6. ✅ PR/Code Review 状态
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 全局关键规则
|
||||||
|
|
||||||
|
1. **心跳不打断对话** — 用户正在对话时延后执行
|
||||||
|
2. **非紧急事项延后汇报** — 等下一轮心跳或用户询问
|
||||||
|
3. **发现任务立即执行,不得请示**(任何来源)
|
||||||
|
4. **超时任务按自动恢复流程处理**(跨平台)
|
||||||
|
5. **依赖未满足不启动**
|
||||||
|
6. **达到轮次上限自动暂停**
|
||||||
|
7. **避免任务遗漏** — 三源必须全部检查,缺一不可
|
||||||
|
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
> 基于 BIZ-24 v1.1 模板生成 | 徐聪(costcodev)专用配置
|
||||||
@@ -0,0 +1,234 @@
|
|||||||
|
# HEARTBEAT.md - 程伯予(cvexpert)的心跳配置
|
||||||
|
|
||||||
|
> 模板版本:v1.1 (BIZ-24) | 分类:业务 Agent
|
||||||
|
> OpenClaw Agent ID: `cvexpert` | Multica Agent UUID: `4a8696fd-6531-40da-8956-ef84d7ea3c43`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 全任务源统一监控(每次心跳必检)
|
||||||
|
|
||||||
|
> **核心原则:发现任何来源的任务都必须立即执行,不得遗漏。**
|
||||||
|
|
||||||
|
### 三源检查
|
||||||
|
|
||||||
|
#### 第一优先级: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') == 'cvexpert' 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 4a8696fd-6531-40da-8956-ef84d7ea3c43 --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=cvexpert)
|
||||||
|
↓
|
||||||
|
检查 Multica Issues 待办(assignee=4a8696fd-6531-40da-8956-ef84d7ea3c43)
|
||||||
|
↓
|
||||||
|
检查待办文档
|
||||||
|
↓
|
||||||
|
合并去重 → 按优先级排序 → 依次执行
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||||
|
|
||||||
|
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||||
|
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||||
|
|
||||||
|
### 执行流程(严格执行,无需确认)
|
||||||
|
|
||||||
|
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 模板生成 | 程伯予(cvexpert)专用配置
|
||||||
@@ -0,0 +1,234 @@
|
|||||||
|
# HEARTBEAT.md - 苏锦绘(designer)的心跳配置
|
||||||
|
|
||||||
|
> 模板版本:v1.1 (BIZ-24) | 分类:开发 Agent
|
||||||
|
> OpenClaw Agent ID: `designer` | Multica Agent UUID: `13bd8968-cc2a-4934-90c7-957a2d3c09c2`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 全任务源统一监控(每次心跳必检)
|
||||||
|
|
||||||
|
> **核心原则:发现任何来源的任务都必须立即执行,不得遗漏。**
|
||||||
|
|
||||||
|
### 三源检查
|
||||||
|
|
||||||
|
#### 第一优先级: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') == 'designer' 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 13bd8968-cc2a-4934-90c7-957a2d3c09c2 --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=designer)
|
||||||
|
↓
|
||||||
|
检查 Multica Issues 待办(assignee=13bd8968-cc2a-4934-90c7-957a2d3c09c2)
|
||||||
|
↓
|
||||||
|
检查待办文档
|
||||||
|
↓
|
||||||
|
合并去重 → 按优先级排序 → 依次执行
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||||
|
|
||||||
|
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||||
|
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||||
|
|
||||||
|
### 执行流程(严格执行,无需确认)
|
||||||
|
|
||||||
|
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 → 通知 COO + 创建者 |
|
||||||
|
| Multica | 添加评论 → status=blocked → 通知 COO + 创建者 |
|
||||||
|
| 待办文档 | 标注超时 → 转为卡片(可选) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔗 依赖检查前置规则
|
||||||
|
|
||||||
|
### 强制检查流程
|
||||||
|
|
||||||
|
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 依赖,可以启动')
|
||||||
|
"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🛑 最大轮次限制
|
||||||
|
|
||||||
|
### 限制值:100 轮
|
||||||
|
|
||||||
|
- 接近 80%(80 轮)→ 预警
|
||||||
|
- 达到上限 → 暂停,通知 COO + 创建者
|
||||||
|
|
||||||
|
### 跨平台轮次跟踪
|
||||||
|
|
||||||
|
- **WorkBoard**:通过 workboard_heartbeat 的 note 记录轮次
|
||||||
|
- **Multica**:通过 issue comment 记录轮次进度
|
||||||
|
- **待办文档**:在工作日志中记录
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🫀 心跳执行清单
|
||||||
|
|
||||||
|
### 每次心跳必须检查
|
||||||
|
|
||||||
|
1. ✅ **全任务源检查**:WorkBoard + Multica + 待办文档
|
||||||
|
2. ✅ 进行中任务超时检测(跨平台)
|
||||||
|
3. ✅ 依赖检查
|
||||||
|
4. ✅ 轮次计数器更新
|
||||||
|
5. ✅ 设计稿进度
|
||||||
|
6. ✅ UI/UX 评审状态
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 全局关键规则
|
||||||
|
|
||||||
|
1. **心跳不打断对话** — 用户正在对话时延后执行
|
||||||
|
2. **非紧急事项延后汇报** — 等下一轮心跳或用户询问
|
||||||
|
3. **发现任务立即执行,不得请示**(任何来源)
|
||||||
|
4. **超时任务按自动恢复流程处理**(跨平台)
|
||||||
|
5. **依赖未满足不启动**
|
||||||
|
6. **达到轮次上限自动暂停**
|
||||||
|
7. **避免任务遗漏** — 三源必须全部检查,缺一不可
|
||||||
|
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
> 基于 BIZ-24 v1.1 模板生成 | 苏锦绘(designer)专用配置
|
||||||
@@ -0,0 +1,234 @@
|
|||||||
|
# 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)专用配置
|
||||||
@@ -0,0 +1,234 @@
|
|||||||
|
# HEARTBEAT.md - 顾析策(marketanalysis)的心跳配置
|
||||||
|
|
||||||
|
> 模板版本:v1.1 (BIZ-24) | 分类:业务 Agent
|
||||||
|
> OpenClaw Agent ID: `marketanalysis` | Multica Agent UUID: `5ed91729-658f-4654-98f0-3e0313022002`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 全任务源统一监控(每次心跳必检)
|
||||||
|
|
||||||
|
> **核心原则:发现任何来源的任务都必须立即执行,不得遗漏。**
|
||||||
|
|
||||||
|
### 三源检查
|
||||||
|
|
||||||
|
#### 第一优先级: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') == 'marketanalysis' 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 5ed91729-658f-4654-98f0-3e0313022002 --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=marketanalysis)
|
||||||
|
↓
|
||||||
|
检查 Multica Issues 待办(assignee=5ed91729-658f-4654-98f0-3e0313022002)
|
||||||
|
↓
|
||||||
|
检查待办文档
|
||||||
|
↓
|
||||||
|
合并去重 → 按优先级排序 → 依次执行
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||||
|
|
||||||
|
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||||
|
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||||
|
|
||||||
|
### 执行流程(严格执行,无需确认)
|
||||||
|
|
||||||
|
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 模板生成 | 顾析策(marketanalysis)专用配置
|
||||||
@@ -0,0 +1,234 @@
|
|||||||
|
# HEARTBEAT.md - 钟帧韵(mediaspecialist)的心跳配置
|
||||||
|
|
||||||
|
> 模板版本:v1.1 (BIZ-24) | 分类:业务 Agent
|
||||||
|
> OpenClaw Agent ID: `mediaspecialist` | Multica Agent UUID: `e2b587d4-1d16-447c-8ad9-e2a01358ff0a`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 全任务源统一监控(每次心跳必检)
|
||||||
|
|
||||||
|
> **核心原则:发现任何来源的任务都必须立即执行,不得遗漏。**
|
||||||
|
|
||||||
|
### 三源检查
|
||||||
|
|
||||||
|
#### 第一优先级: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') == 'mediaspecialist' 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 e2b587d4-1d16-447c-8ad9-e2a01358ff0a --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=mediaspecialist)
|
||||||
|
↓
|
||||||
|
检查 Multica Issues 待办(assignee=e2b587d4-1d16-447c-8ad9-e2a01358ff0a)
|
||||||
|
↓
|
||||||
|
检查待办文档
|
||||||
|
↓
|
||||||
|
合并去重 → 按优先级排序 → 依次执行
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||||
|
|
||||||
|
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||||
|
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||||
|
|
||||||
|
### 执行流程(严格执行,无需确认)
|
||||||
|
|
||||||
|
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 模板生成 | 钟帧韵(mediaspecialist)专用配置
|
||||||
@@ -0,0 +1,234 @@
|
|||||||
|
# HEARTBEAT.md - 严维序(opengineer)的心跳配置
|
||||||
|
|
||||||
|
> 模板版本:v1.1 (BIZ-24) | 分类:开发 Agent
|
||||||
|
> OpenClaw Agent ID: `opengineer` | Multica Agent UUID: `d3804433-9e2e-4199-a92b-a153049b3bc9`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 全任务源统一监控(每次心跳必检)
|
||||||
|
|
||||||
|
> **核心原则:发现任何来源的任务都必须立即执行,不得遗漏。**
|
||||||
|
|
||||||
|
### 三源检查
|
||||||
|
|
||||||
|
#### 第一优先级: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') == 'opengineer' 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 d3804433-9e2e-4199-a92b-a153049b3bc9 --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=opengineer)
|
||||||
|
↓
|
||||||
|
检查 Multica Issues 待办(assignee=d3804433-9e2e-4199-a92b-a153049b3bc9)
|
||||||
|
↓
|
||||||
|
检查待办文档
|
||||||
|
↓
|
||||||
|
合并去重 → 按优先级排序 → 依次执行
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||||
|
|
||||||
|
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||||
|
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||||
|
|
||||||
|
### 执行流程(严格执行,无需确认)
|
||||||
|
|
||||||
|
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 → 通知 COO + 创建者 |
|
||||||
|
| Multica | 添加评论 → status=blocked → 通知 COO + 创建者 |
|
||||||
|
| 待办文档 | 标注超时 → 转为卡片(可选) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔗 依赖检查前置规则
|
||||||
|
|
||||||
|
### 强制检查流程
|
||||||
|
|
||||||
|
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 依赖,可以启动')
|
||||||
|
"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🛑 最大轮次限制
|
||||||
|
|
||||||
|
### 限制值:100 轮
|
||||||
|
|
||||||
|
- 接近 80%(80 轮)→ 预警
|
||||||
|
- 达到上限 → 暂停,通知 COO + 创建者
|
||||||
|
|
||||||
|
### 跨平台轮次跟踪
|
||||||
|
|
||||||
|
- **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 模板生成 | 严维序(opengineer)专用配置
|
||||||
@@ -0,0 +1,234 @@
|
|||||||
|
# HEARTBEAT.md - 沈路明(productmanager)的心跳配置
|
||||||
|
|
||||||
|
> 模板版本:v1.1 (BIZ-24) | 分类:开发 Agent
|
||||||
|
> OpenClaw Agent ID: `productmanager` | Multica Agent UUID: `a101fa88-d821-4839-9754-e04580d5fd68`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 全任务源统一监控(每次心跳必检)
|
||||||
|
|
||||||
|
> **核心原则:发现任何来源的任务都必须立即执行,不得遗漏。**
|
||||||
|
|
||||||
|
### 三源检查
|
||||||
|
|
||||||
|
#### 第一优先级: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') == 'productmanager' 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 a101fa88-d821-4839-9754-e04580d5fd68 --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=productmanager)
|
||||||
|
↓
|
||||||
|
检查 Multica Issues 待办(assignee=a101fa88-d821-4839-9754-e04580d5fd68)
|
||||||
|
↓
|
||||||
|
检查待办文档
|
||||||
|
↓
|
||||||
|
合并去重 → 按优先级排序 → 依次执行
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||||
|
|
||||||
|
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||||
|
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||||
|
|
||||||
|
### 执行流程(严格执行,无需确认)
|
||||||
|
|
||||||
|
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 → 通知 COO + 创建者 |
|
||||||
|
| Multica | 添加评论 → status=blocked → 通知 COO + 创建者 |
|
||||||
|
| 待办文档 | 标注超时 → 转为卡片(可选) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔗 依赖检查前置规则
|
||||||
|
|
||||||
|
### 强制检查流程
|
||||||
|
|
||||||
|
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 依赖,可以启动')
|
||||||
|
"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🛑 最大轮次限制
|
||||||
|
|
||||||
|
### 限制值:100 轮
|
||||||
|
|
||||||
|
- 接近 80%(80 轮)→ 预警
|
||||||
|
- 达到上限 → 暂停,通知 COO + 创建者
|
||||||
|
|
||||||
|
### 跨平台轮次跟踪
|
||||||
|
|
||||||
|
- **WorkBoard**:通过 workboard_heartbeat 的 note 记录轮次
|
||||||
|
- **Multica**:通过 issue comment 记录轮次进度
|
||||||
|
- **待办文档**:在工作日志中记录
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🫀 心跳执行清单
|
||||||
|
|
||||||
|
### 每次心跳必须检查
|
||||||
|
|
||||||
|
1. ✅ **全任务源检查**:WorkBoard + Multica + 待办文档
|
||||||
|
2. ✅ 进行中任务超时检测(跨平台)
|
||||||
|
3. ✅ 依赖检查
|
||||||
|
4. ✅ 轮次计数器更新
|
||||||
|
5. ✅ PRD 进度检查
|
||||||
|
6. ✅ 需求变更跟踪
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 全局关键规则
|
||||||
|
|
||||||
|
1. **心跳不打断对话** — 用户正在对话时延后执行
|
||||||
|
2. **非紧急事项延后汇报** — 等下一轮心跳或用户询问
|
||||||
|
3. **发现任务立即执行,不得请示**(任何来源)
|
||||||
|
4. **超时任务按自动恢复流程处理**(跨平台)
|
||||||
|
5. **依赖未满足不启动**
|
||||||
|
6. **达到轮次上限自动暂停**
|
||||||
|
7. **避免任务遗漏** — 三源必须全部检查,缺一不可
|
||||||
|
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
> 基于 BIZ-24 v1.1 模板生成 | 沈路明(productmanager)专用配置
|
||||||
@@ -0,0 +1,234 @@
|
|||||||
|
# HEARTBEAT.md - 胡蓉(projectmanager)的心跳配置
|
||||||
|
|
||||||
|
> 模板版本:v1.1 (BIZ-24) | 分类:开发 Agent
|
||||||
|
> OpenClaw Agent ID: `projectmanager` | Multica Agent UUID: `d877b8c3-b230-4073-b3f7-80e148cfdb71`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 全任务源统一监控(每次心跳必检)
|
||||||
|
|
||||||
|
> **核心原则:发现任何来源的任务都必须立即执行,不得遗漏。**
|
||||||
|
|
||||||
|
### 三源检查
|
||||||
|
|
||||||
|
#### 第一优先级: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') == 'projectmanager' 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 d877b8c3-b230-4073-b3f7-80e148cfdb71 --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=projectmanager)
|
||||||
|
↓
|
||||||
|
检查 Multica Issues 待办(assignee=d877b8c3-b230-4073-b3f7-80e148cfdb71)
|
||||||
|
↓
|
||||||
|
检查待办文档
|
||||||
|
↓
|
||||||
|
合并去重 → 按优先级排序 → 依次执行
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||||
|
|
||||||
|
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||||
|
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||||
|
|
||||||
|
### 执行流程(严格执行,无需确认)
|
||||||
|
|
||||||
|
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 → 通知 COO + 创建者 |
|
||||||
|
| Multica | 添加评论 → status=blocked → 通知 COO + 创建者 |
|
||||||
|
| 待办文档 | 标注超时 → 转为卡片(可选) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔗 依赖检查前置规则
|
||||||
|
|
||||||
|
### 强制检查流程
|
||||||
|
|
||||||
|
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 依赖,可以启动')
|
||||||
|
"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🛑 最大轮次限制
|
||||||
|
|
||||||
|
### 限制值:100 轮
|
||||||
|
|
||||||
|
- 接近 80%(80 轮)→ 预警
|
||||||
|
- 达到上限 → 暂停,通知 COO + 创建者
|
||||||
|
|
||||||
|
### 跨平台轮次跟踪
|
||||||
|
|
||||||
|
- **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 模板生成 | 胡蓉(projectmanager)专用配置
|
||||||
@@ -0,0 +1,235 @@
|
|||||||
|
# HEARTBEAT.md - 刘诗妮(secretary)的心跳配置
|
||||||
|
|
||||||
|
> 模板版本:v1.1 (BIZ-24) | 分类:高频 Agent
|
||||||
|
> OpenClaw Agent ID: `secretary` | Multica Agent UUID: `b024fcdc-30ff-420d-b289-498041466e1b`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 全任务源统一监控(每次心跳必检)
|
||||||
|
|
||||||
|
> **核心原则:发现任何来源的任务都必须立即执行,不得遗漏。**
|
||||||
|
|
||||||
|
### 三源检查
|
||||||
|
|
||||||
|
#### 第一优先级: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') == '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
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 检查 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"]}')
|
||||||
|
"
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 第三优先级:待办文档
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 检查工作区待办文档
|
||||||
|
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. 确认超时 → 进入自动恢复流程
|
||||||
|
|
||||||
|
### 跨平台超时检测脚本
|
||||||
|
|
||||||
|
```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 > 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)→ 通知依赖任务执行者
|
||||||
|
|
||||||
|
### 双平台依赖检查
|
||||||
|
|
||||||
|
```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 依赖,可以启动')
|
||||||
|
"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🛑 最大轮次限制
|
||||||
|
|
||||||
|
### 限制值: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)专用配置
|
||||||
@@ -0,0 +1,234 @@
|
|||||||
|
# HEARTBEAT.md - 陆云帆(taobaospecialist)的心跳配置
|
||||||
|
|
||||||
|
> 模板版本:v1.1 (BIZ-24) | 分类:业务 Agent
|
||||||
|
> OpenClaw Agent ID: `taobaospecialist` | Multica Agent UUID: `e0f62d8f-9568-4f41-8ad4-b73d79a163a7`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 全任务源统一监控(每次心跳必检)
|
||||||
|
|
||||||
|
> **核心原则:发现任何来源的任务都必须立即执行,不得遗漏。**
|
||||||
|
|
||||||
|
### 三源检查
|
||||||
|
|
||||||
|
#### 第一优先级: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') == 'taobaospecialist' 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 e0f62d8f-9568-4f41-8ad4-b73d79a163a7 --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=taobaospecialist)
|
||||||
|
↓
|
||||||
|
检查 Multica Issues 待办(assignee=e0f62d8f-9568-4f41-8ad4-b73d79a163a7)
|
||||||
|
↓
|
||||||
|
检查待办文档
|
||||||
|
↓
|
||||||
|
合并去重 → 按优先级排序 → 依次执行
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||||
|
|
||||||
|
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||||
|
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||||
|
|
||||||
|
### 执行流程(严格执行,无需确认)
|
||||||
|
|
||||||
|
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 模板生成 | 陆云帆(taobaospecialist)专用配置
|
||||||
Reference in New Issue
Block a user