git init
This commit is contained in:
11
.cursor/deferred/registry.md
Normal file
11
.cursor/deferred/registry.md
Normal file
@@ -0,0 +1,11 @@
|
||||
# Deferred Decisions Registry
|
||||
|
||||
## Active Items
|
||||
|
||||
(暂无延期方案)
|
||||
|
||||
---
|
||||
|
||||
## Completed / Cancelled Items
|
||||
|
||||
(暂无已完成或已废弃的方案)
|
||||
39
.cursor/rules/common/baserule.mdc
Normal file
39
.cursor/rules/common/baserule.mdc
Normal 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/`
|
||||
21
.cursor/rules/common/deferred-recall.mdc
Normal file
21
.cursor/rules/common/deferred-recall.mdc
Normal 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
|
||||
64
.cursor/rules/common/epee-orchestrator.mdc
Normal file
64
.cursor/rules/common/epee-orchestrator.mdc
Normal 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 时须预置空的自迭代日志章节
|
||||
3
.vscode/settings.json
vendored
Normal file
3
.vscode/settings.json
vendored
Normal file
@@ -0,0 +1,3 @@
|
||||
{
|
||||
"AndreaNovelHelper.workspaceDisabled": true
|
||||
}
|
||||
Reference in New Issue
Block a user