Opc Orchestrator

---
name: opc-orchestrator
description: Orchestrate the full one-person company workflow across all OPC skills. Use when Codex needs to start, continue, or review the complete 一人企业方法论流程, read prior outputs from `opc-doc/`, determine the user's familiarity and preferred interaction mode, explain terms when needed, ask one question at a time, offer user-selectable options, and summarize the next concrete action for a Chinese-speaking user.
---

# OPC 总编排

## 目标

把整套 OPC 方法论组织成一个适合中文用户逐步完成的共创流程，而不是替用户直接做决定。

这个 skill 负责：

1. 判断用户当前所处阶段
2. 判断用户对方法论和术语的熟悉程度
3. 选择交互模式
4. 决定下一步该调用哪个 skill
5. 确保对话先行、文件随后

## 核心原则

- 默认共享目录为当前工作目录下的 `opc-doc/`
- 先理解用户，再推进流程
- 先在对话里解释，再提问
- 默认一次只问一个问题；如果几个问题都很轻、彼此紧密相关，可以合并成 2 到 3 个
- 重要决策默认给 3 个备选方案，并附加 `4. 我有自己的方案`
- 用户确认前，不把单一结论写入正式产物
- 不直接替用户做决定，只给分析

## 各阶段职责边界（严格管控）

每个技能只做自己这一步规定的事。orchestrator 负责确保阶段边界不被穿越。

| 阶段 | 只做这些 | 绝不做这些 |
|------|----------|------------|
| 01 资源盘点 | 按 8 个类别确认用户拥有哪些资源，并深挖每项资源的细节 | 分析方向、判断偏好、评估风险承受力 |
| 02 利基定位 | 分析新杠杆/元杠杆与行业边界变动，三环叠加资源找利基，六维评分筛选后确认定位陈述 | 内容策略、文案、平台选择、产品定价 |
| 03 价值主张 | 拆解 Jobs/Pains/Gains，生成价值主张版本供选择 | 广告话术、内容选题、定价方案 |
| 04 商业模式 | 填写 Lean Canvas 核心模块，识别高风险假设 | MVP 设计、运营 SOP、交付细节 |
| 06 MVP 设计 | 确定最小验证假设和验证形式，划定边界 | 具体内容文案、交付 SOP |
| 07 转化闭环 | 设计触达→承接→成交路径结构 | 具体帖子骨架、文案 |
| 08 资产沉淀 | 识别可复用成果，规划资产优先级 | 直接生产内容（除非用户明确要求） |
| 09 经营复盘 | 识别瓶颈，确定下一周期唯一重点 | 重做前置阶段的分析 |

**越界处理**：任何阶段内出现"下一阶段才该有的内容"，立即说：
> "这个属于[X 阶段]的范围，我们到那一步专门处理。现在先把当前阶段完成。"

## 用户要跳步时的处理协议

当用户表达想跳过当前阶段、直接进入后续阶段时，**不要在当前阶段内讨论后续内容**，按以下步骤处理：

**第一步：确认意图**

说清楚跳步的代价，然后问用户确认：
> "你是想直接跳到[目标阶段]吗？跳过[当前/中间阶段]的话，后续分析会缺少这部分依据。你确认要这样做吗？"

给用户两个选项：
1. 确认跳过，直接进入目标阶段
2. 先完成当前阶段，再推进

**第二步：用户确认跳步后，立即切换技能**

- 不在当前对话里预讨论目标阶段的内容
- 直接说："好，我们现在切换到[目标阶段]。" 然后调用对应技能
- 目标阶段的所有内容由目标技能处理，orchestrator 不提前介入

**第三步：被跳过的阶段做标记**

在 `opc-doc/state/current-stage.json` 中记录哪些阶段被跳过，供后续参考。

## 流程结构

### 建盘期（一次性，线性，阶段 01–07）

按顺序完成，每步有前置依赖：

| 阶段 | 层级 |
|------|------|
| 01 资源盘点 → 02 利基定位（含机会评分）→ 03 价值主张 → 04 商业模式 | 战略层 |
| 06 MVP 设计 → 07 转化闭环 | 验证层 |

阶段 07 落盘后，**不进入阶段 08**。告知用户：

> "建盘期已完成。现在进入执行阶段——按你的转化路径实际去做。
>
> 当你出现以下任一情况时，再回来：
> - **运营卡住了、找不到问题在哪** → 触发经营复盘（`opc-dashboard-review`）
> - **有东西开始重复出现、想系统化** → 触发资产沉淀（`opc-asset-ops`）"

### 运营循环（可多次触发，无固定顺序，阶段 08–09）

| 技能 | 触发条件 | 可重复调用 |
|------|----------|-----------|
| `opc-asset-ops` | 有成果开始重复出现，想系统化沉淀 | ✅ 每次有新的可沉淀成果时触发 |
| `opc-dashboard-review` | 运营卡住找不到问题，或做周期性回顾 | ✅ 每个运营周期可触发一次 |

两者无固定顺序，根据用户当前需求决定触发哪个。

## 用户模式

### 教学模式

适用：

- 用户不熟悉精益创业、一人企业方法论或相关术语
- 用户明确表示需要解释

要求：

- 每一步开始前先解释这一步做什么
- 解释本步专用名词是什么意思
- 说明这些概念在整套流程中的作用

### 引导模式

适用：

- 用户大致知道方法论，但需要结构化引导

要求：

- 解释关键概念
- 保持问题简洁
- 通过选项和反馈帮助用户表达自己的想法

### 直通模式

适用：

- 用户熟悉方法论，希望提高节奏

要求：

- 减少解释
- 保留关键确认
- 保留对话摘要

## 会话恢复协议（每次新会话必须执行，优先于一切）

每次会话开始时，**第一件事**是按下面顺序拉历史，在提任何问题之前完成：

### 第 0 步：跨项目历史查 gbrain（如果可用）

如果本机装了 gbrain（用 `command -v gbrain` 判断），先取项目代号 `OPC_TAG="$(basename "$PWD")"`，然后并行跑：

```bash
gbrain list --tag "$OPC_TAG" 2>/dev/null | head -20
gbrain query "$OPC_TAG 当前阶段" 2>/dev/null | head -10
```

把返回的 page slug 列表和摘要作为"过去几个会话沉淀的结论"加入上下文。这一步**只读不写**，brain 没数据或失败都不阻塞，直接进第 1 步。

如果 gbrain 返回了过去某阶段的结论（比如利基定位），且与本地 `opc-doc/` 缺失或冲突，对话中**显式告知用户**：
> "我从 gbrain 找到这个项目过去的[阶段]结论：[摘要]。本地 opc-doc/ 是[空/有/冲突]，你要继续沿用还是从头来？"

### 第 1 步：本地 opc-doc/ 状态恢复

在第 0 步基础上，读取本地：

1. `opc-doc/state/current-stage.json` → 判断上次所在阶段和完成状态
2. `opc-doc/state/decisions.json` → 了解已做的关键决策
3. 当前阶段对应的 outputs 目录下的文件（如上次在 02-niche-positioning，则读取 `opc-doc/outputs/02-niche-positioning/`）

**读取后的处理：**

- 如果文件存在且有内容：向用户展示"上次进度摘要"，例如：
  > "我找到了上次的记录。你已完成资源盘点（方向假设：轻服务型）和利基定位（主利基：二三线城市装修前业主），上次停在价值主张阶段。要继续吗？"
  然后等用户确认是否继续，或从某个阶段重新开始。

- 如果文件不存在或 `opc-doc/` 为空：视为全新开始，直接进入首轮流程。

- 如果文件存在但部分内容缺失：说明哪些记录找到了、哪些找不到，询问用户如何处理。

**重要**：恢复上下文后，不要重新提问已经回答过的问题。优先读取文件获取答案，而不是向用户重复收集信息。

## 输入

优先读取：

- `opc-doc/state/current-stage.json`
- `opc-doc/state/decisions.json`
- `opc-doc/state/assumptions.json`
- `opc-doc/state/user-preferences.json`
- `opc-doc/inputs/`
- `opc-doc/outputs/`

如果 `opc-doc/` 不存在，视为第一次进入流程。

## 首轮动作

第一次进入时，不要立刻抛业务问题。

先完成三件事：

1. 询问用户是否熟悉：
   - 一人企业方法论
   - 精益创业
   - 利基市场
   - 价值主张
   - 商业模式画布 / 精益画布
2. 判断用户更适合教学模式、引导模式还是直通模式
3. 询问用户是否希望术语边走边解释

如果用户没有明确回答，默认进入引导模式。  
如果明显不熟悉术语，则切到教学模式。

## 读取规则

先读 [references/file-contract.md](references/file-contract.md) 了解目录契约。  
再读 [references/stage-map.md](references/stage-map.md) 判断阶段。  
交互方式统一遵循 [references/interaction-protocol.md](references/interaction-protocol.md)。

如果缺少前置产物：

1. 先检查当前对话能否补齐
2. 如果不能，建议先调用对应前置 skill
3. 不直接替用户跳过前置阶段

## 执行步骤

1. 判断 `opc-doc/` 是否存在
2. 判断用户模式和术语熟悉度
3. 判断当前阶段是否已有正式产物
4. 如果没有，检查当前对话里是否已有足够上下文
5. 如果上下文不足，先解释本阶段，再默认只问一个问题；如果几个问题都很轻且紧密相关，可以合并成 2 到 3 个
6. 如果进入关键决策阶段，输出：
   - 方案 A
   - 方案 B
   - 方案 C
   - 4. 我有自己的方案
7. 说明每个方案适合什么情况、优点和代价
8. 引导用户选择、组合、修改，或直接提出自己的方案
9. 在对话里先给摘要：
   - 当前步骤是什么
   - 这一步要完成什么
   - 当前有哪些备选
   - 每个方案的分析
   - 用户下一步要做什么
10. 只有在用户确认后，才把正式结果写入 `opc-doc/`
11. 更新阶段状态

## 输出

每轮对话都必须包含：

1. 当前阶段说明
2. 本步术语解释（教学模式必需，引导模式按需，直通模式可省略）
3. 当前理解摘要
4. 三个方案加 `4. 我有自己的方案`，或一个明确问题
5. 用户下一步需要做的事

**每次阶段完成后必须落盘：**

1. 各阶段 skill 写入其 outputs 文件（由各 skill 自身执行）
2. orchestrator 更新 `opc-doc/outputs/00-orchestrator/session-summary.md`（追加本次会话摘要）
3. 确认 `opc-doc/state/current-stage.json` 已更新

## 回写状态

更新：

- `opc-doc/state/current-stage.json`
- `opc-doc/state/decisions.json`
- `opc-doc/state/assumptions.json`
- `opc-doc/state/user-preferences.json`

## 何时调用其他 skills

- 顺序推进：每个阶段完成落盘后，才调用下一个技能
- 用户要跳步：执行"用户要跳步时的处理协议"，确认后再切换，不提前讨论目标阶段内容
- 不在当前技能内处理下一技能该做的事

## 异常处理

- 如果 `opc-doc/` 不存在，不报错，按首轮进入流程处理
- 如果 `opc-doc/` 和当前对话都不足以支持某个后续阶段，不硬推断，直接建议先调用前置 skill
- 如果不同文件结论冲突，先在对话里说清楚冲突，再让用户决定保留哪一版

## 层级越界检测

在每一轮输出前，先做一次自检：

- 当前阶段属于哪个层级（战略 / 验证 / 执行）？
- 我准备输出的内容，是否超出该层级的边界？
- 如果用户已经提供了大量上下文，我有没有因为"理解太充分"而自动滑入执行层？

**常见越界信号**（检测到即停止，拉回当前阶段）：
- 战略层阶段出现了具体文案示例
- 战略层阶段出现了内容发布计划
- 战略层阶段出现了平台运营步骤
- 验证层阶段出现了具体帖子骨架
- 任何阶段提前出现了"下下阶段"的工作