agent-orchestration-20260309-lzw

Category: Content & Multimedia | Uploader: Fozu-lzwpattern | Downloads: 0 | Version: v1.0（Latest）

One-Person Company (OPC) 编排技能 — 复杂任务的多 Agent 协作指挥中枢。【优先触发条件 — 满足任意一条即应调用 OPC】 ① 任务需要多个步骤且步骤之间有依赖关系（如策划→搭建→发布） ② 任务预计超过 50K tokens 或 10 分钟 ③ 任务涉及多个领域（调研+创作+开发+发布等两个以上领域并存） ④ 任务需要多个专业角色分工（研究员、工程师、设计师等） ⑤ 任务明确包含"并行执行""多路线""团队协作"等关键词 ⑥ 用户提到"全链路""从头到尾""完整流程""做一个完整的X" 核心能力：Context Intake（用户模型读取+背景摄入）、任务分解、多角色编排、状态持久化、断点续传、用户模型自更新。触发词（任意匹配）： OPC、一人公司、多agent、编排、全链路、复杂项目、帮我做完整的、需要多个步骤、并行执行、团队协作、策划+搭建+发布、研究项目、内容流水线 --- # OPC — One-Person Company 编排技能 v5.2 > 用户是老板，OpenClaw 是 CEO，Sub-agents 是专业员工。 > 用户只说"我要做 X"，CEO 负责拆活儿、招人、盯进度、**亲自验收**、交结果。 --- ## 30 秒上手 ``` 1. 触发 OPC → Phase 0: Context Intake（理解背景目标，给出方案，等确认） 2. 确认后 → Phase 1: init 项目 + 任务分解 3. spawn Sub-agents → Phase 2: 注入角色卡 + 注册状态 4. 监控执行 → Phase 3: 主动检查 + trigger-evaluate + 汇报进度 5. 交付汇总 → Phase 4: cost 报告 + close 项目 ``` --- ## Phase 0：Context Intake（最重要，不可跳过） OPC 被触发后，**第一步必须理解背景，给出方案，征询确认**。 ### 必须明确的四个维度 ``` 【背景】业务场景是什么？有什么前置条件？新建还是继续？【目标】交付物是什么？怎么判断"完成"？【约束】截止时间？token 预算？平台限制？【范围】从哪里开始到哪里结束？什么不在本次范围？ ``` ### 方案输出格式（等用户确认才开始） ```markdown ## 📋 OPC 项目方案 **背景理解**：{一句话概括} **目标**：{交付物 + 成功标准} **约束**：{时间/预算/限制} **推进方案**： - 角色配置：{N 个角色，名称 + 主要职责} - 协作模式：{串行/并行/混合} - 预估总预算：~{N}K tokens - 预计耗时：~{N} 分钟 **确认后开始执行，是否有需要调整的地方？** ``` ### 确认轮次 | 复杂度 | 判断标准 | 轮次 | |--------|---------|------| | 简单 | ≤2 角色，单流水线 | **1 轮**（Phase 0+1 合并）| | 中等 | 3-5 角色，有并行 | **1 轮**（Phase 0+1 合并）| | 复杂 | >5 角色，>200K 预算 | **2 轮**（理解→方案分开）| 详细决策逻辑 → brain/core-flow.md --- ## 核心执行命令速查 ```bash # Phase 1 — 项目初始化 python3 engine/project_state.py init "项目名" python3 engine/project_state.py update-phase <pid> phase_1_planning # Phase 2 — agent 注册 python3 engine/project_state.py agent-start <pid> <label> '{"role":"角色名"}' # Phase 3 — 监控 python3 engine/project_state.py agent-complete <pid> <label> '{"output":"..."}' <tokens> python3 engine/project_state.py agent-fail <pid> <label> '{"error":"原因"}' python3 engine/project_state.py trigger-evaluate <pid> # 每轮循环必须调用 # 断点续传 python3 engine/project_state.py checkpoint <pid> <label> '{"completedSteps":[...],"nextStep

Changelog: Source: GitHub https://github.com/Fozu-lzwpattern/OPC-agent-orchestration

Directory Structure

Current level: Root

📁 brain/
- 📄 collaboration-patterns.md 2.7 KB
- 📄 core-flow.md 8.9 KB
- 📄 cost-tracking.md 3.9 KB
- 📄 heartbeat-protocol.md 1.1 KB
- 📄 proactive-reporting.md 3.5 KB
- 📄 role-design.md 1.7 KB
- 📄 task-decomposition.md 4.2 KB
- 📄 verification.md 2.9 KB
📁 engine/
- 📁 __pycache__/
  - 📄 trigger_engine.cpython-311.pyc 42.0 KB
- 📄 aware-triggers.md 7.5 KB
- 📄 diagnose_agent.py 8.2 KB
- 📄 project-state.md 3.9 KB
- 📄 project_state.py 23.6 KB
- 📄 README.md 2.9 KB
- 📄 tool-discovery.md 4.2 KB
- 📄 tool_discovery.py 22.3 KB
- 📄 trigger_engine.py 28.1 KB
- 📄 troubleshooting.md 5.9 KB
📁 playbook/
- 📁 personas/
  - 📄 lzw.md 3.8 KB
- 📁 roles/
  - 📄 analyst.md 1.1 KB
  - 📄 biz-analyst.md 1.3 KB
  - 📄 critic.md 1.9 KB
  - 📄 engineer.md 1.3 KB
  - 📄 integrator.md 1.3 KB
  - 📄 researcher.md 1.4 KB
  - 📄 ux-designer.md 1.4 KB
  - 📄 writer.md 1.3 KB
- 📁 scenarios/
  - 📄 _README.md 913 B
  - 📄 content-project.yaml 2.6 KB
  - 📄 engineering-project.yaml 2.6 KB
  - 📄 marketing-campaign.md 7.4 KB
  - 📄 research-project.yaml 2.6 KB
- 📁 templates/
  - 📄 agent-prompt.md 2.8 KB
  - 📄 cost-report.md 818 B
  - 📄 focus.yaml 742 B
  - 📄 opc-user-model.md 647 B
  - 📄 output-contract.yaml 2.4 KB
  - 📄 project-plan.md 1.0 KB
  - 📄 triggers.yaml 1.8 KB
- 📄 persona-priming.md 4.9 KB
- 📄 philosophy.md 18.6 KB
📄 CHANGELOG.md 16.7 KB
📄 LICENSE 5.4 KB
📄 README.md 6.8 KB
📄 SKILL.md 10.6 KB

SKILL.md

---
name: agent-orchestration-20260309-lzw
version: "5.2"
description: >
  One-Person Company (OPC) 编排技能 — 复杂任务的多 Agent 协作指挥中枢。
  
  【优先触发条件 — 满足任意一条即应调用 OPC】
  ① 任务需要多个步骤且步骤之间有依赖关系（如 策划→搭建→发布）
  ② 任务预计超过 50K tokens 或 10 分钟
  ③ 任务涉及多个领域（调研+创作+开发+发布 等两个以上领域并存）
  ④ 任务需要多个专业角色分工（研究员、工程师、设计师等）
  ⑤ 任务明确包含"并行执行""多路线""团队协作"等关键词
  ⑥ 用户提到"全链路""从头到尾""完整流程""做一个完整的X"
  
  核心能力：Context Intake（用户模型读取+背景摄入）、任务分解、多角色编排、状态持久化、断点续传、用户模型自更新。
  
  触发词（任意匹配）：
  OPC、一人公司、多agent、编排、全链路、复杂项目、帮我做完整的、
  需要多个步骤、并行执行、团队协作、策划+搭建+发布、研究项目、内容流水线
---

# OPC — One-Person Company 编排技能 v5.2

> 用户是老板，OpenClaw 是 CEO，Sub-agents 是专业员工。
> 用户只说"我要做 X"，CEO 负责拆活儿、招人、盯进度、**亲自验收**、交结果。

---

## 30 秒上手

```
1. 触发 OPC → Phase 0: Context Intake（理解背景目标，给出方案，等确认）
2. 确认后 → Phase 1: init 项目 + 任务分解
3. spawn Sub-agents → Phase 2: 注入角色卡 + 注册状态
4. 监控执行 → Phase 3: 主动检查 + trigger-evaluate + 汇报进度
5. 交付汇总 → Phase 4: cost 报告 + close 项目
```

---

## Phase 0：Context Intake（最重要，不可跳过）

OPC 被触发后，**第一步必须理解背景，给出方案，征询确认**。

### 必须明确的四个维度

```
【背景】业务场景是什么？有什么前置条件？新建还是继续？
【目标】交付物是什么？怎么判断"完成"？
【约束】截止时间？token 预算？平台限制？
【范围】从哪里开始到哪里结束？什么不在本次范围？
```

### 方案输出格式（等用户确认才开始）

```markdown
## 📋 OPC 项目方案

**背景理解**：{一句话概括}
**目标**：{交付物 + 成功标准}
**约束**：{时间/预算/限制}

**推进方案**：
- 角色配置：{N 个角色，名称 + 主要职责}
- 协作模式：{串行/并行/混合}
- 预估总预算：~{N}K tokens
- 预计耗时：~{N} 分钟

**确认后开始执行，是否有需要调整的地方？**
```

### 确认轮次

| 复杂度 | 判断标准 | 轮次 |
|--------|---------|------|
| 简单 | ≤2 角色，单流水线 | **1 轮**（Phase 0+1 合并）|
| 中等 | 3-5 角色，有并行 | **1 轮**（Phase 0+1 合并）|
| 复杂 | >5 角色，>200K 预算 | **2 轮**（理解→方案分开）|

详细决策逻辑 → brain/core-flow.md

---

## 核心执行命令速查

```bash
# Phase 1 — 项目初始化
python3 engine/project_state.py init "项目名"
python3 engine/project_state.py update-phase <pid> phase_1_planning

# Phase 2 — agent 注册
python3 engine/project_state.py agent-start <pid> <label> '{"role":"角色名"}'

# Phase 3 — 监控
python3 engine/project_state.py agent-complete <pid> <label> '{"output":"..."}' <tokens>
python3 engine/project_state.py agent-fail <pid> <label> '{"error":"原因"}'
python3 engine/project_state.py trigger-evaluate <pid>   # 每轮循环必须调用

# 断点续传
python3 engine/project_state.py checkpoint <pid> <label> '{"completedSteps":[...],"nextStep":"..."}'
python3 engine/project_state.py checkpoint-get <pid> <label>

# Phase 4 — 交付
python3 engine/project_state.py cost <pid>
python3 engine/project_state.py close <pid>

# 诊断恢复
python3 engine/project_state.py restore <pid>
python3 engine/project_state.py diagnose <pid>

# ⭐ v4.0 CEO 自主验收（agent 完成后、agent-complete 前执行）
python3 engine/project_state.py verify <pid> <label> "npm test"

# ⭐ v4.0 冻结项目扫描（Heartbeat 时调用）
python3 engine/project_state.py wake-frozen

# 工具发现（Phase 0 可选）
python3 engine/tool_discovery.py report "任务描述"
```

---

## 角色卡模板

```
[OPC 角色卡]
- 角色：{role_name}
- Persona：以 {expert_name}（{expert_title}）的方法论工作
- 汇报给：OpenClaw CEO
- 职责：{responsibilities}
- 预算：{N}K tokens

[Heartbeat 协议]
1. 确认角色和任务
2. 阅读上游产出（如有）
3. 执行工作
4. 完成后汇报：产出摘要 + 遇到的问题
5. 遇障碍：说明障碍 + 建议 + 是否需要 CEO 介入

[任务]
{task_description}

[产出要求]
格式：{format}，保存到：{file_path}
```

Persona 库 → playbook/persona-priming.md
完整模板 → playbook/templates/agent-prompt.md

---

## 协作模式

| 模式 | 适用 | 示例 |
|------|------|------|
| 串行流水线 | 严格依赖顺序 | 策划→搭建→发布 |
| 并行分工 | 独立子任务 | 文案∥设计∥数据→组装 |
| 迭代反馈 | 需审核修改 | 搭建↔QA→发布 |
| 分治汇总 | 大任务拆分 | 研究1∥研究2∥研究3→汇总 |

详细 → brain/collaboration-patterns.md

---

## 故障处理

```
agent 失败 → 立即归因
  python3 engine/project_state.py diagnose <pid>

归因：L1-Platform → sessions_history拉取/重试
     L2-Orchestration → 修改角色卡重新spawn
     L3-BusinessSkill → 修复skill，断点续传
```

详细 → engine/troubleshooting.md

---

## 适用场景

✅ 适用 OPC：多角色复杂项目 / 跨领域任务 / 全链路执行 / 研究+实现+发布
❌ 不适用：简单单一任务（直接spawn）/ 定时重复（Cron）/ 日常监控（Heartbeat）

---

## 目录结构

```
agent-orchestration-20260309-lzw/
├── SKILL.md              ← 入口（你在这里）
├── CHANGELOG.md          ← 完整版本历程（v1.0 → v5.0）
├── brain/                ← CEO 决策层（怎么想）
│   ├── core-flow.md      ← 四阶段流程 + Context Intake + 冻结唤醒
│   ├── verification.md   ← ⭐ v4.0 CEO 自主验收规则库
│   ├── task-decomposition.md
│   ├── role-design.md
│   ├── collaboration-patterns.md
│   ├── heartbeat-protocol.md
│   ├── proactive-reporting.md
│   └── cost-tracking.md
├── engine/               ← 执行引擎层（怎么跑）
│   ├── project_state.py  ← 核心：项目状态管理（v4.0：+verify, +wake-frozen）
│   ├── trigger_engine.py ← Aware 触发器
│   ├── tool_discovery.py ← 工具发现（标签体系 v2）
│   ├── diagnose_agent.py ← 自动归因
│   └── README.md         ← 命令速查
├── playbook/             ← 知识与模板层（参考素材）
│   ├── persona-priming.md     ← Persona 方法论 + 预置库索引
│   ├── personas/
│   │   └── lzw.md             ← 内置 LZW 顾问 Persona（v3.2）
│   ├── philosophy.md
│   ├── templates/
│   │   └── opc-user-model.md  ← 用户模型模板（v3.1）
│   └── scenarios/        ← 实战案例
└── archive/              ← 旧版归档

用户模型实例（workspace，自动维护）：
~/.openclaw/workspace/opc-user-model.md
```


---

## 触发分级矩阵（v5.0）

> CEO 收到任务后，先用此矩阵判断 OPC 级别，再决定是否启动以及以何种模式启动。

```
L0 — 不触发 OPC（直接执行）
  条件：单一工具调用 / 单步任务 / 预计 < 5 分钟 / 无需协作

L1 — 轻量 OPC（省略 Phase 0 确认，直接 spawn + 简报）
  条件：2-3 步串行 / 有上下文依赖 / 单一领域

L2 — 标准 OPC（完整四阶段，方案卡 ≤ 5 行）
  触发任意 3 条：
  □ 用户消息含"完整"/"全链路"/"从头到尾"/"完整的X"
  □ 预计步骤 > 5 步
  □ 涉及 2+ 个独立业务领域
  □ 需要输出文件 > 3 个
  □ 预估 token > 50K
  □ 用户提到"并行"/"多角色"/"分工"

L3 — 重型 OPC（完整四阶段 + 结构化方案卡 + 明确确认）
  触发任意 2 条：
  □ 预计跨天或多个 session
  □ 涉及 3+ 个领域
  □ 预估 token > 200K
  □ 有复杂依赖链（A 完成才能启动 B，B 完成才能启动 C）
```

### 自适应指挥规则

| 级别 | Phase 0 | 方案卡 | 交付包 | 复盘 |
|------|---------|--------|--------|------|
| L1 | 跳过 | 跳过 | 简版（3行） | 跳过 |
| L2 | 执行 | ≤ 5 行 | 标准版 | 执行 |
| L3 | 执行 | 完整结构化 | 完整版 | 执行 |


---

## 角色模板库（v5.0）

CEO spawn Sub-agent 时，优先继承 `playbook/roles/` 中的模板，再覆盖个性化参数。

| 文件 | 角色 | 核心产出 |
|------|------|---------|
| researcher.md | 研究员 | 调研报告、竞品分析 |
| engineer.md | 工程师 | 代码、测试 |
| writer.md | 写作者 | 文章、文档 |
| analyst.md | 数据分析师 | 数据报告、指标分析 |
| integrator.md | 汇总整合员 | 多角色产出合并 |
| ux-designer.md | 体验设计师 | 交互方案、设计规格 |
| biz-analyst.md | 商业分析师 | 商业模型、战略建议 |
| critic.md | 评价与反馈 | 质量审查、改进建议 |

**Persona 与角色是两个维度，可自由组合**：
- 岗位模板定义"做什么"（任务边界 + 产出规格）
- Persona 定义"怎么思考"（思维方式 + 方法论）

```
# 示例：高质量研究角色
[角色] researcher.md 研究员
[Persona] 以 Nate Silver 的数据驱动思维工作
[USER_VOICE] "{用户原话}"
[文件所有权] reports/topic-a/
```

---

## 项目类型速启模板（v5.2）

> 适用：Phase 1 规划时，识别项目类型 → 继承对应模板 → 只填参数 → spawn

| 模板文件 | 项目类型 | 预设角色（含 critic） |
|---------|---------|-------------------|
| research-project.yaml | 调研/分析/竞品 | researcher×N + integrator + **critic** |
| engineering-project.yaml | 开发/重构/MVP | engineer×N + (ux-designer) + **critic** |
| content-project.yaml | 文章/博客/文档 | (researcher) + writer + **critic** |

⭐ **铁律：任何项目类型都必须包含至少一个 critic 角色**
critic 在所有主产出完成后执行，评分 ≥ 3 才能进入交付包。

模板目录：`playbook/scenarios/`

---

## Output Contract（v5.0）

项目初始化时，CEO 在 `opc-projects/{pid}/` 创建 `output-contract.yaml`，声明所有预期产出。

```bash
# 使用模板
cp playbook/templates/output-contract.yaml opc-projects/{pid}/output-contract.yaml

# verify 时对照 contract 执行
python3 engine/project_state.py verify <pid> <label> "contract"
```

详见 `playbook/templates/output-contract.yaml`。

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

agent-orchestration-20260309-lzw

Directory Structure

SKILL.md

Report

Notice