auto-sync: 2026-05-29 01:00:54

This commit is contained in:
cfdaily
2026-05-29 01:00:54 +08:00
parent 032d4c3649
commit 87f94d79ce
+63 -25
View File
@@ -149,11 +149,12 @@ Phase 4: 主动汇报
## 行为准则
1. 你是自主的。读黑板、思考、行动,不要等指令。
2. 不确定时 @pangtong-fujunshi 对齐目标
3. 需要协作时 @ 对应 Agent。
4. 讨论是随时灵活的,执行过程中也可以在黑板上讨论
5. 产出写入 output,完成时通知
1. **你是自主的。**读黑板、思考、行动,不要等指令。
2. **不重复别人的工作。**动手前先读黑板看谁在做什么(Separation)
3. **保持方向对齐。**你的产出方向和 parent goal 对齐,不确定时 @pangtong-fujunshiAlignment
4. **产出可共享。**产出写入黑板,让其他人能看到你的成果(Cohesion)
5. **不越界。**安全红线不要碰,超出能力的 @ 庞统升级(Boundary)
6. **随时讨论。**执行过程中需要协作时 @ 对应 Agent,讨论是灵活的不是固定阶段的。
## 完成标准
@@ -196,6 +197,16 @@ CREATE TABLE IF NOT EXISTS mention_queue (
Daemon 30s tick 检测:parent task 下所有 sub task 均为终态(done/failed/cancelled)。
**终态区分**
传给庞统的状态摘要包含维度信息:
```json
{ "done": 3, "failed": 1, "cancelled": 0, "total": 4 }
```
庞统 review prompt 中增加指引:
> 有 sub task failed 时,优先判断是应该重试(同一 Agent)、换人(换 Agent)、还是调整方案(修改 goal/约束)。
### 4.2 Review 三问(框架,不是限制)
庞统被 spawn 后拿到:
@@ -220,7 +231,29 @@ Daemon 30s tick 检测:parent task 下所有 sub task 均为终态(done/fail
| 标记偏离 | 需求被静默丢弃 | GSD Scope Reduction Detection |
| 调整优先级 | 根据执行进展重排 | Hermes `/goal` 持续锁定 |
| 修改 goal | 用户改主意时 | PRD B2 "计划可演进" |
| 终止/重来 | 方向完全偏了 | TradingAgents 动态图构建 |
### 4.4 一轮结束后的执行顺序
Ticker tick 串行执行,明确顺序避免冲突:
```
1. 超时检测(claimed 超时 → 重置 pendingexecuting 超时 → failed
2. 依赖推进(检查 blocker 完成 → 推进状态)
3. 调度 pending(含 review 类型的 task
4. 一轮结束检测(在调度之后,确保 review 结果已生效)
5. 庞统 review spawn
```
关键:步骤 4 在步骤 3 之后,确保司马懿 review 打回的 sub task 已重新进入 working 状态,不会误触发一轮结束。
### 4.5 防止庞统 review 无限循环
庞统 review 后创建新 sub task → sub 全部 done → 又触发一轮结束 → 又 spawn 庞统 review → 无限循环。
缓解方案:
- parent task 新增 `round_count` 字段,每触发一次庞统 review +1
- round_count 上限(如 5 轮),超过后强制进入 Phase 4 汇报给用户
- 或:庞统 review 后标记 parent 为 `reviewing`,一轮结束检测跳过 `reviewing` 状态的 parent
MVP 阶段用 round_count 上限,简单可靠。
---
@@ -276,34 +309,39 @@ AGENTS.md 中的角色从"质量总监:代码评审、多空辩论、最终验
### 6.1 Daemon 层
| 文件 | 改动 | 说明 |
|------|------|------|
| `ticker.py` | 新增 `_check_round_complete()` | 检测 parent 下所有 sub 终态 |
| `ticker.py` | 新增 `_spawn_pangtong_review()` | 一轮结束时 spawn 庞统 review |
| `ticker.py` | 新增 `_process_mentions()` | 扫描新 comments 的 mentions → spawn 被 @ 的 Agent |
| `dispatcher.py` | 扩展 spawn 类型 | 支持 "discussion" spawnPhase 2+ "review" spawn(一轮结束) |
| `bootstrap.py` | 扩展上下文构建 | 构建 goal + 一轮成果物聚合 + 讨论 history |
| `spawner.py` | 更新 prompt 模板 | 使用 §3.3 的 spawn prompt 框架 |
| 文件 | 改动 | 说明 | MVP |
|------|------|------|------|
| `ticker.py` | 新增 `_check_round_complete()` | 检测 parent 下所有 sub 终态 | ✅ |
| `ticker.py` | 新增 `_spawn_pangtong_review()` | 一轮结束时 spawn 庞统 review | ✅ |
| `ticker.py` | 新增 `_process_mentions()` | 扫描 mention_queue → spawn 被 @ 的 Agent | ❌ 后续 |
| `ticker.py` | tick 流程明确顺序(§4.4) | 超时→依赖→调度→一轮结束→庞统 review | ✅ |
| `dispatcher.py` | 扩展 spawn 类型 | 支持 "discussion" + "review" | ✅ |
| `bootstrap.py` | 扩展上下文构建 | goal + 成果物聚合 + 讨论 history | ✅ |
| `spawner.py` | 更新 prompt 模板 | 使用 §3.3 框架 + Boids 映射 | ✅ |
| `models.py` | parent 新增 `round_count` 字段 | 防止无限循环(§4.5) | ✅ |
### 6.2 API 层
| 文件 | 改动 | 说明 |
|------|------|------|
| `blackboard_routes.py` | 新增成果物聚合端点 | `GET /tasks/{id}/outputs/aggregate` 聚合 parent 下所有 sub 的 outputs |
| 文件 | 改动 | 说明 | MVP |
|------|------|------|------|
| `blackboard_routes.py` | 新增成果物聚合端点 | `GET /tasks/{id}/outputs/aggregate` | ❌ 后续 |
| `blackboard_routes.py` | mention_queue 表初始化 | comments 表联动 | ❌ 后续 |
### 6.3 Model 层
| 文件 | 改动 | 说明 |
|------|------|------|
| `operations.py` | 新增 `get_subtasks_status()` | 批量查询 parent 下所有 sub 状态 |
| `operations.py` | 新增 `get_mentioned_agents()` | 从 comments 中提取未通知的 mentions |
| 文件 | 改动 | 说明 | MVP |
|------|------|------|------|
| `operations.py` | 新增 `get_subtasks_status()` | 批量查询 parent 下所有 sub 状态 | ✅ |
| `operations.py` | 新增 `get_mentioned_agents()` | 从 mention_queue 提取 pending mentions | ❌ 后续 |
### 6.4 Skill 层
| 位置 | 内容 | 说明 |
|------|------|------|
| 司马懿 workspace | review skill 文件 | 司马懿基于 §5.2 优秀实践自行设计 |
| 庞统 bootstrap | review prompt 模板 | 庞统 review 的三问框架 |
| 位置 | 内容 | 说明 | MVP |
|------|------|------|------|
| 司马懿 workspace | review skill 文件 | 司马懿基于 §5.2 优秀实践自行设计 | ❌ 独立 |
| 庞统 bootstrap | review prompt 模板 | 庞统 review 的三问框架 | ✅ |
**MVP 范围**:ticker 流程重排 + 一轮结束检测 + 庞统 review spawn + spawn prompt 模板 + round_count 防循环。@mention 通知和成果物聚合端点后续迭代。
### 6.5 前端(可选,后续)