# Parallel Execution

> 堂官-员外郎并行模式，六部收到 ≥ 2 个互不冲突子任务时由堂官协调员外郎 Teammate 并行执行

- Skill: `majiayu000/parallel-execution-3` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/parallel-execution-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/parallel-execution-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/parallel-execution-3

---


# 部门内并行执行

> 六部收到 ≥ 2 个子任务时，切换为堂官-员外郎模式并行执行。

## 触发条件

- 尚书省同时向同一部门派发 ≥ 2 个子任务
- 或部门已有 1 个进行中任务，又收到新的无冲突任务
- 仅 1 个子任务时**不启动**堂官模式，直接执行

## 角色

**堂官**（部门主 Teammate）：冲突检测 → 任务分组 → 申请创建员外郎 Teammate → 汇总产出 → 回报尚书省。堂官模式下原则上不直接产出，仅协调。例外：串行链仅含 1 个任务时堂官可自行执行。

**员外郎**（Teammate Worker）：堂官申请创建的独立 Teammate，继承部门核心身份，在独立 worktree 中执行单个子任务，完成后通过 SendMessage 向堂官回报。

## 上级并行提示（parallel_hint）

堂官在冲突检测前，须先查看工单中尚书省附加的 `parallel_hint`：

- `confidence: high` + 堂官验证无冲突 → 直接并行
- `confidence: medium` + 堂官验证无冲突 → 并行
- `confidence: medium` + 堂官发现冲突 → 改为串行，回报尚书省说明原因
- `confidence: low` 或无 hint → 堂官自行完整检测后决定

**hint 是建议不是命令**：堂官有权基于实际冲突检测推翻上级标注，但推翻时须在回报中说明原因。即使上级未附加 hint，堂官仍须自行判断是否可并行。

## 冲突检测

```
1. 参考上级 parallel_hint（若有）
2. 提取每个任务的影响范围（文件路径、模块、外部资源）
3. 两两比较影响范围
   - 无交集 → 可并行
   - 有交集 → 必须串行
4. 输出：并行组 + 串行链
```

> 📎 各部门冲突判定细则与完整约束清单见 `parallel-conflict-rules.md`

## 执行流程

```
收到 N 个子任务（N ≥ 2）
  │
  ├── 堂官提取影响范围，划分 [并行组] + [串行链]
  │
  ├── 并行组：
  │     ├── 每个任务申请创建 1 个员外郎 Teammate（独立 worktree）
  │     ├── 员外郎并行执行，通过 SendMessage 向堂官汇报
  │     └── 完成策略：
           ├── 全部员外郎完成 → 堂官正常收集产出
           └── 某员外郎超过执行超时（继承 fault-tolerance 六部默认 10 分钟）仍未完成 →
                 堂官不等待，以 **partial_done** 状态汇总已完成产出
                 汇总报告须含：`{ "status": "partial_done", "completed": [...], "timed_out": [...] }`
                 门下覆奏时按**部分验收**标准（仅验收已完成部分，注明缺失项及影响）
  │
  ├── 串行链：
  │     ├── 仅 1 个任务 → 堂官自行执行
  │     └── ≥ 2 个任务 → 逐个启动员外郎按序执行
  │
  └── 堂官汇总
        ├── 检查产出间是否有 merge conflict
        ├── 有冲突 → 堂官协调解决或上报尚书省
        └── 无冲突 → 合并产出，统一回报尚书省
```

## 约束

1. **员外郎上限**：单部门同时不超过 **3 个**，超出排队
2. **必须隔离**：员外郎使用独立 worktree，禁止同目录并行修改
3. **员外郎不互通**：所有交互经堂官中转

> 📎 各部门冲突判定细则与完整约束清单见 `parallel-conflict-rules.md`

