OpenSpec Parallel Agents

概述

该技能用于 OpenSpec 的并发子代理编排，兼容三类入口：

1. OPSX 新命令（/opsx:*）
2. 旧版命令（/openspec:*）
3. Codex CLI 提示词命令（/prompts:*）

目标是同时覆盖新旧命令语义，并在多 change 场景下安全并发、受控汇总、避免写冲突。

命令兼容矩阵（必须识别）

场景	命令形态	说明
OPSX 新版	/opsx:explore /opsx:new /opsx:continue /opsx:ff /opsx:apply /opsx:verify /opsx:sync /opsx:archive /opsx:bulk-archive /opsx:onboard	当前主流程
Legacy 旧版	/openspec:proposal /openspec:apply /openspec:archive	兼容旧工作流
Codex CLI（新）	/prompts:opsx-explore /prompts:opsx-new /prompts:opsx-continue /prompts:opsx-ff /prompts:opsx-apply /prompts:opsx-verify /prompts:opsx-sync /prompts:opsx-archive /prompts:opsx-bulk-archive /prompts:opsx-onboard	对应 ~/.codex/prompts/opsx-<id>.md
Codex CLI（旧）	/prompts:openspec-proposal /prompts:openspec-apply /prompts:openspec-archive	历史提示词写法，需兼容

旧命令到新流程映射

1. /openspec:proposal 或 /prompts:openspec-proposal

• 等价到“创建规划产物”语义。
• 推荐映射为：/opsx:new + /opsx:ff（或按需 /opsx:continue 逐步创建）。

2. /openspec:apply 或 /prompts:openspec-apply

• 直接映射到 /opsx:apply。

3. /openspec:archive 或 /prompts:openspec-archive

• 直接映射到 /opsx:archive。

Codex CLI 特殊处理

1. Prompt 文件目录优先识别 $CODEX_HOME/prompts，否则使用 ~/.codex/prompts。
2. 若同义命令同时存在新旧别名，优先采用 OPSX 语义执行，并在汇总中注明“兼容入口触发”。
3. 对 /prompts:* 入口，参数可能以整串形式传入；无法唯一定位 change 时必须先做 change 选择，不得猜测。

触发条件

满足任一条件即启用：

1. 同时处理 2 个及以上 change，且部分任务可独立执行。
2. 需要批量归档或归档前检查（尤其 /opsx:bulk-archive）。
3. 任务中同时存在可并行节点与强依赖链。
4. 用户使用上表中的任一新旧命令，并明确要求并行子代理执行。

并发执行规则

1. 每轮默认拆分 3-6 个子任务；不足 3 个必须说明改串行原因。
2. 仅并发无前置依赖节点；强依赖链必须串行。
3. 禁止并发写同一文件重叠区域；发现冲突风险立即降级串行。
4. 归档与规格合并涉及共享索引时，最终提交必须串行。
5. 一轮并发必须全量返回后统一汇总，不允许边返回边跨轮推进。

命令级策略

新命令（/opsx:*）

• /opsx:new：可并发创建互不依赖 change。
• /opsx:ff：按 change 分组并发生成规划产物。
• /opsx:apply：按模块边界并发实现。
• /opsx:verify：可并发验证各 change，再统一裁决。
• /opsx:archive：归档前检查可并发，最终归档串行提交。
• /opsx:bulk-archive：先并发做健康检查，再按冲突顺序串行归档。

旧命令（/openspec:*）

• 保留用户入口，不强制要求用户改命令。
• 执行时按“旧到新映射”转换为 OPSX 语义并应用同一并发规则。

Codex CLI（/prompts:*）

• 新旧 prompt 名称均识别。
• 调度规则与 /opsx:* 一致，仅入口别名不同。

标准循环

1. 识别入口类型（OPSX / Legacy / Codex Prompt）。
2. 标准化为 OPSX 语义（必要时做旧命令映射）。
3. 依赖分析并拆分 3-6 个无冲突任务卡。
4. 并发执行可并行节点。
5. 汇总冲突、阻塞、风险，决定下一轮并行或转串行。

轮次汇总模板

## 第 {N} 轮汇总

### 触发入口
- 原始命令: {如 /openspec:proposal 或 /prompts:opsx-apply}
- 规范化语义: {对应 /opsx:*}

### 本轮目标
- {一句话目标}

### 子任务状态（3-6）
1. {任务A} | {完成/阻塞/失败} | 产出: {文件或结果}
2. {任务B} | {完成/阻塞/失败} | 产出: {文件或结果}
3. {任务C} | {完成/阻塞/失败} | 产出: {文件或结果}

### 冲突与处理
- 写冲突检查: {无/有，位置}
- 处理动作: {重排并发/改串行/拆分边界}

### 依赖链状态
- 串行链: {A -> B -> C}
- 当前推进: {节点}

### 下一轮计划
- 并行任务: {列表}
- 串行任务: {列表}
- 归档准备状态: {可归档/不可归档 + 原因}