feat(org): add standard parallel v0.1 blueprint, dispatch rules, and acceptance checklist
This commit is contained in:
Chen Gu
@@ -0,0 +1,158 @@
|
|||||||
|
# 标准并行 v0.1 实施蓝图
|
||||||
|
|
||||||
|
版本：v0.1
|
||||||
|
日期：2026-03-09
|
||||||
|
负责人：Val（提交谷老板拍板）
|
||||||
|
|
||||||
|
## 1) 目标与范围
|
||||||
|
|
||||||
|
### 目标
|
||||||
|
在不追求全角色一次性上线的前提下，先完成最小可用标准并行闭环：
|
||||||
|
|
||||||
|
**Helix（规划）→ Sentinel（审计）→ Anvil（执行）**
|
||||||
|
|
||||||
|
### 本期范围
|
||||||
|
- 角色实例化：Helix / Sentinel / Anvil
|
||||||
|
- 调度规则：路由、并发、门禁、失败升级
|
||||||
|
- 可观测：任务日志字段统一 + 每日摘要
|
||||||
|
|
||||||
|
### 非范围（后续迭代）
|
||||||
|
- 全角色实例化（Vector / Quanta / Bastion / Prism / Catalyst / Echo）
|
||||||
|
- 自动预算调优
|
||||||
|
- 自动策略学习
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2) 设计原则
|
||||||
|
|
||||||
|
1. **安全与可控 > 吞吐速度**
|
||||||
|
2. **先跑通闭环，再扩并发规模**
|
||||||
|
3. **默认可追溯（无日志即视为未执行）**
|
||||||
|
4. **高风险动作必须可上报、可暂停、可回滚**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3) 角色职责（v0.1）
|
||||||
|
|
||||||
|
## 3.1 Helix（Architect）
|
||||||
|
- 输入：用户意图/需求
|
||||||
|
- 产出：结构化任务单（目标、范围、步骤、风险、验收）
|
||||||
|
- 允许工具：read / web_search / web_fetch / memory_search / sessions_spawn / sessions_send
|
||||||
|
- 禁止：直接执行高风险动作（外发、不可逆变更）
|
||||||
|
|
||||||
|
## 3.2 Sentinel（Auditor）
|
||||||
|
- 输入：Helix 任务单
|
||||||
|
- 产出：PASS / SOFT_BLOCK / HARD_BLOCK（含审计理由）
|
||||||
|
- 审计维度：安全、逻辑、成本
|
||||||
|
- 允许工具：read / memory_search / session_status
|
||||||
|
- 禁止：直接执行工程动作
|
||||||
|
|
||||||
|
## 3.3 Anvil（Works）
|
||||||
|
- 输入：已放行任务单
|
||||||
|
- 产出：执行记录、产物、复验证据
|
||||||
|
- 允许工具：read / write / edit / exec / process
|
||||||
|
- 约束：未放行不得执行；失败必须先归档证据
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4) 调度链路与状态机
|
||||||
|
|
||||||
|
状态流：
|
||||||
|
|
||||||
|
Intake → Draft(Helix) → Audit(Sentinel) → Dispatch → Execute(Anvil) → Verify → Report → Archive
|
||||||
|
|
||||||
|
### 审计决策语义
|
||||||
|
- PASS：进入 Dispatch/Execute
|
||||||
|
- SOFT_BLOCK：补充信息后可重审
|
||||||
|
- HARD_BLOCK：直接回收并上报
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5) 并发策略（v0.1）
|
||||||
|
|
||||||
|
- 全局并发上限：`3`
|
||||||
|
- 单角色并发上限：`2`
|
||||||
|
- 排队策略：优先级 + FIFO
|
||||||
|
- 优先级：urgent > high > normal > low
|
||||||
|
|
||||||
|
### 触发保护
|
||||||
|
- 任务队列长度 > 20：触发节流（只收不发）
|
||||||
|
- 任一角色连续失败 >= 2：自动降并发为 1，并上报
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6) 门禁与升级规则
|
||||||
|
|
||||||
|
### 强制上报谷老板（任一命中）
|
||||||
|
- 对外发送
|
||||||
|
- 不可逆操作
|
||||||
|
- 隐私边界跨越
|
||||||
|
- 预算超阈
|
||||||
|
- 审计高不确定
|
||||||
|
|
||||||
|
### 双签规则（沿用组织约束）
|
||||||
|
- 生产级工程执行需满足：Sentinel + Bastion 双签
|
||||||
|
- v0.1 若 Bastion 未实例化：由 Val 代行安全签，并记录 `security_sign_proxy_by=Val`
|
||||||
|
|
||||||
|
### 失败处理
|
||||||
|
- 所有失败进入 Failure 模板：
|
||||||
|
- 失败阶段
|
||||||
|
- 根因定位
|
||||||
|
- 修复方案 A/B
|
||||||
|
- 回滚策略
|
||||||
|
- 是否升级
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7) 可观测与日志规范
|
||||||
|
|
||||||
|
每个任务必须具备字段：
|
||||||
|
- task_id
|
||||||
|
- role
|
||||||
|
- status
|
||||||
|
- start_ts / end_ts
|
||||||
|
- input_summary
|
||||||
|
- tool_calls
|
||||||
|
- artifacts
|
||||||
|
- audit_decision
|
||||||
|
- risk_level
|
||||||
|
- token_cost
|
||||||
|
- failure_reason
|
||||||
|
- rollback_action
|
||||||
|
- final_report
|
||||||
|
|
||||||
|
建议落盘：`org/logs/tasks/YYYY-MM-DD/<task_id>.json`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8) 验收标准（v0.1）
|
||||||
|
|
||||||
|
- [ ] 可并发处理 >= 3 条任务流且无串线
|
||||||
|
- [ ] 每条任务可追溯决策/执行/审计责任
|
||||||
|
- [ ] 任一失败可在 2 分钟内定位
|
||||||
|
- [ ] 高风险动作 100% 命中上报门禁
|
||||||
|
- [ ] 汇报格式统一：结论 + 证据 + 风险 + 选项
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 9) 实施节奏（3天）
|
||||||
|
|
||||||
|
### Day 1
|
||||||
|
- 角色配置定稿（Helix/Sentinel/Anvil）
|
||||||
|
- 工具白名单与禁止动作锁定
|
||||||
|
|
||||||
|
### Day 2
|
||||||
|
- 调度器规则落地
|
||||||
|
- 门禁/升级逻辑接入
|
||||||
|
|
||||||
|
### Day 3
|
||||||
|
- 日志与看板打通
|
||||||
|
- 并发压测 + 验收
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 10) v0.2 预告（可选）
|
||||||
|
|
||||||
|
- 新增 Vector（调度实例化）
|
||||||
|
- 新增 Quanta（预算硬阈值自动刹车）
|
||||||
|
- 新增 Bastion/Prism（安全签与失败收敛实例化）
|
||||||
@@ -0,0 +1,44 @@
|
|||||||
|
# 标准并行 v0.1 验收清单
|
||||||
|
|
||||||
|
日期：2026-03-09
|
||||||
|
|
||||||
|
## A. 并发能力
|
||||||
|
- [ ] 同时提交 3 个任务，全部进入状态机
|
||||||
|
- [ ] 无 task_id 冲突
|
||||||
|
- [ ] 无跨任务日志串线
|
||||||
|
|
||||||
|
## B. 路由正确性
|
||||||
|
- [ ] 新任务先到 Helix
|
||||||
|
- [ ] Helix 完成后进入 Sentinel
|
||||||
|
- [ ] Sentinel PASS 才可进入 Anvil
|
||||||
|
- [ ] SOFT_BLOCK 能回流 Helix
|
||||||
|
- [ ] HARD_BLOCK 直接触发 Val 汇报
|
||||||
|
|
||||||
|
## C. 审计与门禁
|
||||||
|
- [ ] Sentinel 每次都有明确审计结论
|
||||||
|
- [ ] 外发动作均触发上报
|
||||||
|
- [ ] 不可逆动作均触发上报
|
||||||
|
- [ ] 预算超阈均触发上报
|
||||||
|
|
||||||
|
## D. 失败处理
|
||||||
|
- [ ] 任一失败均记录阶段与根因
|
||||||
|
- [ ] 任一失败均有修复 A/B
|
||||||
|
- [ ] 连续两次失败自动升级
|
||||||
|
- [ ] 回滚动作可复验
|
||||||
|
|
||||||
|
## E. 可观测性
|
||||||
|
- [ ] 每任务日志字段完整（task_id/role/status/tool_calls/artifacts...）
|
||||||
|
- [ ] 每条任务有最终报告
|
||||||
|
- [ ] 2 分钟内可定位失败根因
|
||||||
|
|
||||||
|
## F. 汇报质量
|
||||||
|
- [ ] 汇报包含：结论 / 证据 / 风险 / 选项
|
||||||
|
- [ ] 建议项明确且可执行
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 验收结论
|
||||||
|
- 结果：PASS / PARTIAL / FAIL
|
||||||
|
- 结论说明：
|
||||||
|
- 待修复项：
|
||||||
|
- 下阶段建议：
|
||||||
@@ -0,0 +1,49 @@
|
|||||||
|
{
|
||||||
|
"version": "v0.1",
|
||||||
|
"updated_at": "2026-03-09T11:40:00+08:00",
|
||||||
|
"global": {
|
||||||
|
"max_concurrency": 3,
|
||||||
|
"queue_limit": 20,
|
||||||
|
"failure_streak_degrade_to": 1
|
||||||
|
},
|
||||||
|
"roles": {
|
||||||
|
"helix": {
|
||||||
|
"stage": "draft",
|
||||||
|
"max_concurrency": 2,
|
||||||
|
"allowed_tools": ["read", "web_search", "web_fetch", "memory_search", "sessions_spawn", "sessions_send"],
|
||||||
|
"forbidden_actions": ["external_send", "irreversible_change"]
|
||||||
|
},
|
||||||
|
"sentinel": {
|
||||||
|
"stage": "audit",
|
||||||
|
"max_concurrency": 2,
|
||||||
|
"allowed_tools": ["read", "memory_search", "session_status"],
|
||||||
|
"audit_decisions": ["PASS", "SOFT_BLOCK", "HARD_BLOCK"]
|
||||||
|
},
|
||||||
|
"anvil": {
|
||||||
|
"stage": "execute",
|
||||||
|
"max_concurrency": 2,
|
||||||
|
"allowed_tools": ["read", "write", "edit", "exec", "process"],
|
||||||
|
"requires_audit": "PASS"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"routing": [
|
||||||
|
{ "when": "new_task", "to": "helix" },
|
||||||
|
{ "when": "helix.done", "to": "sentinel" },
|
||||||
|
{ "when": "sentinel.PASS", "to": "anvil" },
|
||||||
|
{ "when": "sentinel.SOFT_BLOCK", "to": "helix" },
|
||||||
|
{ "when": "sentinel.HARD_BLOCK", "to": "val.report" }
|
||||||
|
],
|
||||||
|
"escalation": {
|
||||||
|
"must_escalate_if": [
|
||||||
|
"external_send",
|
||||||
|
"irreversible_action",
|
||||||
|
"privacy_boundary_crossing",
|
||||||
|
"budget_threshold_exceeded",
|
||||||
|
"audit_uncertainty_high"
|
||||||
|
],
|
||||||
|
"double_sign_rule": {
|
||||||
|
"required": ["sentinel", "bastion"],
|
||||||
|
"proxy_if_bastion_missing": "val"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user