初始化提示流程
This commit is contained in:
127
.cursor/skills/epee-orchestrator/SKILL.md
Normal file
127
.cursor/skills/epee-orchestrator/SKILL.md
Normal file
@@ -0,0 +1,127 @@
|
||||
---
|
||||
name: epee-orchestrator
|
||||
description: >-
|
||||
EPEE Skill Orchestrator:元层调度系统。检测任务是否可由已有 Skill 处理并分流,
|
||||
或发现 Skill 缺口并引导创建新 Skill。当 Agent 遇到手动配置密集、重复模式明确、
|
||||
手工指引过长的任务时触发。也用于 Skill Registry 的维护和同步。
|
||||
---
|
||||
|
||||
# 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. 委托给 create-skill Skill(路径: ~/.cursor/skills-cursor/create-skill/SKILL.md)
|
||||
2. 将以下上下文传递给 create-skill 流程:
|
||||
- 触发创建的原始任务描述
|
||||
- Orchestrator 的方案概要
|
||||
- 建议的 Skill 名称
|
||||
3. 按 create-skill 的标准流程完成 Discovery → Design → Implementation → Verification
|
||||
4. 创建完成后,要求用户对新 Skill 进行实际测试
|
||||
5. 测试通过后,执行操作 C 同步 Registry
|
||||
```
|
||||
|
||||
### b) 延期记录流程
|
||||
|
||||
```
|
||||
1. 读取 deferred-decisions Skill(路径: .cursor/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 正常执行任务,不提出创建建议。
|
||||
|
||||
## 与其他系统的协作
|
||||
|
||||
| 系统 | 关系 | 说明 |
|
||||
|------|------|------|
|
||||
| `create-skill` Skill | 下游委托 | 操作 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.mdc` 中的 Checklist 化设计可以打断这种级联——每项独立检查,不依赖前一项的执行记忆。
|
||||
Reference in New Issue
Block a user