---
name: epee-orchestrator
description: >-
  EPEE Skill Orchestrator: meta-level dispatch system. Detects whether a task can be handled
  by an existing Skill and routes accordingly, or discovers Skill gaps and guides the creation
  of new Skills. Triggers when the Agent encounters tasks with dense manual configuration,
  clear repetition patterns, or overly long manual instructions. Also used for Skill Registry
  maintenance and synchronization.
---

# EPEE Skill Orchestrator

元层调度系统，负责 Skill 分流、缺口发现和 Registry 维护。

## 操作 A：Skill 分流（匹配已有 Skill）

### 流程

```
1. 读取 registry.md 获取所有已注册 Skill 的摘要
2. 将当前任务特征与每个 Skill 的"触发场景"关键词匹配
3. 如果匹配到：
   a. 告知用户"此任务可以通过 [Skill名] 高效完成"
   b. 简述该 Skill 的能力及与当前任务的契合点
   c. 用户确认后，读取并激活对应 Skill 的 SKILL.md
```

### 匹配规则

- 优先匹配触发场景关键词与当前任务描述的交集
- 如有多个 Skill 匹配，按相关度排序推荐，由用户选择
- `deferred-decisions` 等标记为"基础设施"类型的 Skill 不参与任务分流匹配，
  仅作为 Orchestrator 的下游工具使用

## 操作 B：Skill 缺口发现 + 创建引导

### 触发条件

操作 A 未找到匹配的 Skill，且当前任务满足"Skill 创建价值判断标准"中至少 2 条。

### 流程

```
1. 向用户提出建议：
   "这类任务可以通过创建一个 [建议 Skill 名] 来自动化"
2. 给出 1-3 句方案概要：
   - 这个 Skill 会做什么
   - 核心工作机制（如 DSL 生成、YAML 直写、MCP 调用等）
   - 预估能节省的重复劳动
3. 询问用户选择：
   a) "继续讨论并创建" → 进入创建流程
   b) "以后再说" → 进入延期记录流程
   c) "不需要" → 结束，正常执行当前任务
```

### a) 创建流程

```
1. 使用 Claude Code 内置的 Skill Creator（通过 /skill 命令或 Skill 工具）创建新 Skill
2. 将以下上下文传递给 Skill Creator 流程：
   - 触发创建的原始任务描述
   - Orchestrator 的方案概要
   - 建议的 Skill 名称
3. 按 Skill Creator 的标准流程完成 Discovery → Design → Implementation → Verification
4. 创建完成后，要求用户对新 Skill 进行实际测试
5. 测试通过后，执行操作 C 同步 Registry
```

### b) 延期记录流程

```
1. 读取 deferred-decisions Skill（路径: .claude/skills/deferred-decisions/SKILL.md）
2. 按其"操作 A：记录延期方案"流程，将 Skill 创建建议记录为 deferred item
3. tags 中包含 "skill-creation" 和相关领域标签
4. context 中记录方案概要，便于未来回忆
```

## 操作 C：Registry 同步

### 触发条件

- 新 Skill 被创建后
- 已有 Skill 的 SKILL.md 被实质性修改后（如能力范围变化、触发场景变化）

### 流程

```
1. 读取目标 Skill 的 SKILL.md
2. 从 frontmatter 提取 name 和 description
3. 从正文提取核心能力和触发场景关键词
4. 读取 registry.md
5. 新增或更新对应条目，遵循 registry.md 中定义的条目格式
6. 写回 registry.md
```

### 条目格式

参见 [registry.md](registry.md) 中的条目结构。

## Skill 创建价值判断标准

当操作 A 无匹配时，Agent 使用以下标准评估是否建议创建新 Skill。
满足 **2 条及以上** 即认为值得建议：

1. **频次**：该类任务预计会出现 3 次以上
2. **模式明确**：任务有明确的输入/输出模式（输入 X → 产出 Y）
3. **步骤繁多**：手动操作步骤 >= 5 步，或涉及 >= 3 个文件的协调修改
4. **易错**：存在容易出错的重复性操作（如 GUID 填写、格式对齐等）
5. **可自动化**：可以通过生成 DSL / YAML / 配置文件 / MCP 调用来替代手动操作

不满足标准时，Agent 正常执行任务，不提出创建建议。

## 与其他系统的协作

| 系统 | 关系 | 说明 |
|------|------|------|
| Claude Code 内置 Skill Creator | 下游委托 | 操作 B 创建流程的执行者 |
| `deferred-decisions` Skill | 下游工具 | 操作 B 延期记录的执行者 |
| `skill-self-iteration` Rule | 并行 | 它负责单个 Skill 的经验积累，Orchestrator 负责 Skill 间的调度 |
| `deferred-recall` Rule | 协同 | Orchestrator 延期的建议通过 deferred-recall 在未来自动提醒 |
| `forskill-convention` Rule | 兼容 | 新 Skill 如需 Editor 脚本，仍遵循 ForSkill 约定 |

## 自迭代日志

本节记录使用本 Skill 过程中发现的必要检查项。

### 已知必要检查

1. **收尾动作级联遗漏** — 当 Agent 遗漏了一个收尾动作（如 changelog 写入）后，后续的收尾动作（自迭代、Registry 同步）也会被一并遗漏，因为它们都在同一个"收尾阶段"。`changelog-recall.md` 中的 Checklist 化设计可以打断这种级联——每项独立检查，不依赖前一项的执行记忆。