This commit is contained in:
2026-04-11 14:02:06 +08:00
commit 4c979285c6
5 changed files with 138 additions and 0 deletions

View File

@@ -0,0 +1,11 @@
# Deferred Decisions Registry
## Active Items
(暂无延期方案)
---
## Completed / Cancelled Items
(暂无已完成或已废弃的方案)

View File

@@ -0,0 +1,39 @@
---
description: 跨项目底层通用约定(语言、目录归属)
alwaysApply: true
---
## 语言约定
Agent回复时使用简体中文。
代码注释时尽量使用简体中文。
写SKILL的时候文档部分也尽量使用简体中文。
专业术语和项目专有名词不受此语言限制,通常是英文则保留。
## Rules / Skills 目录归属约定
本项目使用以下目录结构区分跨项目通用内容与项目专属内容:
### Rules
| 目录 | 用途 | 示例 |
|------|------|------|
| `.cursor/rules/common/` | 跨项目通用规则,开新项目时可直接复制 | 语言约定、Orchestrator 触发、延期方案回忆 |
| `.cursor/rules/project/` | 当前项目专属规则 | 项目架构约定、框架特定规范、项目专属工作流 |
### Skills
| 位置 | 用途 | 示例 |
|------|------|------|
| `~/.cursor/skills/` | 跨项目通用 Skill全局可用 | epee-orchestrator、deferred-decisions |
| `.cursor/skills/` | 当前项目专属 Skill | 项目特定的代码生成、配置管理等 |
### Agent 创建 Rule 或 Skill 时必须遵守
1. **先判断归属**:新建 Rule 或 Skill 前,评估其是否为跨项目通用内容
2. **如果不确定,必须询问用户**"这个 Rule/Skill 是通用的还是项目专属的?"
3. 确认后放入对应目录:
- 通用 Rule → `.cursor/rules/common/`
- 项目专属 Rule → `.cursor/rules/project/`
- 通用 Skill → `~/.cursor/skills/`
- 项目专属 Skill → `.cursor/skills/`

View File

@@ -0,0 +1,21 @@
---
description: 每次会话开始时扫描延期方案记录,在任务与已有 deferred item 关联时主动提醒用户
alwaysApply: true
---
## 延期方案主动回忆
每次会话处理用户第一个任务前,执行以下检查:
1. 读取 `.cursor/deferred/registry.md`(不存在则跳过)
2. 扫描所有 `status: deferred` 的条目
3. 将每个条目的 **tags** 和 **related_files** 与当前任务的关键词/文件做匹配
4. 如果匹配到关联条目,在回复开头简要提醒:
> 提醒:你之前有一个延期方案 **[标题]** 与当前任务相关tags: xxx。要一并处理吗
5. 每个条目每次会话最多提醒一次,不重复打扰
### 注意
- 只匹配 `status: deferred` 的条目(`reminded` / `in_progress` 不再提醒)
- 提醒应简洁,不超过 2 行,不打断用户主线任务
- 具体的记录/管理操作请参考 `deferred-decisions` Skill

View File

@@ -0,0 +1,64 @@
---
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 实际内容一致
### Skill 自迭代(强制)
每个 SKILL.md 必须包含一个"自迭代日志"章节,用于记录使用该 Skill 过程中发现的经验教训。
**触发条件** — 在创建或使用任何 Skill 时,遇到以下情况应触发自迭代流程:
1. 因信息缺失导致生成结果错误或构建失败
2. 用户需要反复补充同类信息
3. 生成产物与用户预期存在系统性偏差
**流程**
1. 识别问题根因,归纳为一条简明的检查项
2. 向用户确认:"是否要将此项记录到该 Skill 的自迭代日志中?"
3. 用户同意后,追加到对应 SKILL.md 的"已知必要检查"列表
4. 后续使用该 Skill 时,必须遵守日志中已记录的所有检查项
**SKILL.md 中的格式**
```markdown
## 自迭代日志
本节记录使用本 Skill 过程中发现的必要检查项。
### 已知必要检查
1. **检查项名称** — 简要说明原因和应对方式。
```
**原则**
- 每条检查项应当**具体可执行**,而非泛泛的提醒
- 检查项只增不删,除非用户明确要求移除
- 新建 Skill 时须预置空的自迭代日志章节