Compare commits
7 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 77f4eb1579 | |||
| bea11d04fb | |||
| 3f08ae4004 | |||
| b0cf98e422 | |||
| a8fa922095 | |||
| be24de9ced | |||
| fed64cc279 |
@@ -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)专用配置
|
||||||
@@ -0,0 +1,130 @@
|
|||||||
|
# Agent 知识库集成指南
|
||||||
|
|
||||||
|
> **版本**: v1.0
|
||||||
|
> **任务**: BIZ-19 (BIZ-14-4)
|
||||||
|
> **日期**: 2026-06-22
|
||||||
|
> **作者**: COO (陆怀瑾)
|
||||||
|
> **状态**: 已实施
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 一、集成概述
|
||||||
|
|
||||||
|
### 1.1 设计原则
|
||||||
|
|
||||||
|
**「引用代替填塞」**: 不把知识内容直接塞进 Agent 配置文件,而是添加 "如何查询知识库" 的指引。Agent 在需要时主动检索,保持配置文件轻量和可维护。
|
||||||
|
|
||||||
|
### 1.2 核心工具
|
||||||
|
|
||||||
|
| 工具 | 用途 | 适用场景 |
|
||||||
|
|------|------|----------|
|
||||||
|
| `wiki_search` | 模糊搜索知识库 | "有没有关于 X 的文档" |
|
||||||
|
| `wiki_get` | 精确读取页面 | "打开 X 页面" |
|
||||||
|
| `wiki_lint` | 知识库质量检查 | "知识库健康度如何" |
|
||||||
|
| `wiki_status` | 系统状态检查 | "知识库是否可用" |
|
||||||
|
| `wiki_apply` | 写入/更新知识库 | "将 X 发现写入知识库" |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 二、Agent 集成清单
|
||||||
|
|
||||||
|
### 2.1 已完成集成的 Agent(15 个)
|
||||||
|
|
||||||
|
| # | Agent | 角色 | TOOLS.md 更新状态 | 触发场景数 |
|
||||||
|
|---|-------|------|-------------------|------------|
|
||||||
|
| 1 | secretary | 刘诗妮 - 业务入口 | ✅ | 4 |
|
||||||
|
| 2 | coo | 陆怀瑾 - 运营总监 | ✅ | 5 |
|
||||||
|
| 3 | projectmanager | 胡蓉 - 项目经理 | ✅ | 4 |
|
||||||
|
| 4 | architect | 梁思筑 - 架构师 | ✅ | 4 |
|
||||||
|
| 5 | costcodev | 徐聪 - 全栈开发 | ✅ | 4 |
|
||||||
|
| 6 | designer | 苏绘锦 - UI/UX 设计 | ✅ | 3 |
|
||||||
|
| 7 | taobaospecialist | 陆云帆 - 淘宝运营 | ✅ | 4 |
|
||||||
|
| 8 | contentspecialist | 文墨言 - 内容文案 | ✅ | 4 |
|
||||||
|
| 9 | mediaspecialist | 钟帧韵 - 视频制作 | ✅ | 3 |
|
||||||
|
| 10 | cvexpert | 程伯予 - 求职助理 | ✅ | 3 |
|
||||||
|
| 11 | marketanalysis | 顾析策 - 市场分析 | ✅ | 4 |
|
||||||
|
| 12 | lawyer | 苏慎 - 法务顾问 | ✅ | 4 |
|
||||||
|
| 13 | opengineer | 严维序 - 运维部署 | ✅ | 4 |
|
||||||
|
| 14 | productmanager | 沈路明 - 产品经理 | ✅ | 4 |
|
||||||
|
| 15 | main | 入口路由 | ✅ | 2 |
|
||||||
|
|
||||||
|
### 2.2 集成内容
|
||||||
|
|
||||||
|
每个 Agent 的 TOOLS.md 新增了以下内容:
|
||||||
|
|
||||||
|
1. **知识库查询指引** — 引导 Agent 查看完整检索指南
|
||||||
|
2. **角色特定触发条件** — 该 Agent 何时应查询知识库
|
||||||
|
3. **查询工具速查** — `wiki_search` / `wiki_get` / `wiki_lint` 基本用法
|
||||||
|
4. **角色特定查询示例** — 1-2 个典型查询语句
|
||||||
|
5. **无结果时处理流程** — 知识缺口上报机制
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 三、查询触发条件设计
|
||||||
|
|
||||||
|
### 3.1 通用触发条件(所有 Agent 适用)
|
||||||
|
|
||||||
|
| 场景 | 触发动作 |
|
||||||
|
|------|----------|
|
||||||
|
| 接受新任务时 | 先查知识库中是否有相关文档/SOP |
|
||||||
|
| 遇到不确定信息时 | 先查知识库再作决策 |
|
||||||
|
| 需要跨领域协作时 | 查其他 Agent 的职能和知识 |
|
||||||
|
| 发现新知识时 | 考虑是否需写入知识库 |
|
||||||
|
|
||||||
|
### 3.2 角色特定触发条件(按 Agent 定制)
|
||||||
|
|
||||||
|
见各 Agent TOOLS.md 中的「知识库查询 → 触发条件」部分。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 四、知识缺口上报机制
|
||||||
|
|
||||||
|
### 4.1 上报流程
|
||||||
|
|
||||||
|
```
|
||||||
|
Agent 查询知识库 → 无结果 → 尝试同义词/相关词 → 仍无结果 →
|
||||||
|
→ 记录知识缺口 → 写入 memory/ 日志 →
|
||||||
|
→ 下次心跳/汇报时通知 architect 或对应领域 Agent
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.2 上报格式
|
||||||
|
|
||||||
|
见 `docs/agent-kb-retrieval-guide.md` 第五节。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 五、质量保证
|
||||||
|
|
||||||
|
### 5.1 集成测试方案
|
||||||
|
|
||||||
|
对每个 Agent 至少执行 1 次典型查询场景测试:
|
||||||
|
|
||||||
|
1. 验证 `wiki_search` 可被正确调用
|
||||||
|
2. 验证返回结果格式正确
|
||||||
|
3. 验证无结果时的降级路径
|
||||||
|
|
||||||
|
### 5.2 集成测试结果
|
||||||
|
|
||||||
|
| Agent | 测试查询 | 结果 | 备注 |
|
||||||
|
|-------|----------|------|------|
|
||||||
|
| 通用 | `wiki_search(query="服务器")` | ✅ | wiki_search 正常 |
|
||||||
|
|
||||||
|
*注:知识库当前为初始状态(0 sources, 0 entities, 0 concepts, 0 syntheses, 10 reports),搜索结果取决于内容填充进度。工具链已验证可用。*
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 六、后续计划
|
||||||
|
|
||||||
|
1. **知识内容填充**: 待 BIZ-14-3 交付后,各 Agent 按角色写入初始知识内容
|
||||||
|
2. **定期质量检查**: COO 每周运行 `wiki_lint()` 检查知识库健康度
|
||||||
|
3. **查询效果评估**: 运行 1 个月后统计各 Agent 知识库查询频率和命中率
|
||||||
|
4. **持续优化**: 根据使用反馈调整触发条件和查询示例
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 附录:相关文档
|
||||||
|
|
||||||
|
- `docs/agent-kb-retrieval-guide.md` — 知识库检索工具完整指南
|
||||||
|
- `docs/知识查询最佳实践.md` — 查询最佳实践和反模式
|
||||||
|
- `docs/wiki-toolchain-test-report.md` — Wiki 工具链测试报告 (BIZ-14-2)
|
||||||
|
- 各 Agent TOOLS.md — 角色特定查询指引
|
||||||
@@ -0,0 +1,156 @@
|
|||||||
|
# 知识查询最佳实践
|
||||||
|
|
||||||
|
> **版本**: v1.0
|
||||||
|
> **任务**: BIZ-19 (BIZ-14-4)
|
||||||
|
> **日期**: 2026-06-22
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 一、查询策略
|
||||||
|
|
||||||
|
### 1.1 渐进式检索原则
|
||||||
|
|
||||||
|
```
|
||||||
|
先宽后窄 → 先模糊后精确 → 先搜索后读取
|
||||||
|
```
|
||||||
|
|
||||||
|
**标准流程**:
|
||||||
|
1. `wiki_search(query="关键词")` — 发现有哪些相关内容
|
||||||
|
2. `wiki_get(lookup="匹配页面")` — 精确读取具体内容
|
||||||
|
3. 如搜索结果过多(>10) → 收窄关键词重新搜索
|
||||||
|
4. 如搜索结果与需求不相关 → 调整表述方式重新搜索
|
||||||
|
|
||||||
|
### 1.2 查询词构造技巧
|
||||||
|
|
||||||
|
#### DO ✅
|
||||||
|
|
||||||
|
| 技巧 | 示例 | 说明 |
|
||||||
|
|------|------|------|
|
||||||
|
| 用领域特定术语 | `wiki_search(query="nginx 反向代理")` | 专业词汇提升精确度 |
|
||||||
|
| 用动词+对象 | `wiki_search(query="部署 Node.js")` | 明确查询意图 |
|
||||||
|
| 用自然语言问题 | `wiki_search(query="如何配置 nginx logrotate")` | 适合语义检索 |
|
||||||
|
| 用缩写和全称组合 | `wiki_search(query="CI/CD 持续集成")` | 覆盖不同表述 |
|
||||||
|
| 分步搜索 | 先搜 "nginx",再搜 "nginx 日志" | 逐步收窄范围 |
|
||||||
|
|
||||||
|
#### DON'T ❌
|
||||||
|
|
||||||
|
| 反模式 | 错误示例 | 问题 |
|
||||||
|
|--------|----------|------|
|
||||||
|
| 过于泛化的词 | `wiki_search(query="配置")` | 结果太多太杂 |
|
||||||
|
| 过于具体的短语 | `wiki_search(query="192.168.1.99 端口 22 上的 nginx")` | 命中率低 |
|
||||||
|
| 跳过搜索直接 guess 路径 | `wiki_get(lookup="随便猜的页面名")` | 大概率找不到 |
|
||||||
|
| 一次加载超大页面 | `wiki_get(lookup="巨型文档")` | 超出上下文容量 |
|
||||||
|
| 无结果后直接放弃 | 只搜一次就说"知识库没内容" | 可能是查询词不准确 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 二、结果处理
|
||||||
|
|
||||||
|
### 2.1 匹配结果数量处理
|
||||||
|
|
||||||
|
| 结果数 | 处理方式 |
|
||||||
|
|--------|----------|
|
||||||
|
| 0 | 尝试同义词/相关词 → qmd 搜索 → 上报知识缺口 |
|
||||||
|
| 1-3 | 逐个 `wiki_get` 读取完整内容 |
|
||||||
|
| 4-10 | 按评分排序,取前 3 个读取 |
|
||||||
|
| 10+ | 收窄搜索词重新搜索 |
|
||||||
|
|
||||||
|
### 2.2 大页面分页读取
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 超过 100 行的页面,分页读取
|
||||||
|
wiki_get(lookup="长文档标题", fromLine=1, lineCount=50) # 第一部分
|
||||||
|
wiki_get(lookup="长文档标题", fromLine=51, lineCount=50) # 第二部分
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2.3 信息来源交叉验证
|
||||||
|
|
||||||
|
当多个查询返回不同信息时:
|
||||||
|
1. 检查页面更新时间(优先信任较新的)
|
||||||
|
2. 交叉对比多个来源
|
||||||
|
3. 如信息冲突 → 标记为"需确认",汇报给 architect
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 三、知识缺口处理
|
||||||
|
|
||||||
|
### 3.1 判定标准
|
||||||
|
|
||||||
|
满足以下任一条件即报告知识缺口:
|
||||||
|
- `wiki_search` 和 `qmd` 均无匹配
|
||||||
|
- 搜索结果与需求明显不相关
|
||||||
|
- 找到的文档内容已过时或不完整
|
||||||
|
|
||||||
|
### 3.2 上报模板
|
||||||
|
|
||||||
|
```
|
||||||
|
【知识缺口 - YYYY-MM-DD】
|
||||||
|
|
||||||
|
- 查询 Agent: [Agent 名称]
|
||||||
|
- 查询意图: [想了解什么]
|
||||||
|
- 已尝试检索: [用过的搜索词, 换行列出]
|
||||||
|
- 已使用工具: wiki_search / qmd
|
||||||
|
- 期望内容: [知识库中应有什么]
|
||||||
|
- 紧急程度: high / normal / low
|
||||||
|
- 建议: [谁补充、什么内容]
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.3 上报路径
|
||||||
|
|
||||||
|
| 缺口类型 | 上报目标 |
|
||||||
|
|----------|----------|
|
||||||
|
| 架构/技术 | architect (梁思筑) |
|
||||||
|
| 业务/流程 | projectmanager (胡蓉) |
|
||||||
|
| 法务/合规 | lawyer (苏慎) |
|
||||||
|
| 市场/分析 | marketanalysis (顾析策) |
|
||||||
|
| 通用/不确定 | COO (陆怀瑾) — 由 COO 分配 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 四、知识库写入准则
|
||||||
|
|
||||||
|
### 4.1 何时写入
|
||||||
|
|
||||||
|
- 完成重要决策后(如架构选型、策略调整)
|
||||||
|
- 发现可复用的模板/清单
|
||||||
|
- 完成深度分析后(市场报告、竞品分析)
|
||||||
|
- 知识缺口被填补后
|
||||||
|
|
||||||
|
### 4.2 写入工具选择
|
||||||
|
|
||||||
|
| 场景 | 工具 |
|
||||||
|
|------|------|
|
||||||
|
| 创建新知识页面 | `wiki_apply(op="create_synthesis", ...)` |
|
||||||
|
| 更新已有页面元数据 | `wiki_apply(op="update_metadata", ...)` |
|
||||||
|
|
||||||
|
### 4.3 不写入的内容
|
||||||
|
|
||||||
|
- 机密信息(密码、密钥、token)
|
||||||
|
- 临时信息(当天的具体任务进度)
|
||||||
|
- 已过时会被频繁更新的数据
|
||||||
|
- 纯个人笔记(放 `memory/` 下)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 五、定期维护
|
||||||
|
|
||||||
|
### 5.1 COO 每周检查清单
|
||||||
|
|
||||||
|
- [ ] 运行 `wiki_lint()` 检查质量
|
||||||
|
- [ ] 统计各 Agent 知识库查询频率
|
||||||
|
- [ ] 清理过时页面
|
||||||
|
- [ ] 评估知识缺口数量和解决率
|
||||||
|
- [ ] 输出知识库运营周报
|
||||||
|
|
||||||
|
### 5.2 Agent 自检清单
|
||||||
|
|
||||||
|
每次心跳时:
|
||||||
|
- [ ] 上次查询的知识缺口是否已上报
|
||||||
|
- [ ] 本轮工作中是否有应写入知识库的发现
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 附录
|
||||||
|
|
||||||
|
- `docs/agent-kb-retrieval-guide.md` — 工具使用完整指南
|
||||||
|
- `docs/Agent 知识库集成指南.md` — 集成方案总览
|
||||||
@@ -12,8 +12,10 @@
|
|||||||
| [产品/](产品/) | PRD、需求分析 | 沈路明 (productmanager) | — |
|
| [产品/](产品/) | PRD、需求分析 | 沈路明 (productmanager) | — |
|
||||||
| [技术/](技术/) | 开发规范、代码审查 | 徐聪 (costcodev) | — |
|
| [技术/](技术/) | 开发规范、代码审查 | 徐聪 (costcodev) | — |
|
||||||
| [设计/](设计/) | UI设计、品牌规范 | 苏绘锦 (designer) | — |
|
| [设计/](设计/) | UI设计、品牌规范 | 苏绘锦 (designer) | — |
|
||||||
|
| [运维/](运维/) | 部署流程、故障排查、服务器运维 | 严维序 (opengineer) | 3 |
|
||||||
| [运营/](运营/) | 活动策划、数据分析 | 陆怀瑾 (coo) | — |
|
| [运营/](运营/) | 活动策划、数据分析 | 陆怀瑾 (coo) | — |
|
||||||
| [行政/](行政/) | 合同、报销流程 | 刘诗妮 (secretary) | — |
|
| [行政/](行政/) | 合同、报销流程 | 刘诗妮 (secretary) | — |
|
||||||
|
| [规范/](规范/) | 运维标准、安全基线、合规要求 | 严维序 (opengineer) | — |
|
||||||
|
|
||||||
## 知识条目格式
|
## 知识条目格式
|
||||||
|
|
||||||
|
|||||||
@@ -5,7 +5,9 @@
|
|||||||
|
|
||||||
## 知识范围
|
## 知识范围
|
||||||
|
|
||||||
涵盖开发规范、代码审查、架构设计、部署运维、技术选型等技术团队知识。
|
涵盖开发规范、代码审查、架构设计、技术选型等技术团队核心知识。
|
||||||
|
|
||||||
|
> ⚠️ 部署运维知识已迁移至 [运维/](../运维/) 领域。
|
||||||
|
|
||||||
## 条目清单
|
## 条目清单
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,25 @@
|
|||||||
|
# 规范领域知识
|
||||||
|
|
||||||
|
**责任人**:严维序(opengineer)
|
||||||
|
**审核人**:陆怀瑾(coo)
|
||||||
|
|
||||||
|
## 知识范围
|
||||||
|
|
||||||
|
涵盖运维规范、安全标准、合规要求等规范类知识条目,支撑团队标准化运作。
|
||||||
|
|
||||||
|
## 条目清单
|
||||||
|
|
||||||
|
| 文件名 | 说明 | 状态 |
|
||||||
|
|--------|------|------|
|
||||||
|
| [服务器运维标准_v1.0.md](../运维/服务器运维标准_v1.0.md) | 服务器巡检、监控、备份运维标准 | 见运维域 |
|
||||||
|
|
||||||
|
## 待建设
|
||||||
|
|
||||||
|
- 数据库运维标准
|
||||||
|
- 安全审计基线
|
||||||
|
- 数据合规处理流程
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
> 维护者:严维序(opengineer)
|
||||||
|
> 最后更新:2026-06-24
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
# 运维领域知识
|
||||||
|
|
||||||
|
**责任人**:严维序(opengineer)
|
||||||
|
**审核人**:陆怀瑾(coo)
|
||||||
|
|
||||||
|
## 知识范围
|
||||||
|
|
||||||
|
涵盖服务器运维、部署流程、故障排查、监控配置、安全保障等运维团队核心知识。
|
||||||
|
|
||||||
|
## 条目清单
|
||||||
|
|
||||||
|
| 文件名 | 说明 | 状态 |
|
||||||
|
|--------|------|------|
|
||||||
|
| [部署流程_v1.0.md](部署流程_v1.0.md) | 服务部署 SOP 与变更管理流程 | ✅ |
|
||||||
|
| [故障排查手册_v1.0.md](故障排查手册_v1.0.md) | 常见故障定位与处置方案 | ✅ |
|
||||||
|
| [服务器运维标准_v1.0.md](服务器运维标准_v1.0.md) | 服务器巡检、监控、备份运维标准 | 🆕 |
|
||||||
|
|
||||||
|
## 待建设
|
||||||
|
|
||||||
|
- 数据库运维指南
|
||||||
|
- 安全加固检查清单
|
||||||
|
- 灾备与应急恢复预案
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
> 维护者:严维序(opengineer)
|
||||||
|
> 最后更新:2026-06-24
|
||||||
@@ -0,0 +1,274 @@
|
|||||||
|
# 故障排查手册
|
||||||
|
|
||||||
|
## 元数据
|
||||||
|
|
||||||
|
| 属性 | 值 |
|
||||||
|
|------|-----|
|
||||||
|
| **领域** | 运维 |
|
||||||
|
| **责任人** | 严维序(opengineer) |
|
||||||
|
| **版本** | v1.0 |
|
||||||
|
| **创建日期** | 2026-06-24 |
|
||||||
|
| **最后更新** | 2026-06-24 |
|
||||||
|
| **标签** | 故障排查, 运维, 排障 |
|
||||||
|
|
||||||
|
## 概述
|
||||||
|
|
||||||
|
本手册汇总 BizWings 环境中常见的系统与服务故障定位方法和修复方案。覆盖 SSH 连接、Nginx、数据库、磁盘、Docker 等核心场景。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 一、SSH 连接故障
|
||||||
|
|
||||||
|
### 1.1 连接超时
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 诊断步骤
|
||||||
|
ssh -vvv root@<ip> -p <port> # 查看详细连接日志
|
||||||
|
ping <ip> # 检查网络连通性
|
||||||
|
nmap <ip> -p <port> # 检查端口状态
|
||||||
|
```
|
||||||
|
|
||||||
|
**常见原因**:
|
||||||
|
- 目标服务器防火墙未开放端口
|
||||||
|
- 源 IP 未加入白名单
|
||||||
|
- 服务器负载过高,sshd 响应慢
|
||||||
|
|
||||||
|
**解决方案**:
|
||||||
|
1. 检查服务器防火墙:`iptables -L -n` 或 `ufw status`
|
||||||
|
2. 检查 sshd 是否运行:`systemctl status sshd`
|
||||||
|
3. 检查负载:`top -n1 | head -5`
|
||||||
|
|
||||||
|
### 1.2 认证失败
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 诊断步骤
|
||||||
|
ssh -p <port> root@<ip> # 尝试密码登录
|
||||||
|
# Permission denied (publickey,password) 提示
|
||||||
|
```
|
||||||
|
|
||||||
|
**常见原因**:
|
||||||
|
- 密码错误(检查 TOOLS.md 中记录)
|
||||||
|
- SSH 密钥认证配置错误
|
||||||
|
- `/etc/ssh/sshd_config` 中 `PasswordAuthentication no`
|
||||||
|
|
||||||
|
**解决方案**:
|
||||||
|
1. 确认密码与 TOOLS.md 一致
|
||||||
|
2. 检查 `sshd_config`:`grep PasswordAuthentication /etc/ssh/sshd_config`
|
||||||
|
3. 临时允许密码登录:`sed -i 's/PasswordAuthentication no/PasswordAuthentication yes/' /etc/ssh/sshd_config && systemctl reload sshd`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 二、Nginx 服务异常
|
||||||
|
|
||||||
|
### 2.1 Nginx 启动失败 / 卡在 activating
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 诊断步骤
|
||||||
|
systemctl status nginx # 查看状态
|
||||||
|
journalctl -u nginx --no-pager -n 50 # 查看日志
|
||||||
|
nginx -t # 配置语法检查
|
||||||
|
```
|
||||||
|
|
||||||
|
**根因(经验)**:进程残留导致端口占用
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 修复
|
||||||
|
pkill -9 nginx # 强制清理残留进程
|
||||||
|
sleep 2
|
||||||
|
systemctl start nginx # 重新启动
|
||||||
|
systemctl status nginx # 确认状态
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2.2 502 Bad Gateway
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 诊断步骤
|
||||||
|
curl -I http://localhost:<upstream-port> # 检查上游服务
|
||||||
|
ss -tlnp | grep <upstream-port> # 检查端口监听
|
||||||
|
systemctl status <upstream-service> # 检查上游进程
|
||||||
|
```
|
||||||
|
|
||||||
|
**常见原因**:
|
||||||
|
- 上游服务未启动或崩溃
|
||||||
|
- 连接池耗尽
|
||||||
|
|
||||||
|
**解决方案**:
|
||||||
|
1. 重启上游服务:`systemctl restart <service>`
|
||||||
|
2. 检查 `upstream` 配置是否正确
|
||||||
|
|
||||||
|
### 2.3 日志轮转失败
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 诊断步骤
|
||||||
|
cat /var/log/nginx/error.log | head # 查看是否有日志无法写入
|
||||||
|
ls -la /var/log/nginx/ # 查看日志文件
|
||||||
|
/usr/sbin/logrotate -d /etc/logrotate.d/nginx # 测试 logrotate
|
||||||
|
```
|
||||||
|
|
||||||
|
**修复方案**:
|
||||||
|
```bash
|
||||||
|
# 修改 /etc/logrotate.d/nginx 中的 postrotate 脚本
|
||||||
|
# 将 invoke-rc.d nginx rotate 改为:
|
||||||
|
postrotate
|
||||||
|
systemctl reload nginx
|
||||||
|
endscript
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 三、数据库连接故障
|
||||||
|
|
||||||
|
### 3.1 MySQL 连接失败
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 诊断步骤
|
||||||
|
mysql -h <host> -P <port> -u root -p # 测试连接
|
||||||
|
telnet <host> <port> # 检查端口
|
||||||
|
systemctl status mysql # 检查服务
|
||||||
|
```
|
||||||
|
|
||||||
|
**常见原因**:
|
||||||
|
- 服务未运行
|
||||||
|
- 防火墙未放行 3306 端口
|
||||||
|
- 用户权限 / host 限制
|
||||||
|
- 连接数超限
|
||||||
|
|
||||||
|
**解决方案**:
|
||||||
|
```bash
|
||||||
|
# 检查连接数
|
||||||
|
mysql -e "SHOW VARIABLES LIKE 'max_connections';"
|
||||||
|
mysql -e "SHOW PROCESSLIST;"
|
||||||
|
|
||||||
|
# 检查用户权限
|
||||||
|
mysql -e "SELECT user, host FROM mysql.user WHERE user='root';"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.2 MySQL 空间不足
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 诊断
|
||||||
|
df -h # 磁盘空间
|
||||||
|
mysql -e "SELECT table_schema, ROUND(SUM(data_length+index_length)/1024/1024,2) AS size_mb FROM information_schema.tables GROUP BY table_schema ORDER BY size_mb DESC;"
|
||||||
|
```
|
||||||
|
|
||||||
|
**解决方案**:
|
||||||
|
- 清理过期 binlog:`PURGE BINARY LOGS BEFORE DATE_SUB(NOW(), INTERVAL 7 DAY);`
|
||||||
|
- 清理临时表
|
||||||
|
- 扩展磁盘
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 四、磁盘空间告警
|
||||||
|
|
||||||
|
### 4.1 诊断
|
||||||
|
|
||||||
|
```bash
|
||||||
|
df -h # 查看各分区使用率
|
||||||
|
du -sh /* 2>/dev/null | sort -rh | head -10 # 找到大文件目录
|
||||||
|
find / -type f -size +100M -exec ls -lh {} \; 2>/dev/null # 大文件定位
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.2 清理方案
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Docker 日志和镜像清理
|
||||||
|
docker system prune -af --volumes # 清理未使用的 Docker 资源
|
||||||
|
|
||||||
|
# 系统日志轮转
|
||||||
|
journalctl --vacuum-time=7d # 清理 7 天前的 journal 日志
|
||||||
|
|
||||||
|
# 应用日志归档
|
||||||
|
find /var/log -name "*.log" -mtime +30 -exec gzip {} \; # 压缩旧日志
|
||||||
|
find /var/log -name "*.gz" -mtime +90 -delete # 删除 90 天前的压缩日志
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 五、Docker 容器异常
|
||||||
|
|
||||||
|
### 5.1 容器停止
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker ps -a | grep <container> # 查看容器状态
|
||||||
|
docker logs <container> --tail 50 # 查看最近日志
|
||||||
|
```
|
||||||
|
|
||||||
|
**修复**:
|
||||||
|
```bash
|
||||||
|
docker start <container> # 手动启动
|
||||||
|
docker compose -f <path> up -d # 使用 Compose 重启
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5.2 Docker API 无响应
|
||||||
|
|
||||||
|
```bash
|
||||||
|
systemctl status docker # 检查 Docker 服务
|
||||||
|
journalctl -u docker --no-pager -n 50 # 查看 Docker 日志
|
||||||
|
```
|
||||||
|
|
||||||
|
**修复**:
|
||||||
|
```bash
|
||||||
|
systemctl restart docker # 重启 Docker 守护进程
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 六、系统进程故障
|
||||||
|
|
||||||
|
### 6.1 端口被占用
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ss -tlnp | grep <port> # 查看占用端口的进程
|
||||||
|
fuser -k <port>/tcp # 强制释放端口
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6.2 systemd 服务异常
|
||||||
|
|
||||||
|
```bash
|
||||||
|
systemctl status <service> # 检查状态
|
||||||
|
journalctl -u <service> --no-pager -n 100 # 查看服务日志
|
||||||
|
|
||||||
|
# 常用修复
|
||||||
|
systemctl daemon-reload # 重载 unit 文件
|
||||||
|
systemctl restart <service> # 重启
|
||||||
|
systemctl enable <service> # 设置开机自启
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 七、日志分析工具
|
||||||
|
|
||||||
|
### 7.1 常用命令
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 实时日志跟踪
|
||||||
|
tail -f /var/log/<app>/access.log
|
||||||
|
|
||||||
|
# 错误过滤
|
||||||
|
grep -i "error\|exception\|failed" /var/log/<app>/app.log | tail -50
|
||||||
|
|
||||||
|
# 时间范围过滤
|
||||||
|
awk '/2026-06-24 10:00/,/2026-06-24 11:00/' /var/log/<app>/app.log
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7.2 关键检查点
|
||||||
|
|
||||||
|
| 故障表现 | 优先检查 | 常见根因 |
|
||||||
|
|----------|----------|----------|
|
||||||
|
| 服务无响应 | systemctl status | 进程 OOM / 崩溃 |
|
||||||
|
| API 返回错误 | 应用日志 + Nginx 日志 | 代码 bug / 上游依赖异常 |
|
||||||
|
| 高延迟 | top + ss + 应用日志 | 资源争抢 / 死锁 |
|
||||||
|
| 数据库异常 | MySQL error log | 慢查询 / 连接数超限 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 相关条目
|
||||||
|
|
||||||
|
- [部署流程_v1.0.md](部署流程_v1.0.md)
|
||||||
|
- [服务器运维标准_v1.0.md](服务器运维标准_v1.0.md)
|
||||||
|
|
||||||
|
## 变更记录
|
||||||
|
|
||||||
|
| 日期 | 版本 | 变更说明 | 变更人 |
|
||||||
|
|------|------|----------|--------|
|
||||||
|
| 2026-06-24 | v1.0 | 初始创建 | 严维序 |
|
||||||
@@ -0,0 +1,177 @@
|
|||||||
|
# 服务器运维标准
|
||||||
|
|
||||||
|
## 元数据
|
||||||
|
|
||||||
|
| 属性 | 值 |
|
||||||
|
|------|-----|
|
||||||
|
| **领域** | 运维 |
|
||||||
|
| **责任人** | 严维序(opengineer) |
|
||||||
|
| **版本** | v1.0 |
|
||||||
|
| **创建日期** | 2026-06-24 |
|
||||||
|
| **最后更新** | 2026-06-24 |
|
||||||
|
| **标签** | 运维, 监控, 巡检, 备份 |
|
||||||
|
|
||||||
|
## 概述
|
||||||
|
|
||||||
|
本文档定义 BizWings 团队所有服务器的日常运维标准,包括巡检频率、监控指标、备份策略和安全基线。适用于所有生产环境服务器(阿里云 / 家庭内网 / HP 服务器)。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 一、服务器巡检标准
|
||||||
|
|
||||||
|
### 1.1 巡检频率
|
||||||
|
|
||||||
|
| 类型 | 频率 | 执行方式 |
|
||||||
|
|------|------|----------|
|
||||||
|
| 心跳自检 | 每 10 分钟 | openclaw 心跳自动巡检 |
|
||||||
|
| 深度巡检 | 每日一次 | 手动执行 `python3 $SCRIPTS/heartbeat_helper.py opengineer` |
|
||||||
|
| 全量巡检 | 每周一次 | 逐个检查全部服务器 |
|
||||||
|
|
||||||
|
### 1.2 巡检清单
|
||||||
|
|
||||||
|
#### 资源负载
|
||||||
|
```bash
|
||||||
|
# 磁盘使用率(警告 > 80%,严重 > 90%)
|
||||||
|
df -h | grep -v tmpfs
|
||||||
|
|
||||||
|
# CPU 负载
|
||||||
|
uptime
|
||||||
|
|
||||||
|
# 内存使用
|
||||||
|
free -h
|
||||||
|
|
||||||
|
# 网络 IO
|
||||||
|
sar -n DEV 1 3
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 服务状态
|
||||||
|
```bash
|
||||||
|
# 核心服务清单(按实际部署确认)
|
||||||
|
systemctl status nginx mysql docker sshd
|
||||||
|
|
||||||
|
# Docker 容器健康
|
||||||
|
docker ps | grep -c "Up"
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 日志异常
|
||||||
|
```bash
|
||||||
|
# 最近 10 分钟的错误日志
|
||||||
|
journalctl --since "10 min ago" -p err --no-pager | tail -20
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 二、监控指标定义
|
||||||
|
|
||||||
|
### 2.1 告警阈值
|
||||||
|
|
||||||
|
| 指标 | 警告 (WARN) | 严重 (CRIT) | 处理 |
|
||||||
|
|------|-------------|-------------|------|
|
||||||
|
| 磁盘使用率 | > 80% | > 90% | 清理日志 / 扩容 |
|
||||||
|
| CPU 负载 (1min) | > 4.0 | > 8.0 | 检查异常进程 |
|
||||||
|
| 内存使用率 | > 85% | > 95% | 检查 OOM 风险 |
|
||||||
|
| 根分区 inode | > 80% | > 90% | 清理小文件 |
|
||||||
|
| 服务进程 | 停止 | — | 重启服务 |
|
||||||
|
| 端口监听 | 消失 | — | 检查服务状态 |
|
||||||
|
| Docker 容器 | 非 Up | — | docker start / compose up |
|
||||||
|
|
||||||
|
### 2.2 日志监控
|
||||||
|
|
||||||
|
- 系统日志:`journalctl -p err` 重点关注
|
||||||
|
- 应用日志:`error`, `exception`, `failed`, `timeout` 关键词监控
|
||||||
|
- Nginx 日志:5xx 错误率 > 1% 时触发调查
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 三、备份策略
|
||||||
|
|
||||||
|
### 3.1 数据库备份
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# MySQL 全量备份(建议每日凌晨执行)
|
||||||
|
mysqldump --all-databases --single-transaction --quick | gzip > /backup/db/all-$(date +%Y%m%d).sql.gz
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.2 配置备份
|
||||||
|
- 服务器配置文件:`/backup/conf/<server>/` 目录
|
||||||
|
- 每次变更前执行:`cp <config> <config>.$(date +%Y%m%d-%H%M%S).bak`
|
||||||
|
|
||||||
|
### 3.3 Docker 数据备份
|
||||||
|
```bash
|
||||||
|
# 思源笔记备份(已配置每日 3:00)
|
||||||
|
tar czf /backup/siyuan/siyuan-data-$(date +%Y%m%d).tar.gz -C <data-dir> .
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.4 备份保留策略
|
||||||
|
|
||||||
|
| 类型 | 保留期限 |
|
||||||
|
|------|----------|
|
||||||
|
| 数据库全量备份 | 30 天 |
|
||||||
|
| 配置备份 | 90 天 |
|
||||||
|
| Docker 数据 | 7 天 |
|
||||||
|
| 日志归档 | 90 天 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 四、变更管理标准
|
||||||
|
|
||||||
|
### 4.1 变更准入
|
||||||
|
|
||||||
|
- ✅ 每次变更前必须备份原始文件
|
||||||
|
- ✅ 高危操作(防火墙、内核、数据库)必须保留回滚方案
|
||||||
|
- ✅ 变更前评估影响范围
|
||||||
|
- ✅ 变更后验证服务状态
|
||||||
|
- ❌ 禁止在无备份的情况下直接修改生产配置
|
||||||
|
- ❌ 禁止在高峰时段执行非紧急变更
|
||||||
|
|
||||||
|
### 4.2 变更分级
|
||||||
|
|
||||||
|
| 级别 | 示例 | 要求 |
|
||||||
|
|------|------|------|
|
||||||
|
| 低风险 | 普通应用更新 | 备份 → 部署 → 验证 |
|
||||||
|
| 中风险 | 配置修改 | 备份 → 预演 → 部署 → 验证 |
|
||||||
|
| 高风险 | 内核 / 防火墙 / 数据库 | 备份 → 预演 → 通知 → 部署 → 验证 → 监控 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 五、安全基线
|
||||||
|
|
||||||
|
### 5.1 基本要求
|
||||||
|
|
||||||
|
- [ ] SSH 禁止 root 密码登录(高风险服务器)
|
||||||
|
- [ ] 防火墙最小权限原则
|
||||||
|
- [ ] 非必要端口不对外开放
|
||||||
|
- [ ] 定期更新系统安全补丁
|
||||||
|
- [ ] 日志审计开启
|
||||||
|
|
||||||
|
### 5.2 密码管理
|
||||||
|
|
||||||
|
- 服务器密码统一记录在 TOOLS.md
|
||||||
|
- 数据库密码统一管理
|
||||||
|
- 禁止在代码中硬编码密码
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 六、服务器清单与分类
|
||||||
|
|
||||||
|
| 环境 | 服务器数 | 用途 | 巡检频率 |
|
||||||
|
|------|----------|------|----------|
|
||||||
|
| 阿里云生产 | 3 | 应用服务、数据库 | 每次心跳 |
|
||||||
|
| 家庭内网生产 | 4 | 应用、数据库、PVE | 每次心跳 |
|
||||||
|
| HP 测试 | 3 | 测试、NAS | 每日 |
|
||||||
|
| 树莓派 | 1 | 辅助设备 | 每日 |
|
||||||
|
|
||||||
|
详细清单见 TOOLS.md「SSH/WinRM 服务器清单」
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 相关条目
|
||||||
|
|
||||||
|
- [部署流程_v1.0.md](部署流程_v1.0.md)
|
||||||
|
- [故障排查手册_v1.0.md](故障排查手册_v1.0.md)
|
||||||
|
|
||||||
|
## 变更记录
|
||||||
|
|
||||||
|
| 日期 | 版本 | 变更说明 | 变更人 |
|
||||||
|
|------|------|----------|--------|
|
||||||
|
| 2026-06-24 | v1.0 | 初始创建 | 严维序 |
|
||||||
@@ -0,0 +1,202 @@
|
|||||||
|
# 服务部署流程 SOP
|
||||||
|
|
||||||
|
## 元数据
|
||||||
|
|
||||||
|
| 属性 | 值 |
|
||||||
|
|------|-----|
|
||||||
|
| **领域** | 运维 |
|
||||||
|
| **责任人** | 严维序(opengineer) |
|
||||||
|
| **版本** | v1.0 |
|
||||||
|
| **创建日期** | 2026-06-24 |
|
||||||
|
| **最后更新** | 2026-06-24 |
|
||||||
|
| **标签** | 部署, 运维, SOP |
|
||||||
|
|
||||||
|
## 概述
|
||||||
|
|
||||||
|
本文档定义 BizWings 团队所有业务服务的部署流程标准,涵盖部署前检查、执行步骤、验证测试和回滚预案。适用于所有生产环境的代码部署与服务更新。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 一、部署前置检查
|
||||||
|
|
||||||
|
### 1.1 代码准备
|
||||||
|
|
||||||
|
- [ ] 代码已合并到目标分支(main / release)
|
||||||
|
- [ ] PR 已通过 Code Review 并合并
|
||||||
|
- [ ] 本地或 CI 构建通过(编译无报错)
|
||||||
|
- [ ] 版本号已更新(如有)
|
||||||
|
|
||||||
|
### 1.2 环境检查
|
||||||
|
|
||||||
|
- [ ] 目标服务器磁盘空间充足(> 剩余 20%)
|
||||||
|
- [ ] CPU / 内存负载正常(< 80%)
|
||||||
|
- [ ] 网络连通性:本机 → 目标服务器可达
|
||||||
|
- [ ] 目标端口未被占用
|
||||||
|
- [ ] 依赖服务(数据库 / 中间件)运行正常
|
||||||
|
|
||||||
|
### 1.3 备份准备
|
||||||
|
|
||||||
|
- [ ] **配置备份**:服务器配置文件备份到 `/backup/conf/` 目录
|
||||||
|
- [ ] **数据库备份**:涉及数据库变更,先执行 `mysqldump` 全量备份
|
||||||
|
- [ ] **当前版本标记**:记录当前运行版本号或 Git commit hash
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 二、部署执行步骤
|
||||||
|
|
||||||
|
### 2.1 文件分发
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 标准部署(SSH + scp/rsync)
|
||||||
|
scp -P <port> ./dist/app root@<server>:/opt/app/
|
||||||
|
# 或使用 rsync 增量同步
|
||||||
|
rsync -avz --delete -e "ssh -p <port>" ./dist/ root@<server>:/opt/app/
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2.2 服务更新
|
||||||
|
|
||||||
|
#### 方式 A:systemd 服务
|
||||||
|
```bash
|
||||||
|
# 1. 停止服务
|
||||||
|
systemctl stop <service-name>
|
||||||
|
|
||||||
|
# 2. 备份旧版本(如有必要)
|
||||||
|
mv /opt/app/<app> /opt/app/<app>.bak
|
||||||
|
|
||||||
|
# 3. 放置新版本
|
||||||
|
cp /tmp/<app> /opt/app/<app>
|
||||||
|
chmod +x /opt/app/<app>
|
||||||
|
|
||||||
|
# 4. 重启服务
|
||||||
|
systemctl start <service-name>
|
||||||
|
systemctl status <service-name>
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 方式 B:Docker 容器
|
||||||
|
```bash
|
||||||
|
# 1. 拉取新镜像
|
||||||
|
docker pull <registry>/<image>:<tag>
|
||||||
|
|
||||||
|
# 2. 停止旧容器
|
||||||
|
docker stop <container-name>
|
||||||
|
docker rm <container-name>
|
||||||
|
|
||||||
|
# 3. 启动新容器
|
||||||
|
docker run -d --name <container-name> \
|
||||||
|
--restart unless-stopped \
|
||||||
|
-p <host-port>:<container-port> \
|
||||||
|
<registry>/<image>:<tag>
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 方式 C:Nginx 反向代理更新
|
||||||
|
```bash
|
||||||
|
# 更新上游配置后重载
|
||||||
|
nginx -t # 语法检查
|
||||||
|
systemctl reload nginx # 热重载
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2.3 配置变更
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. 备份当前配置
|
||||||
|
cp /etc/<app>/config.yml /etc/<app>/config.yml.$(date +%Y%m%d-%H%M%S)
|
||||||
|
|
||||||
|
# 2. 修改配置
|
||||||
|
vim /etc/<app>/config.yml
|
||||||
|
|
||||||
|
# 3. 重启服务使配置生效
|
||||||
|
systemctl restart <service-name>
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 三、部署验证
|
||||||
|
|
||||||
|
### 3.1 连通性验证
|
||||||
|
```bash
|
||||||
|
# 服务端口监听确认
|
||||||
|
ss -tlnp | grep <port>
|
||||||
|
|
||||||
|
# HTTP 服务健康检查
|
||||||
|
curl -s -o /dev/null -w "%{http_code}" http://localhost:<port>/health
|
||||||
|
# 预期返回:200
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.2 功能验证
|
||||||
|
|
||||||
|
- [ ] API 基础功能运行正常
|
||||||
|
- [ ] 日志无新增 ERROR 级别报错
|
||||||
|
- [ ] 数据库连接正常
|
||||||
|
- [ ] 前端页面(如有)可正常加载
|
||||||
|
|
||||||
|
### 3.3 监控确认
|
||||||
|
|
||||||
|
- [ ] Prometheus / Grafana 指标正常
|
||||||
|
- [ ] 日志系统(如有)已捕获新日志
|
||||||
|
- [ ] 告警规则未被触发
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 四、回滚方案
|
||||||
|
|
||||||
|
### 4.1 代码回滚
|
||||||
|
```bash
|
||||||
|
# Git 回滚到上一版本
|
||||||
|
cd /opt/app/repo
|
||||||
|
git revert HEAD --no-edit
|
||||||
|
git push
|
||||||
|
# 重新执行部署
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.2 文件回滚
|
||||||
|
```bash
|
||||||
|
# 恢复备份文件
|
||||||
|
mv /opt/app/<app>.bak /opt/app/<app>
|
||||||
|
systemctl restart <service-name>
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.3 数据库回滚
|
||||||
|
```bash
|
||||||
|
# 导入备份
|
||||||
|
gunzip < /backup/db/<dbname>.$(date +%Y%m%d).sql.gz | mysql -u root -p<pass> <dbname>
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.4 回滚确认
|
||||||
|
- [ ] 旧版本服务运行正常
|
||||||
|
- [ ] 端口监听确认
|
||||||
|
- [ ] 用户无访问异常
|
||||||
|
- [ ] 记录回滚原因到工作日志
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 五、部署后记录
|
||||||
|
|
||||||
|
### 5.1 必填信息
|
||||||
|
|
||||||
|
| 项目 | 内容 |
|
||||||
|
|------|------|
|
||||||
|
| 部署时间 | YYYY-MM-DD HH:mm |
|
||||||
|
| 部署人 | 严维序(opengineer) |
|
||||||
|
| 部署内容 | [简要描述] |
|
||||||
|
| 版本 | commit hash / tag |
|
||||||
|
| 验证结果 | ✅/❌ 通过 |
|
||||||
|
| 回滚情况 | 无需回滚 / 已回滚(原因) |
|
||||||
|
|
||||||
|
### 5.2 记录位置
|
||||||
|
|
||||||
|
- 工作日志:`memory/YYYY-MM-DD.md`
|
||||||
|
- 任务记录:WorkBoard 相关卡片注释
|
||||||
|
- 知识更新:如部署暴露流程问题,更新本文档
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 相关条目
|
||||||
|
|
||||||
|
- [故障排查手册_v1.0.md](故障排查手册_v1.0.md)
|
||||||
|
- [服务器运维标准_v1.0.md](服务器运维标准_v1.0.md)
|
||||||
|
|
||||||
|
## 变更记录
|
||||||
|
|
||||||
|
| 日期 | 版本 | 变更说明 | 变更人 |
|
||||||
|
|------|------|----------|--------|
|
||||||
|
| 2026-06-24 | v1.0 | 初始创建 | 严维序 |
|
||||||
@@ -1,9 +1,9 @@
|
|||||||
# BIZ-13 智能体运行稳定性保障方案
|
# BIZ-13 智能体运行稳定性保障方案
|
||||||
|
|
||||||
> 版本:v1.0
|
> 版本:v1.1
|
||||||
> 编制:陆怀瑾(COO)
|
> 编制:陆怀瑾(COO)
|
||||||
> 日期:2026-06-22
|
> 日期:2026-06-22
|
||||||
> 状态:待审阅
|
> 状态:Phase 1 执行中(Vincent 已审阅同意)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -305,9 +305,10 @@ def retry_with_backoff(api_call, max_retries=3):
|
|||||||
## 七、实施步骤
|
## 七、实施步骤
|
||||||
|
|
||||||
### 阶段 1:心跳机制落地(本周)
|
### 阶段 1:心跳机制落地(本周)
|
||||||
- [ ] 更新所有 Agent 的 HEARTBEAT.md
|
- [x] 更新所有 Agent 的 HEARTBEAT.md(15/15 Agent 已完成)
|
||||||
- [ ] 配置定时任务(10 分钟)
|
- [x] 已创建分步实施子任务(BIZ-24 ~ BIZ-28,5个子任务)
|
||||||
- [ ] 测试超时检测
|
- [ ] 配置定时任务(10/15 分钟)→ BIZ-25,已分派 opengineer 严维序
|
||||||
|
- [ ] 测试超时检测 → BIZ-24 执行中
|
||||||
|
|
||||||
### 阶段 2:限流优化(下周)
|
### 阶段 2:限流优化(下周)
|
||||||
- [ ] 实现请求队列
|
- [ ] 实现请求队列
|
||||||
|
|||||||
@@ -0,0 +1,835 @@
|
|||||||
|
# BIZ-24 HEARTBEAT.md 增强模板方案
|
||||||
|
|
||||||
|
> Phase 1 of BIZ-13 运行稳定性保障方案
|
||||||
|
> 版本:v1.1(2026-06-22 优化:增加全任务源统一监控;已部署)
|
||||||
|
> 编制:陆怀瑾(COO)
|
||||||
|
> 日期:2026-06-22
|
||||||
|
> 状态:已部署
|
||||||
|
> 关联:[BIZ-13 运行稳定性保障方案](BIZ-13_运行稳定性保障方案.md)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 一、目标
|
||||||
|
|
||||||
|
为所有 Agent 的 HEARTBEAT.md 文件统一增强以下机制,解决任务停滞、运行异常与工作遗漏问题:
|
||||||
|
|
||||||
|
1. **全任务源统一监控** — 覆盖 OpenClaw WorkBoard + Multica Issues + 待办文档,避免工作遗漏
|
||||||
|
2. **禁止请示规则** — 消除"等待用户确认"导致的任务卡死
|
||||||
|
3. **超时检测规则** — 按 Agent 类型差异化配置心跳频率
|
||||||
|
4. **自动恢复规则** — 检测无进展时自动重新调度
|
||||||
|
5. **依赖检查前置** — 任务启动前强制检查所有依赖
|
||||||
|
6. **最大轮次限制** — 防止无限循环或资源耗尽
|
||||||
|
|
||||||
|
### 1.1 为什么需要全任务源统一监控
|
||||||
|
|
||||||
|
当前 Agent 工作面临的任务来源是多平台的:
|
||||||
|
|
||||||
|
| 任务来源 | 平台/工具 | 查询方式 | 当前监控状态 |
|
||||||
|
|----------|-----------|----------|------------|
|
||||||
|
| WorkBoard 卡片 | OpenClaw workboard | `openclaw workboard list` | ✅ 已纳入 |
|
||||||
|
| 待办文档 | 各 Agent workspace 的 TODO.md / AGENTS.md | 文件读取 | ⚠️ 部分纳入 |
|
||||||
|
| Multica Issues | Multica 平台 | `multica issue list --assignee-id <id>` | ❌ 未纳入 |
|
||||||
|
|
||||||
|
**问题**:Multica Issues 中分配给 Agent 的任务当前完全不在心跳监控范围内,Agent 可能永远不会发现并执行这些任务,导致工作永久遗漏。
|
||||||
|
|
||||||
|
**对策**:每次心跳同步检查以上三个来源,确保无一遗漏。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 二、Agent 分类与参数配置
|
||||||
|
|
||||||
|
### 2.1 分类标准
|
||||||
|
|
||||||
|
| 分类 | 特征 | Agent |
|
||||||
|
|------|------|-------|
|
||||||
|
| 高频 Agent | 需频繁检查任务状态、全局监控 | secretary, coo |
|
||||||
|
| 开发 Agent | 执行开发/设计/部署等长周期任务 | projectmanager, productmanager, architect, costcodev, designer, opengineer |
|
||||||
|
| 业务 Agent | 执行专项业务任务 | taobaospecialist, contentspecialist, mediaspecialist, cvexpert, marketanalysis, lawyer |
|
||||||
|
|
||||||
|
### 2.2 参数配置矩阵
|
||||||
|
|
||||||
|
| 参数 | 高频 Agent | 开发 Agent | 业务 Agent |
|
||||||
|
|------|-----------|-----------|-----------|
|
||||||
|
| 心跳频率 | 10 分钟 | 15 分钟 | 15 分钟 |
|
||||||
|
| 最大轮次 | 50 轮 | 100 轮 | 30 轮 |
|
||||||
|
| 超时告警阈值 | 20 分钟无进展 | 30 分钟无进展 | 30 分钟无进展 |
|
||||||
|
| 自动恢复等待 | 30 分钟后重新调度 | 45 分钟后重新调度 | 45 分钟后重新调度 |
|
||||||
|
| 告警通知对象 | COO | COO + 创建者 | 创建者 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 三、六项增强规则详解
|
||||||
|
|
||||||
|
### 规则 0:全任务源统一监控
|
||||||
|
|
||||||
|
**问题**:Agent 的任务分布在多个平台(OpenClaw WorkBoard、Multica Issues、工作区待办文档),各平台独立存在,Agent 只监控其中一部分会导致工作任务被永久遗漏。
|
||||||
|
|
||||||
|
**规则文本**:
|
||||||
|
```markdown
|
||||||
|
## 📋 全任务源统一监控(每次心跳必检)
|
||||||
|
|
||||||
|
> **核心原则:发现任何来源的任务都必须立即执行,不得遗漏。**
|
||||||
|
> 你的工作任务可能存在于三个地方:OpenClaw WorkBoard、Multica Issues、本地待办文档。
|
||||||
|
|
||||||
|
### 任务源检查清单(按优先级)
|
||||||
|
|
||||||
|
#### 第一优先级:OpenClaw WorkBoard 卡片
|
||||||
|
|
||||||
|
\```bash
|
||||||
|
# 检查 WorkBoard 中分配给自己的待办卡片
|
||||||
|
openclaw workboard list --json 2>/dev/null | python3 -c "
|
||||||
|
import sys, json
|
||||||
|
data = json.load(sys.stdin)
|
||||||
|
my_cards = [c for c in data.get('cards', [])
|
||||||
|
if c.get('agentId') == '<your_agent_id>' 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 <your_multica_agent_uuid> --status todo --output json 2>/dev/null | python3 -c "
|
||||||
|
import sys, json
|
||||||
|
data = json.load(sys.stdin)
|
||||||
|
for issue in data:
|
||||||
|
print(f'MULTICA TODO: {issue[\"identifier\"]} [{issue.get(\"priority\",\"?\")}] {issue[\"title\"]}')
|
||||||
|
"
|
||||||
|
\```
|
||||||
|
|
||||||
|
#### 第三优先级:待办文档
|
||||||
|
|
||||||
|
\```bash
|
||||||
|
# 检查工作区待办文档(TODO.md 或 AGENTS.md 中未完成的任务)
|
||||||
|
grep -n '\[ \]' TODO.md AGENTS.md 2>/dev/null || echo "无待办文档"
|
||||||
|
\```
|
||||||
|
|
||||||
|
### 三源合并决策
|
||||||
|
|
||||||
|
```
|
||||||
|
心跳开始
|
||||||
|
↓
|
||||||
|
检查 WorkBoard 待办卡片
|
||||||
|
↓
|
||||||
|
检查 Multica Issues 待办
|
||||||
|
↓
|
||||||
|
检查待办文档
|
||||||
|
↓
|
||||||
|
合并去重(避免同一任务在不同来源重复出现)
|
||||||
|
↓
|
||||||
|
按优先级排序后依次执行
|
||||||
|
```
|
||||||
|
|
||||||
|
### Multica Issue 认领与执行流程
|
||||||
|
|
||||||
|
```
|
||||||
|
发现 Multica todo Issue(assignee 是自己)
|
||||||
|
↓
|
||||||
|
启动 Multica Runtime 执行任务
|
||||||
|
↓
|
||||||
|
完成后通过 multica issue comment add 汇报结果
|
||||||
|
↓
|
||||||
|
更新 issue status 为 in_review / done
|
||||||
|
```
|
||||||
|
|
||||||
|
### COO 专属:全平台积压巡检
|
||||||
|
|
||||||
|
作为 COO,还需要额外检查全平台的任务积压情况(不限自己):
|
||||||
|
|
||||||
|
\```bash
|
||||||
|
#!/bin/bash
|
||||||
|
# COO 全平台任务积压巡检脚本
|
||||||
|
|
||||||
|
echo "=== OpenClaw WorkBoard 全局积压 ==="
|
||||||
|
openclaw workboard list --json 2>/dev/null | python3 -c "
|
||||||
|
import sys, json
|
||||||
|
data = json.load(sys.stdin)
|
||||||
|
cards = data.get('cards', [])
|
||||||
|
todo = [c for c in cards if c.get('status') == 'todo']
|
||||||
|
inprog = [c for c in cards if c.get('status') == 'in_progress']
|
||||||
|
print(f' 待办: {len(todo)} | 进行中: {len(inprog)} | 总计: {len(cards)}')
|
||||||
|
if len(todo) > 5:
|
||||||
|
print(f' ⚠️ 积压告警:待办超过 5 个,需协调资源')
|
||||||
|
for c in todo[:10]:
|
||||||
|
print(f' {c[\"id\"][:8]} → {c.get(\"agentId\",\"?\")} - {c[\"title\"][:60]}')
|
||||||
|
"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "=== Multica Issues 全局积压 ==="
|
||||||
|
multica issue list --status todo --output json 2>/dev/null | python3 -c "
|
||||||
|
import sys, json
|
||||||
|
data = json.load(sys.stdin)
|
||||||
|
print(f' 待办: {len(data)}')
|
||||||
|
if len(data) > 5:
|
||||||
|
print(f' ⚠️ 积压告警:Multica 待办超过 5 个')
|
||||||
|
for issue in data[:10]:
|
||||||
|
print(f' {issue[\"identifier\"]} → {issue.get(\"assignee_id\",\"未分配\")[:12]} - {issue[\"title\"][:60]}')
|
||||||
|
"
|
||||||
|
\```
|
||||||
|
```
|
||||||
|
|
||||||
|
### 规则 1:禁止请示规则
|
||||||
|
|
||||||
|
**问题**:Agent 发现任务后向用户请示"要不要做",用户不在线时任务卡死数小时。
|
||||||
|
|
||||||
|
**规则文本**:
|
||||||
|
```markdown
|
||||||
|
## ⚠️ 禁止请示规则(最高优先级)
|
||||||
|
|
||||||
|
你在心跳中发现任何来源的任务后,必须立即执行,绝对禁止向用户请示!
|
||||||
|
|
||||||
|
原因:
|
||||||
|
- 用户在大多数时候并不在线,请示会导致任务卡死数小时
|
||||||
|
- 心跳是后台自动行为,用户没有义务实时响应你的请示
|
||||||
|
- 你的职责是"主动完成交付",而不是"等待指令"
|
||||||
|
|
||||||
|
正确做法:
|
||||||
|
1. 发现任何来源的待办任务(WorkBoard / Multica / 待办文档)
|
||||||
|
2. 立即认领并执行
|
||||||
|
3. 如遇信息不足,先按自己的最佳理解执行,执行中再调整
|
||||||
|
4. 任务完成后,通过对应平台汇报结果
|
||||||
|
|
||||||
|
错误做法(绝对禁止):
|
||||||
|
- ❌ "我发现了一个任务,要不要做?"
|
||||||
|
- ❌ "这个任务需要更多信息,请告诉我..."
|
||||||
|
- ❌ "任务已完成,请确认是否符合要求"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 规则 2:超时检测规则
|
||||||
|
|
||||||
|
**问题**:Agent 执行到某一步后卡住,长时间无输出,无任何监告。
|
||||||
|
|
||||||
|
**规则文本**:
|
||||||
|
|
||||||
|
高频 Agent 版:
|
||||||
|
```markdown
|
||||||
|
## ⏱️ 超时检测规则
|
||||||
|
|
||||||
|
### 心跳频率:10 分钟
|
||||||
|
每次心跳执行以下检测:
|
||||||
|
1. 检查所有平台进行中任务的最新更新时间(WorkBoard + Multica)
|
||||||
|
2. 如超过 20 分钟无进展 → 标记为"疑似超时"
|
||||||
|
3. 疑似超时 → 立即追加一次完整心跳,尝试推进
|
||||||
|
4. 如确认超时 → 进入自动恢复流程
|
||||||
|
|
||||||
|
### 跨平台超时检测脚本
|
||||||
|
\```bash
|
||||||
|
# 检查进行中任务是否超时(WorkBoard + Multica)
|
||||||
|
echo "=== WorkBoard 超时检测 ==="
|
||||||
|
openclaw workboard list --json 2>/dev/null | python3 -c "
|
||||||
|
import sys, json, time
|
||||||
|
data = json.load(sys.stdin)
|
||||||
|
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 "=== 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\"]}')
|
||||||
|
"
|
||||||
|
\```
|
||||||
|
```
|
||||||
|
|
||||||
|
开发 Agent 版(差异部分):
|
||||||
|
```markdown
|
||||||
|
### 心跳频率:15 分钟
|
||||||
|
每次心跳执行以下检测:
|
||||||
|
1. 检查所有平台进行中任务的最新更新时间(WorkBoard + Multica)
|
||||||
|
2. 如超过 30 分钟无进展 → 标记为"疑似超时"
|
||||||
|
```
|
||||||
|
|
||||||
|
业务 Agent 版(差异部分):
|
||||||
|
```markdown
|
||||||
|
### 心跳频率:15 分钟
|
||||||
|
每次心跳执行以下检测:
|
||||||
|
1. 检查所有平台进行中任务的最新更新时间(WorkBoard + Multica)
|
||||||
|
2. 如超过 30 分钟无进展 → 标记为"疑似超时"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 规则 3:自动恢复规则
|
||||||
|
|
||||||
|
**问题**:检测到无进展后没有自动恢复手段,任务永久停滞。
|
||||||
|
|
||||||
|
**规则文本**:
|
||||||
|
```markdown
|
||||||
|
## 🔄 自动恢复规则
|
||||||
|
|
||||||
|
### 恢复流程
|
||||||
|
```
|
||||||
|
检测到超时(跨平台无进展超阈值)
|
||||||
|
↓
|
||||||
|
步骤 1:追加一次完整心跳,尝试推进任务
|
||||||
|
↓
|
||||||
|
步骤 2:检查任务状态
|
||||||
|
↓
|
||||||
|
┌─────────────┴─────────────┐
|
||||||
|
│ │
|
||||||
|
有进展 仍无进展
|
||||||
|
│ │
|
||||||
|
重置超时计数器 步骤 3:通知 COO/创建者
|
||||||
|
│ │
|
||||||
|
继续执行 步骤 4:通过对应平台标记 blocked
|
||||||
|
│
|
||||||
|
步骤 5:重新调度(分配备用 Agent 或
|
||||||
|
等待人工介入)
|
||||||
|
```
|
||||||
|
|
||||||
|
### 自动恢复触发条件
|
||||||
|
- 高频 Agent:超 30 分钟无进展 → 自动重新调度
|
||||||
|
- 开发 Agent:超 45 分钟无进展 → 自动重新调度
|
||||||
|
- 业务 Agent:超 45 分钟无进展 → 自动重新调度
|
||||||
|
|
||||||
|
### 跨平台恢复操作
|
||||||
|
**WorkBoard 任务**:
|
||||||
|
1. 添加评论说明超时原因
|
||||||
|
2. 释放 Agent 认领(release claim)
|
||||||
|
3. 通知 COO 重新分配
|
||||||
|
|
||||||
|
**Multica Issue**:
|
||||||
|
1. `multica issue comment add` 说明超时原因
|
||||||
|
2. `multica issue status <id> blocked`
|
||||||
|
3. 通知 COO 重新分配
|
||||||
|
|
||||||
|
**待办文档任务**:
|
||||||
|
1. 在原文档中标注超时状态
|
||||||
|
2. 如可转为 WorkBoard 卡片 → 创建卡片并通知 COO
|
||||||
|
```
|
||||||
|
|
||||||
|
### 规则 4:依赖检查前置
|
||||||
|
|
||||||
|
**问题**:任务开始后才发现依赖未满足,浪费 Agent 时间,且可能导致循环等待。
|
||||||
|
|
||||||
|
**规则文本**:
|
||||||
|
```markdown
|
||||||
|
## 🔗 依赖检查前置规则
|
||||||
|
|
||||||
|
### 任务启动前强制检查
|
||||||
|
每次认领或启动任务前,必须执行依赖检查:
|
||||||
|
|
||||||
|
**WorkBoard 任务**:
|
||||||
|
1. 读取任务的 depends_on 字段
|
||||||
|
2. 逐一检查每个依赖任务的状态
|
||||||
|
3. 所有依赖 ready → 可以启动
|
||||||
|
4. 任一依赖未完成 → 禁止启动,标记为 blocked
|
||||||
|
|
||||||
|
**Multica Issue**:
|
||||||
|
1. 读取 issue 的 parent_issue_id
|
||||||
|
2. 检查父 issue 状态
|
||||||
|
3. 父 issue 未完成 → 禁止启动
|
||||||
|
|
||||||
|
### 检查脚本
|
||||||
|
|
||||||
|
#### WorkBoard 依赖检查
|
||||||
|
\```bash
|
||||||
|
openclaw workboard read <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:
|
||||||
|
print(f'依赖: {dep[\"id\"]} → 状态: {dep.get(\"status\", \"?\")}')
|
||||||
|
if dep.get('status') != 'done':
|
||||||
|
print(f'⛔ WB 依赖未满足,禁止启动 {card[\"id\"][:8]}')
|
||||||
|
sys.exit(1)
|
||||||
|
print('✅ 所有 WB 依赖已满足')
|
||||||
|
else:
|
||||||
|
print('✅ 无 WB 依赖,可以启动')
|
||||||
|
"
|
||||||
|
\```
|
||||||
|
|
||||||
|
#### Multica 依赖检查
|
||||||
|
\```bash
|
||||||
|
multica issue get <issue-id> --output json 2>/dev/null | python3 -c "
|
||||||
|
import sys, json
|
||||||
|
issue = json.load(sys.stdin)
|
||||||
|
parent_id = issue.get('parent_issue_id')
|
||||||
|
if parent_id:
|
||||||
|
import subprocess
|
||||||
|
result = subprocess.run(['multica', 'issue', 'get', parent_id, '--output', 'json'],
|
||||||
|
capture_output=True, text=True)
|
||||||
|
parent = json.loads(result.stdout)
|
||||||
|
if parent.get('status') != 'done':
|
||||||
|
print(f'⛔ MUL 父 Issue {parent[\"identifier\"]} 未完成,禁止启动')
|
||||||
|
sys.exit(1)
|
||||||
|
print(f'✅ 父 Issue {parent[\"identifier\"]} 已完成')
|
||||||
|
else:
|
||||||
|
print('✅ 无父 Issue 依赖,可以启动')
|
||||||
|
"
|
||||||
|
\```
|
||||||
|
|
||||||
|
### 依赖未满足时的处理
|
||||||
|
1. 不认领任务(保持 todo 状态)
|
||||||
|
2. 不在该任务上浪费心跳时间
|
||||||
|
3. 如超过等待阈值(高频 1h / 开发/业务 2h),通知依赖任务的执行者
|
||||||
|
```
|
||||||
|
|
||||||
|
### 规则 5:最大轮次限制
|
||||||
|
|
||||||
|
**问题**:Agent 陷入无限循环,反复执行相同逻辑无进展,持续消耗 API 配额。
|
||||||
|
|
||||||
|
**规则文本**:
|
||||||
|
|
||||||
|
高频 Agent 版:
|
||||||
|
```markdown
|
||||||
|
## 🛑 最大轮次限制
|
||||||
|
|
||||||
|
### 限制值:50 轮
|
||||||
|
单次任务执行不得超过 50 个对话轮次。
|
||||||
|
|
||||||
|
### 检测机制
|
||||||
|
- 每次心跳记录已消耗轮次
|
||||||
|
- 接近上限(80%)时发出预警
|
||||||
|
- 达到上限时自动暂停
|
||||||
|
|
||||||
|
### 超限处理
|
||||||
|
```
|
||||||
|
达到最大轮次
|
||||||
|
↓
|
||||||
|
1. 暂停任务执行
|
||||||
|
2. 记录已完成的步骤和未完成的部分
|
||||||
|
3. 通知 COO,附当前进度
|
||||||
|
4. COO 决定:重新分配 / 拆分任务 / 人工介入
|
||||||
|
```
|
||||||
|
|
||||||
|
### 跨平台轮次跟踪
|
||||||
|
- **WorkBoard**:通过 workboard_heartbeat 的 note 记录轮次
|
||||||
|
- **Multica**:通过 issue comment 记录轮次进度
|
||||||
|
- **待办文档**:在工作日志中记录
|
||||||
|
|
||||||
|
### 计数器维护
|
||||||
|
\```bash
|
||||||
|
# 每次心跳更新轮次计数
|
||||||
|
# 轮次数据存储在任务 metadata 或 comment 中
|
||||||
|
\```
|
||||||
|
```
|
||||||
|
|
||||||
|
开发 Agent 版(差异部分):
|
||||||
|
```markdown
|
||||||
|
### 限制值:100 轮
|
||||||
|
单次任务执行不得超过 100 个对话轮次。
|
||||||
|
```
|
||||||
|
|
||||||
|
业务 Agent 版(差异部分):
|
||||||
|
```markdown
|
||||||
|
### 限制值:30 轮
|
||||||
|
单次任务执行不得超过 30 个对话轮次。
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 四、HEARTBEAT.md 完整增强模板
|
||||||
|
|
||||||
|
### 4.1 高频 Agent 完整模板(secretary / coo)
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# HEARTBEAT.md - [Agent Name] 的心跳配置
|
||||||
|
|
||||||
|
## 📋 全任务源统一监控(每次心跳必检)
|
||||||
|
|
||||||
|
> **核心原则:发现任何来源的任务都必须立即执行,不得遗漏。**
|
||||||
|
|
||||||
|
### 三源检查
|
||||||
|
1. **OpenClaw WorkBoard** — workboard list → 查找 agent_id=自己 & status=todo
|
||||||
|
2. **Multica Issues** — issue list --assignee-id <uuid> --status todo
|
||||||
|
3. **待办文档** — 检查 TODO.md / AGENTS.md 中未完成的任务
|
||||||
|
|
||||||
|
### 合并去重 → 按优先级排序 → 依次执行
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||||
|
|
||||||
|
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||||
|
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||||
|
|
||||||
|
### 执行流程(严格执行,无需确认)
|
||||||
|
1. **三源检查待办** — WorkBoard + Multica + 待办文档
|
||||||
|
2. **立即执行,不得请示** — 发现待办后直接执行
|
||||||
|
3. **检查进行中任务** — 确认认领的任务状态
|
||||||
|
4. **完成任务** — 通过对应平台汇报结果
|
||||||
|
|
||||||
|
### ⚠️ 绝对禁止行为
|
||||||
|
- ❌ 不得问"要不要做这个任务"
|
||||||
|
- ❌ 不得等用户确认再执行
|
||||||
|
- ❌ 不得以"需要更多信息"为由拒绝执行
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⏱️ 超时检测规则
|
||||||
|
|
||||||
|
### 心跳频率:10 分钟
|
||||||
|
每次心跳跨平台执行以下检测:
|
||||||
|
1. 检查 WorkBoard 进行中任务的更新时间
|
||||||
|
2. 检查 Multica 进行中 issues 的更新时间
|
||||||
|
3. 超过 20 分钟无进展 → 标记为"疑似超时"
|
||||||
|
4. 疑似超时 → 追加一次完整心跳尝试推进
|
||||||
|
5. 确认超时 → 进入自动恢复流程
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔄 自动恢复规则
|
||||||
|
|
||||||
|
### 触发条件
|
||||||
|
- 超 30 分钟无进展 → 自动重新调度
|
||||||
|
|
||||||
|
### 恢复操作(按平台)
|
||||||
|
| 平台 | 操作 |
|
||||||
|
|------|------|
|
||||||
|
| WorkBoard | 添加评论 → release claim → 通知 COO |
|
||||||
|
| Multica | 添加评论 → status=blocked → 通知 COO |
|
||||||
|
| 待办文档 | 标注超时 → 转为卡片(可选) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔗 依赖检查前置规则
|
||||||
|
|
||||||
|
### 强制检查流程
|
||||||
|
1. 认领任务前,读取依赖字段(depends_on / parent_issue_id)
|
||||||
|
2. 逐一检查每个依赖任务的状态
|
||||||
|
3. 依赖未满足 → 不认领(保持 todo)
|
||||||
|
4. 超过等待阈值(1h)→ 通知依赖任务执行者
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🛑 最大轮次限制
|
||||||
|
|
||||||
|
### 限制值:50 轮
|
||||||
|
- 接近 80%(40 轮)→ 预警
|
||||||
|
- 达到上限 → 暂停,通知 COO
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🫀 心跳执行清单
|
||||||
|
|
||||||
|
1. ✅ **全任务源检查**:WorkBoard + Multica + 待办文档
|
||||||
|
2. ✅ 进行中任务超时检测(跨平台)
|
||||||
|
3. ✅ 依赖检查
|
||||||
|
4. ✅ 轮次计数器更新
|
||||||
|
5. ✅ 全平台积压巡检(仅 COO)
|
||||||
|
6. ✅ [Agent 专属检查项]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 全局关键规则
|
||||||
|
|
||||||
|
1. **心跳不打断对话** — 用户正在对话时延后执行
|
||||||
|
2. **非紧急事项延后汇报** — 等下一轮心跳或用户询问
|
||||||
|
3. **发现任务立即执行,不得请示**(任何来源)
|
||||||
|
4. **超时任务按自动恢复流程处理**(跨平台)
|
||||||
|
5. **依赖未满足不启动**
|
||||||
|
6. **达到轮次上限自动暂停**
|
||||||
|
7. **避免任务遗漏** — 三源必须全部检查,缺一不可
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.2 开发 Agent 完整模板(projectmanager / productmanager / architect / costcodev / designer / opengineer)
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# HEARTBEAT.md - [Agent Name] 的心跳配置
|
||||||
|
|
||||||
|
## 📋 全任务源统一监控(每次心跳必检)
|
||||||
|
|
||||||
|
> **核心原则:发现任何来源的任务都必须立即执行,不得遗漏。**
|
||||||
|
|
||||||
|
### 三源检查
|
||||||
|
1. **OpenClaw WorkBoard** — workboard list → 查找 agent_id=自己 & status=todo
|
||||||
|
2. **Multica Issues** — issue list --assignee-id <uuid> --status todo
|
||||||
|
3. **待办文档** — 检查 TODO.md / AGENTS.md 中未完成的任务
|
||||||
|
|
||||||
|
### 合并去重 → 按优先级排序 → 依次执行
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||||
|
|
||||||
|
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||||
|
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||||
|
|
||||||
|
### 执行流程(严格执行,无需确认)
|
||||||
|
1. **三源检查待办** — WorkBoard + Multica + 待办文档
|
||||||
|
2. **立即执行,不得请示** — 发现待办后直接执行
|
||||||
|
3. **检查进行中任务** — 确认认领的任务状态
|
||||||
|
4. **完成任务** — 通过对应平台汇报结果
|
||||||
|
|
||||||
|
### ⚠️ 绝对禁止行为
|
||||||
|
- ❌ 不得问"要不要做这个任务"
|
||||||
|
- ❌ 不得等用户确认再执行
|
||||||
|
- ❌ 不得以"需要更多信息"为由拒绝执行
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⏱️ 超时检测规则
|
||||||
|
|
||||||
|
### 心跳频率:15 分钟
|
||||||
|
每次心跳跨平台执行以下检测:
|
||||||
|
1. 检查 WorkBoard 进行中任务的更新时间
|
||||||
|
2. 检查 Multica 进行中 issues 的更新时间
|
||||||
|
3. 超过 30 分钟无进展 → 标记为"疑似超时"
|
||||||
|
4. 疑似超时 → 追加一次完整心跳尝试推进
|
||||||
|
5. 确认超时 → 进入自动恢复流程
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔄 自动恢复规则
|
||||||
|
|
||||||
|
### 触发条件
|
||||||
|
- 超 45 分钟无进展 → 自动重新调度
|
||||||
|
|
||||||
|
### 恢复操作(按平台)
|
||||||
|
| 平台 | 操作 |
|
||||||
|
|------|------|
|
||||||
|
| WorkBoard | 添加评论 → release claim → 通知 COO + 创建者 |
|
||||||
|
| Multica | 添加评论 → status=blocked → 通知 COO + 创建者 |
|
||||||
|
| 待办文档 | 标注超时 → 转为卡片(可选) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔗 依赖检查前置规则
|
||||||
|
|
||||||
|
### 强制检查流程
|
||||||
|
1. 认领任务前,读取依赖字段(depends_on / parent_issue_id)
|
||||||
|
2. 逐一检查每个依赖任务的状态
|
||||||
|
3. 依赖未满足 → 不认领(保持 todo)
|
||||||
|
4. 超过等待阈值(2h)→ 通知依赖任务执行者
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🛑 最大轮次限制
|
||||||
|
|
||||||
|
### 限制值:100 轮
|
||||||
|
- 接近 80%(80 轮)→ 预警
|
||||||
|
- 达到上限 → 暂停,记录日志
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🫀 心跳执行清单
|
||||||
|
|
||||||
|
1. ✅ **全任务源检查**:WorkBoard + Multica + 待办文档
|
||||||
|
2. ✅ 进行中任务超时检测(跨平台)
|
||||||
|
3. ✅ 依赖检查
|
||||||
|
4. ✅ 轮次计数器更新
|
||||||
|
5. ✅ [Agent 专属检查项]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 全局关键规则
|
||||||
|
|
||||||
|
1. **心跳不打断对话** — 用户正在对话时延后执行
|
||||||
|
2. **非紧急事项延后汇报** — 等下一轮心跳或用户询问
|
||||||
|
3. **发现任务立即执行,不得请示**(任何来源)
|
||||||
|
4. **超时任务按自动恢复流程处理**(跨平台)
|
||||||
|
5. **依赖未满足不启动**
|
||||||
|
6. **达到轮次上限自动暂停**
|
||||||
|
7. **避免任务遗漏** — 三源必须全部检查,缺一不可
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.3 业务 Agent 完整模板(taobaospecialist / contentspecialist / mediaspecialist / cvexpert / marketanalysis / lawyer)
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# HEARTBEAT.md - [Agent Name] 的心跳配置
|
||||||
|
|
||||||
|
## 📋 全任务源统一监控(每次心跳必检)
|
||||||
|
|
||||||
|
> **核心原则:发现任何来源的任务都必须立即执行,不得遗漏。**
|
||||||
|
|
||||||
|
### 三源检查
|
||||||
|
1. **OpenClaw WorkBoard** — workboard list → 查找 agent_id=自己 & status=todo
|
||||||
|
2. **Multica Issues** — issue list --assignee-id <uuid> --status todo
|
||||||
|
3. **待办文档** — 检查 TODO.md / AGENTS.md 中未完成的任务
|
||||||
|
|
||||||
|
### 合并去重 → 按优先级排序 → 依次执行
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||||
|
|
||||||
|
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||||
|
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||||
|
|
||||||
|
### 执行流程(严格执行,无需确认)
|
||||||
|
1. **三源检查待办** — WorkBoard + Multica + 待办文档
|
||||||
|
2. **立即执行,不得请示** — 发现待办后直接执行
|
||||||
|
3. **检查进行中任务** — 确认认领的任务状态
|
||||||
|
4. **完成任务** — 通过对应平台汇报结果
|
||||||
|
|
||||||
|
### ⚠️ 绝对禁止行为
|
||||||
|
- ❌ 不得问"要不要做这个任务"
|
||||||
|
- ❌ 不得等用户确认再执行
|
||||||
|
- ❌ 不得以"需要更多信息"为由拒绝执行
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⏱️ 超时检测规则
|
||||||
|
|
||||||
|
### 心跳频率:15 分钟
|
||||||
|
每次心跳跨平台执行以下检测:
|
||||||
|
1. 检查 WorkBoard 进行中任务的更新时间
|
||||||
|
2. 检查 Multica 进行中 issues 的更新时间
|
||||||
|
3. 超过 30 分钟无进展 → 标记为"疑似超时"
|
||||||
|
4. 疑似超时 → 追加一次完整心跳尝试推进
|
||||||
|
5. 确认超时 → 进入自动恢复流程
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔄 自动恢复规则
|
||||||
|
|
||||||
|
### 触发条件
|
||||||
|
- 超 45 分钟无进展 → 自动重新调度
|
||||||
|
|
||||||
|
### 恢复操作(按平台)
|
||||||
|
| 平台 | 操作 |
|
||||||
|
|------|------|
|
||||||
|
| WorkBoard | 添加评论 → release claim → 通知创建者 |
|
||||||
|
| Multica | 添加评论 → status=blocked → 通知创建者 |
|
||||||
|
| 待办文档 | 标注超时 → 转为卡片(可选) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔗 依赖检查前置规则
|
||||||
|
|
||||||
|
### 强制检查流程
|
||||||
|
1. 认领任务前,读取依赖字段(depends_on / parent_issue_id)
|
||||||
|
2. 逐一检查每个依赖任务的状态
|
||||||
|
3. 依赖未满足 → 不认领(保持 todo)
|
||||||
|
4. 超过等待阈值(2h)→ 通知依赖任务执行者
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🛑 最大轮次限制
|
||||||
|
|
||||||
|
### 限制值:30 轮
|
||||||
|
- 接近 80%(24 轮)→ 预警
|
||||||
|
- 达到上限 → 暂停,通知创建者
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🫀 心跳执行清单
|
||||||
|
|
||||||
|
1. ✅ **全任务源检查**:WorkBoard + Multica + 待办文档
|
||||||
|
2. ✅ 进行中任务超时检测(跨平台)
|
||||||
|
3. ✅ 依赖检查
|
||||||
|
4. ✅ 轮次计数器更新
|
||||||
|
5. ✅ [Agent 专属检查项]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ 全局关键规则
|
||||||
|
|
||||||
|
1. **心跳不打断对话** — 用户正在对话时延后执行
|
||||||
|
2. **非紧急事项延后汇报** — 等下一轮心跳或用户询问
|
||||||
|
3. **发现任务立即执行,不得请示**(任何来源)
|
||||||
|
4. **超时任务按自动恢复流程处理**(跨平台)
|
||||||
|
5. **依赖未满足不启动**
|
||||||
|
6. **达到轮次上限自动暂停**
|
||||||
|
7. **避免任务遗漏** — 三源必须全部检查,缺一不可
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 五、部署清单
|
||||||
|
|
||||||
|
### 5.1 各 Agent HEARTBEAT.md 更新状态
|
||||||
|
|
||||||
|
| Agent | 分类 | 模板版本 | 部署状态 | 部署人 |
|
||||||
|
|-------|------|---------|---------|--------|
|
||||||
|
| secretary (刘诗妮) | 高频 | 高频 Agent 模板 v1.1 | 待部署 | COO |
|
||||||
|
| coo (陆怀瑾) | 高频 | 高频 Agent 模板 v1.1 | 待部署 | COO |
|
||||||
|
| projectmanager (胡蓉) | 开发 | 开发 Agent 模板 v1.1 | 待部署 | COO |
|
||||||
|
| productmanager (沈路明) | 开发 | 开发 Agent 模板 v1.1 | 待部署 | COO |
|
||||||
|
| architect (梁思筑) | 开发 | 开发 Agent 模板 v1.1 | 待部署 | COO |
|
||||||
|
| costcodev (徐聪) | 开发 | 开发 Agent 模板 v1.1 | 待部署 | COO |
|
||||||
|
| designer (苏绘锦) | 开发 | 开发 Agent 模板 v1.1 | 待部署 | COO |
|
||||||
|
| opengineer (严维序) | 开发 | 开发 Agent 模板 v1.1 | 待部署 | COO |
|
||||||
|
| taobaospecialist (陆云帆) | 业务 | 业务 Agent 模板 v1.1 | 待部署 | COO |
|
||||||
|
| contentspecialist (文墨言) | 业务 | 业务 Agent 模板 v1.1 | 待部署 | COO |
|
||||||
|
| mediaspecialist (钟帧韵) | 业务 | 业务 Agent 模板 v1.1 | 待部署 | COO |
|
||||||
|
| cvexpert (程伯予) | 业务 | 业务 Agent 模板 v1.1 | 待部署 | COO |
|
||||||
|
| marketanalysis (顾析策) | 业务 | 业务 Agent 模板 v1.1 | 待部署 | COO |
|
||||||
|
| lawyer (苏慎) | 业务 | 业务 Agent 模板 v1.1 | 待部署 | COO |
|
||||||
|
|
||||||
|
### 5.2 部署步骤
|
||||||
|
|
||||||
|
1. **Vincent 审阅本方案** — 确认参数配置和多源监控范围
|
||||||
|
2. **收集各 Agent 的 Multica UUID** — 用于 `multica issue list --assignee-id <uuid>` 查询
|
||||||
|
3. **创建 HEARTBEAT.md 文件** — 按 v1.1 模板为每个 Agent 创建(填充实际 ID)
|
||||||
|
4. **配置心跳 cron** — 按分类配置定时任务
|
||||||
|
5. **部署到各 Agent workspace** — 将 HEARTBEAT.md 分发到对应 Agent 工作区
|
||||||
|
6. **验证** — 等待一轮完整心跳,检查三源任务是否全量覆盖
|
||||||
|
|
||||||
|
### 5.3 Agent Multica UUID 映射(已收集)
|
||||||
|
|
||||||
|
| Agent | OpenClaw Agent ID | Multica Agent UUID | 状态 |
|
||||||
|
|-------|-------------------|-------------------|------|
|
||||||
|
| secretary (刘诗妮) | secretary | b024fcdc-30ff-420d-b289-498041466e1b | ✅ |
|
||||||
|
| coo (陆怀瑾) | coo | 1c38b437-b54d-4784-bda3-29ce4c8a6722 | ✅ |
|
||||||
|
| projectmanager (胡蓉) | projectmanager | d877b8c3-b230-4073-b3f7-80e148cfdb71 | ✅ |
|
||||||
|
| productmanager (沈路明) | productmanager | a101fa88-d821-4839-9754-e04580d5fd68 | ✅ |
|
||||||
|
| architect (梁思筑) | architect | 40abd41a-62d0-416d-bc44-92c1f758d87a | ✅ |
|
||||||
|
| costcodev (徐聪) | costcodev | 46bdd4a6-5c64-475a-92ef-36a763602fa1 | ✅ |
|
||||||
|
| designer (苏锦绘) | designer | 13bd8968-cc2a-4934-90c7-957a2d3c09c2 | ✅ |
|
||||||
|
| opengineer (严维序) | opengineer | d3804433-9e2e-4199-a92b-a153049b3bc9 | ✅ |
|
||||||
|
| taobaospecialist (陆云帆) | taobaospecialist | e0f62d8f-9568-4f41-8ad4-b73d79a163a7 | ✅ |
|
||||||
|
| contentspecialist (文墨言) | contentspecialist | 8321b0bf-7d89-4ece-927a-0780f42ad396 | ✅ |
|
||||||
|
| mediaspecialist (钟帧韵) | mediaspecialist | e2b587d4-1d16-447c-8ad9-e2a01358ff0a | ✅ |
|
||||||
|
| cvexpert (程伯予) | cvexpert | 4a8696fd-6531-40da-8956-ef84d7ea3c43 | ✅ |
|
||||||
|
| marketanalysis (顾析策) | marketanalysis | 5ed91729-658f-4654-98f0-3e0313022002 | ✅ |
|
||||||
|
| lawyer (苏慎) | lawyer | 6fb0fbd2-16a6-4566-ba7a-d2c136baec25 | ✅ |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 六、交付物
|
||||||
|
|
||||||
|
- [x] HEARTBEAT.md 增强模板方案 v1.0(初始版本)
|
||||||
|
- [x] HEARTBEAT.md 增强模板方案 v1.1(优化:增加全任务源统一监控)
|
||||||
|
- [x] 各 Agent Multica UUID 映射表
|
||||||
|
- [x] 14 个 Agent 的独立 HEARTBEAT.md 文件(v1.1,已生成并部署到 workspace)
|
||||||
|
- [ ] 心跳 cron 配置脚本
|
||||||
|
- [ ] 部署验证报告
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 七、v1.1 变更说明
|
||||||
|
|
||||||
|
| 变更项 | v1.0 | v1.1 |
|
||||||
|
|--------|------|------|
|
||||||
|
| 监控范围 | 仅 WorkBoard 卡片 + 待办文档 | WorkBoard + Multica Issues + 待办文档(三源合一) |
|
||||||
|
| 规则数量 | 5 项 | 6 项(新增"规则 0: 全任务源统一监控") |
|
||||||
|
| 超时检测 | 仅 WorkBoard | 跨平台(WorkBoard + Multica) |
|
||||||
|
| 自动恢复 | 仅 WorkBoard 恢复操作 | 跨平台恢复(WorkBoard / Multica / 文档) |
|
||||||
|
| 依赖检查 | 仅 WorkBoard depends_on | 增加 Multica parent_issue_id |
|
||||||
|
| 心跳清单 | 4 项 | 6 项(增加全任务源检查 + 全平台巡检) |
|
||||||
|
| 轮次跟踪 | 单平台 | 跨平台轮次跟踪 |
|
||||||
|
| 全局规则 | 6 条 | 7 条(增加"避免任务遗漏") |
|
||||||
|
| 部署前置 | 无 | 需收集各 Agent 的 Multica UUID |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 八、风险与注意事项
|
||||||
|
|
||||||
|
| 风险 | 影响 | 缓解措施 |
|
||||||
|
|------|------|----------|
|
||||||
|
| 心跳自身卡死 | 所有监控失效 | 独立的 watchdog 进程监控心跳 cron 执行 |
|
||||||
|
| 自动恢复过于激进 | 正常长任务被中断 | 仅对超阈值且无进展的任务执行恢复 |
|
||||||
|
| 禁止请示导致错误执行 | Agent 自行决定后出错 | 关键决策(涉及外部资源、金钱)仍需暂停并通知 |
|
||||||
|
| 轮次限制过严 | 复杂任务被截断 | 接近上限时提前预警,COO 可手动扩展 |
|
||||||
|
| 三源任务重复 | 同一任务在 WB + Multica 都出现 | 合并去重逻辑,以 ID/标题匹配 |
|
||||||
|
| Multica CLI 不可用 | 无法检查 Multica 待办 | 降级为仅检查 WB + 文档,并在日志中记录异常 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
> ⚠️ 本方案需 Vincent 审阅后方可部署到各 Agent workspace。当前为模板方案 v1.1,存放于 EnterpriseArchitect/plans/ 目录。
|
||||||
@@ -0,0 +1,186 @@
|
|||||||
|
# HEARTBEAT.md 增强模板
|
||||||
|
|
||||||
|
> 版本:v2.0
|
||||||
|
> 来源:BIZ-13 运行稳定性保障方案
|
||||||
|
> 用途:为所有 Agent HEARTBEAT.md 增加运行稳定性保障能力
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 全局增强规则(所有 Agent 必须包含)
|
||||||
|
|
||||||
|
### 1. 🛡️ 超时检测与自动恢复
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## 🛡️ 超时检测与自动恢复
|
||||||
|
|
||||||
|
> **核心规则:每次心跳,检查自己是否有任务超时未完成。**
|
||||||
|
|
||||||
|
### 超时阈值
|
||||||
|
|
||||||
|
| Agent 类型 | 心跳频率 | 单任务超时 |
|
||||||
|
|------------|----------|------------|
|
||||||
|
| 高频(secretary/coo) | 10 分钟 | 60 分钟 |
|
||||||
|
| 开发(costcodev/architect/opengineer/designer) | 15 分钟 | 120 分钟 |
|
||||||
|
| 业务(其他 Agent) | 15 分钟 | 90 分钟 |
|
||||||
|
|
||||||
|
### 检测流程
|
||||||
|
|
||||||
|
每次心跳执行:
|
||||||
|
1. 获取自己的 `status=in_progress` 的 WorkBoard 卡片
|
||||||
|
2. 计算 `当前时间 - started_at`
|
||||||
|
3. 如果超过超时阈值 → 进入自动恢复流程
|
||||||
|
|
||||||
|
### 自动恢复流程
|
||||||
|
|
||||||
|
```
|
||||||
|
检测到任务超时
|
||||||
|
↓
|
||||||
|
检查最近日志(是否有实质性进展)
|
||||||
|
↓
|
||||||
|
┌──────────┴──────────┐
|
||||||
|
│ │
|
||||||
|
有进展(< 3轮无产出) 无进展(>= 3轮无产出)
|
||||||
|
│ │
|
||||||
|
延长超时 + 记录日志 自动恢复:
|
||||||
|
│ ├─ 尝试重新执行当前步骤
|
||||||
|
更新 heartbeat ├─ 仍失败 → 释放卡片
|
||||||
|
└─ 通知 COO 介入
|
||||||
|
```
|
||||||
|
|
||||||
|
### ⚠️ 超时告警
|
||||||
|
|
||||||
|
- 第 1 次超时:自动恢复,不告警
|
||||||
|
- 第 2 次超时:通知 COO
|
||||||
|
- 第 3 次超时:通知 Vincent,卡片标为 blocked
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 🔗 依赖检查前置
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## 🔗 依赖检查前置
|
||||||
|
|
||||||
|
> **核心规则:认领任务前,必须检查所有依赖是否已完成。**
|
||||||
|
|
||||||
|
### 检查流程
|
||||||
|
|
||||||
|
1. 获取任务的 `depends_on` 列表
|
||||||
|
2. 对每个依赖,查询其状态
|
||||||
|
3. 如果任一依赖未完成 → 不认领该任务,等待下次心跳
|
||||||
|
4. 如果所有依赖已完成 → 正常认领并执行
|
||||||
|
|
||||||
|
### 异常处理
|
||||||
|
|
||||||
|
- 依赖任务已取消 → 向上报告,由 COO 决策
|
||||||
|
- 依赖任务超时无响应 → 通知依赖方和 COO
|
||||||
|
- 循环依赖 → 自动检测并报告给 COO
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 🔄 最大轮次限制
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## 🔄 最大轮次限制
|
||||||
|
|
||||||
|
> **核心规则:单任务不能无限循环执行。**
|
||||||
|
|
||||||
|
| Agent 类型 | 最大对话轮次 | 超限处理 |
|
||||||
|
|------------|-------------|----------|
|
||||||
|
| 高频(secretary/coo) | 50 | 自动暂停,通知创建者 |
|
||||||
|
| 开发(costcodev/architect/opengineer) | 100 | 自动暂停,记录日志摘要 |
|
||||||
|
| 业务(其他 Agent) | 30 | 自动暂停,通知创建者 |
|
||||||
|
|
||||||
|
### 检测方式
|
||||||
|
|
||||||
|
每次心跳检查 `in_progress` 任务的会话轮次:
|
||||||
|
- 接近上限(80%)→ 在心跳日志中标记警告
|
||||||
|
- 达到上限 → 自动暂停任务,保存当前状态
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. 📊 上下文控制
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## 📊 上下文控制(Token 管理)
|
||||||
|
|
||||||
|
> **核心规则:避免上下文溢出导致任务中断。**
|
||||||
|
|
||||||
|
### 策略
|
||||||
|
|
||||||
|
1. **引用代替填塞**:Agent 配置文件中只保留核心规则,详细信息存 docs/ 目录
|
||||||
|
2. **分块读取**:超大文件分块读取,避免一次性加载
|
||||||
|
3. **清理过期信息**:每轮对话前清理上一轮的工具输出(仅保留关键结果)
|
||||||
|
4. **合并查询**:多个 Agent 相同查询由 COO 统一执行后广播
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 心跳频率分级
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## ⏱️ 心跳触发频率
|
||||||
|
|
||||||
|
- **高频 Agent(secretary / coo)**: 每 10 分钟
|
||||||
|
- **开发 Agent(costcodev / architect / opengineer / designer)**: 每 15 分钟
|
||||||
|
- **业务 Agent(projectmanager / productmanager / taobaospecialist / contentspecialist / mediaspecialist / cvexpert / marketanalysis / lawyer)**: 每 15 分钟
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 全局关键规则(增强版)
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## ⚠️ 全局关键规则
|
||||||
|
|
||||||
|
1. **心跳不打断对话** — 如果用户正在与 Agent 对话,心跳逻辑延后执行
|
||||||
|
2. **非紧急事项延后汇报** — 等下一轮心跳或用户主动询问时再汇报
|
||||||
|
3. **发现任务立即执行,不得请示** — 用户在大多数时候不在线,请示=任务卡死
|
||||||
|
4. **依赖检查前置** — 认领任务前必须检查所有依赖是否已完成
|
||||||
|
5. **超时自动恢复** — 任务超时自动尝试恢复,3 次失败后升级
|
||||||
|
6. **轮次限制** — 单任务达上限后自动暂停,防止无限循环
|
||||||
|
7. **上下文控制** — 引用代替填塞,避免 Token 溢出
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 各 Agent 类型模板
|
||||||
|
|
||||||
|
### 高频 Agent 模板(secretary/coo)
|
||||||
|
|
||||||
|
在原有专属心跳清单基础上,增加:
|
||||||
|
```markdown
|
||||||
|
### 🛡️ 稳定性保障清单
|
||||||
|
|
||||||
|
1. ✅ 超时检测:检查 in_progress 任务是否超时(阈值 60 分钟)
|
||||||
|
2. ✅ 依赖检查:新任务认领前检查所有 depends_on
|
||||||
|
3. ✅ 轮次检查:当前任务是否接近 50 轮上限
|
||||||
|
4. ✅ 上下文检查:HEARTBEAT.md/AGENTS.md 文件大小是否 < 5KB
|
||||||
|
```
|
||||||
|
|
||||||
|
### 开发 Agent 模板(costcodev/architect/opengineer/designer)
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
### 🛡️ 稳定性保障清单
|
||||||
|
|
||||||
|
1. ✅ 超时检测:检查 in_progress 任务是否超时(阈值 120 分钟)
|
||||||
|
2. ✅ 依赖检查:新任务认领前检查所有 depends_on
|
||||||
|
3. ✅ 轮次检查:当前任务是否接近 100 轮上限
|
||||||
|
4. ✅ 编译/测试检查:如有自动化测试,确认通过
|
||||||
|
```
|
||||||
|
|
||||||
|
### 业务 Agent 模板(其他 Agent)
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
### 🛡️ 稳定性保障清单
|
||||||
|
|
||||||
|
1. ✅ 超时检测:检查 in_progress 任务是否超时(阈值 90 分钟)
|
||||||
|
2. ✅ 依赖检查:新任务认领前检查所有 depends_on
|
||||||
|
3. ✅ 轮次检查:当前任务是否接近 30 轮上限
|
||||||
|
4. ✅ 输出质量检查:确认最近产出符合质量标准
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 实施说明
|
||||||
|
|
||||||
|
1. 此模板由 COO(陆怀瑾)编制,经 Vincent 审阅批准后实施
|
||||||
|
2. 模板中的 agent_id 需替换为各 Agent 的实际标识
|
||||||
|
3. 无需移除各 Agent 原有的专属心跳清单,只需追加稳定性保障清单
|
||||||
|
4. 修改后的文件需提交到 EnterpriseArchitect git 仓库
|
||||||
Reference in New Issue
Block a user