Files
EPEEAIKit/.cursor/rules/common/epee-orchestrator.mdc

71 lines
2.8 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
description: >-
EPEE Skill Orchestrator 触发入口。检测当前任务是否可由已有 Skill 处理,
或是否值得创建新 Skill。同时管理 Skill 变更后的 Registry 同步和自迭代经验积累。
alwaysApply: true
---
## EPEE Skill Orchestrator — 触发雷达
### 被动检测
Agent 在制定方案或执行任务过程中,如果发现当前任务符合以下**任意一条**特征,
必须读取 `epee-orchestrator` Skill 的 SKILL.md 并执行其分流流程:
1. **手动配置密集**:任务需要用户在 IDE 或工具中进行大量手动配置
(如批量填写配置字段、逐一调整参数等)
2. **重复模式明确**:同类操作预计会反复出现(如批量创建同结构的配置文件、
批量设置同类模块等)
3. **手工指引过长**Agent 发现自己正在生成超过 10 步的"手动操作步骤"
而非直接产出代码或配置文件
### Registry 同步(强制)
每次**创建**或**修改**任何 Skill包括 SKILL.md 内容变更、新增 Skill 等)后,
Agent **必须**执行以下操作:
1. 读取 `epee-orchestrator` Skill 目录下的 `registry.md`
2. 更新或新增对应 Skill 的条目(格式参见 registry.md 中的条目结构)
3. 确保条目中的能力描述和触发场景与 Skill 实际内容一致
> **注意**:此项已纳入 `changelog-recall.mdc` 的"任务完成 Checklist"第 3 项。
> 如果 Agent 在 checklist 阶段发现遗漏,必须立即补执行。
### Skill 自迭代(强制)
每个 SKILL.md 必须包含一个"自迭代日志"章节,用于记录使用该 Skill 过程中发现的经验教训。
**触发条件** — 在创建或使用任何 Skill 时,遇到以下情况应触发自迭代流程:
1. 因信息缺失导致生成结果错误或构建失败
2. 用户需要反复补充同类信息
3. 生成产物与用户预期存在系统性偏差
> **注意**:此项已纳入 `changelog-recall.mdc` 的"任务完成 Checklist"第 4 项。
> Agent 不应等到"下次使用 Skill 时"才想起自迭代——当次就应检查。
**流程**
1. 识别问题根因,归纳为一条简明的检查项
2. 向用户确认:"是否要将此项记录到该 Skill 的自迭代日志中?"
3. 用户同意后,追加到对应 SKILL.md 的"已知必要检查"列表
4. 后续使用该 Skill 时,必须遵守日志中已记录的所有检查项
**SKILL.md 中的格式**
```markdown
## 自迭代日志
本节记录使用本 Skill 过程中发现的必要检查项。
### 已知必要检查
1. **检查项名称** — 简要说明原因和应对方式。
```
**原则**
- 每条检查项应当**具体可执行**,而非泛泛的提醒
- 检查项只增不删,除非用户明确要求移除
- 新建 Skill 时须预置空的自迭代日志章节