commit 4c979285c629194334faad5085b0925e2ccee62c Author: Shin@HOME Date: Sat Apr 11 14:02:06 2026 +0800 git init diff --git a/.cursor/deferred/registry.md b/.cursor/deferred/registry.md new file mode 100644 index 0000000..c592c87 --- /dev/null +++ b/.cursor/deferred/registry.md @@ -0,0 +1,11 @@ +# Deferred Decisions Registry + +## Active Items + +(暂无延期方案) + +--- + +## Completed / Cancelled Items + +(暂无已完成或已废弃的方案) diff --git a/.cursor/rules/common/baserule.mdc b/.cursor/rules/common/baserule.mdc new file mode 100644 index 0000000..c6fabcd --- /dev/null +++ b/.cursor/rules/common/baserule.mdc @@ -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/` diff --git a/.cursor/rules/common/deferred-recall.mdc b/.cursor/rules/common/deferred-recall.mdc new file mode 100644 index 0000000..1f66c76 --- /dev/null +++ b/.cursor/rules/common/deferred-recall.mdc @@ -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 diff --git a/.cursor/rules/common/epee-orchestrator.mdc b/.cursor/rules/common/epee-orchestrator.mdc new file mode 100644 index 0000000..19fea9f --- /dev/null +++ b/.cursor/rules/common/epee-orchestrator.mdc @@ -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 时须预置空的自迭代日志章节 diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 0000000..68d1f85 --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,3 @@ +{ + "AndreaNovelHelper.workspaceDisabled": true +} \ No newline at end of file