cursor Init 完善多人协同changelog,以及godot相关基础skill和代码规范

This commit is contained in:
Nostars Developer
2026-07-15 14:38:08 +08:00
parent fc8557f2a9
commit 6446261c69
56 changed files with 3523 additions and 1584 deletions

View File

@@ -93,7 +93,8 @@ description: >-
### 条目格式
参见 [registry.md](registry.md) 中的条目结构。
参见 [registry.md](registry.md) 中的条目结构。Registry 条目必须对应磁盘上真实存在的
Skill删除 Skill 时同步移除条目。
## Skill 创建价值判断标准
@@ -114,9 +115,8 @@ description: >-
|------|------|------|
| `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 约定 |
| `deferred-recall` Rule | 协同 | 延期建议通过 deferred-recall 在未来自动提醒 |
| `cursor-init` Skill | 校准 | 初始化时把 Registry 校准为实际 8 个 Skill |
## 自迭代日志
@@ -124,4 +124,6 @@ description: >-
### 已知必要检查
1. **收尾动作级联遗漏** — 当 Agent 遗漏了一个收尾动作(如 changelog 写入)后,后续的收尾动作自迭代、Registry 同步)也会被一并遗漏,因为它们都在同一个"收尾阶段"。`changelog-recall.mdc` 中的 Checklist 化设计可以打断这种级联——每项独立检查,不依赖前一项的执行记忆。
1. **收尾动作级联遗漏** — 当 Agent 遗漏了一个收尾动作(如 changelog 写入)后,
后续的 Registry 同步也容易遗漏。每次创建、删除或实质修改 Skill 后都应把
Registry 同步作为独立检查项。

View File

@@ -1,17 +1,15 @@
# EPEE Skill Registry
> 本文件由 EPEE Skill Orchestrator 维护,记录所有已实现 Skill 的摘要信息
> 每次创建/修改 Skill 后必须同步更新(参见 `epee-orchestrator.mdc` Rule
> 本文件由 EPEE Skill Orchestrator 维护,只登记磁盘上真实存在的 Skill
> 创建、删除或实质修改 Skill 后必须同步更新。
## 条目格式说明
## 条目格式
每个条目包含以下字段:
- **类型**项目级 / 个人级 / 基础设施
- **能力**1 句话核心能力描述
- **触发场景**:逗号分隔的关键词/短语,用于与任务特征匹配
- **输出**该 Skill 的产出物
- **路径**SKILL.md 的相对路径
- **备注**(可选):特殊说明
- **类型**:基础设施 / 个人级
- **能力**该 Skill 做什么
- **触发场景**:何时使用
- **输出**:实际产出
- **路径**存在的 `SKILL.md` 相对路径
---
@@ -19,52 +17,56 @@
### cursor-init
- **类型**: 基础设施
- **能力**: 把从模板 clone 或复制过来的 .cursor/ 重置为新项目的干净起点——按 baserule 归位原有 rules/skills清理源项目的项目专用数据重建 registry交互式生成 .gitignore最后写入 `.cursor/.init-done` sentinel
- **触发场景**: 首次会话自动触发(.cursor/.init-done 缺失时由 cursor-init-recall 规则引导);关键词:"初始化cursor"、"cursor init"、"重置 cursor"、"reset cursor"、"按 baserule 归位"、"补 gitignore"、"生成 gitignore"、"gitignore 模板"
- **输出**: 清理后`.cursor/` 结构规范清单完整、项目级内容已清、数据文件为模板、registry 仅含通用条目)、项目根 `.gitignore`(可选)`.cursor/.init-done` sentinel
- **能力**: 以精确 canonical 白名单初始化或重置 `.cursor/`,保留 Godot baseline清理历史运行数据生成本机配置与 `.gitignore`,并在验证成功后写 sentinel
- **触发场景**: 首次缺少 `.cursor/.init-done`"初始化 cursor"、"cursor init"、"重置 cursor"、"补 gitignore"
- **输出**: 干净且通过验证`.cursor/` 基线、gitignored `local-env.json`、可选 `.gitignore``.cursor/.init-done`
- **路径**: .cursor/skills/cursor-init/SKILL.md
- **备注**: 首次通过 sentinel 自动触发一次,之后仅关键词手动触发;破坏性操作必须 dry-run设计为幂等重复运行无害阶段 7 失败时不写 sentinel 保证可恢复
### deferred-decisions
- **类型**: 基础设施
- **能力**: 记录和追踪延期的技术方案/决策,在关联任务出现时主动提醒
- **能力**: 记录和追踪延期的技术方案决策,在关联任务出现时提醒
- **触发场景**: "以后再做"、"先不做"、"defer"、延期方案管理、延期回顾
- **输出**: .cursor/deferred/registry.md 条目
- **输出**: `.cursor/deferred/registry.md` 条目及状态更新
- **路径**: .cursor/skills/deferred-decisions/SKILL.md
- **备注**: 不参与任务分流匹配,仅作为 Orchestrator 的下游工具
### dev-changelog
- **类型**: 基础设施
- **能力**: 三层开发进程记录系统Agent 完成代码改动后自动记录,提供一句话概要到完整日志的多级上下文
- **触发场景**: "开发日志"、"changelog"、"最近改了什么"、"回顾改动"、"查看开发记录"、代码改动后自动写入
- **输出**: .cursor/changelog/ 下的 changelog-full.md、changelog-recent.md、changelog-headlines.md
- **能力**: 以一条一文件的 fragment 记录开发改动,并确定性重建完整、近期、概要和作者四个视图
- **触发场景**: 实质代码或配置改动完成后、"开发日志"、"changelog"、"最近改了什么"、"回顾改动"
- **输出**: `.cursor/changelog/entries/<author>/<id>.md` 与四个生成视图
- **路径**: .cursor/skills/dev-changelog/SKILL.md
### epee-orchestrator
- **类型**: 基础设施
- **能力**: 匹配已有 Skill、发现可复用工作流缺口并维护与磁盘一致的 Skill Registry
- **触发场景**: 手动配置密集、重复模式明确、步骤繁多、Skill 缺口发现、Registry 同步
- **输出**: Skill 分流或创建建议,以及 `.cursor/skills/epee-orchestrator/registry.md` 更新
- **路径**: .cursor/skills/epee-orchestrator/SKILL.md
### pitfall-journal
- **类型**: 基础设施
- **能力**: 记录开发中踩过的坑(非显而易见问题),在遇到同类问题时自动检索匹配已有经验
- **触发场景**: debug 完成、"踩坑"、"之前遇到过"、"坑"、进入 Debug mode、同类错误反复出现
- **输出**: .cursor/pitfalls/pitfalls.md 条目
- **能力**: 记录非显而易见问题的症状、根因、解法和防御措施,并在同类问题出现时检索
- **触发场景**: debug 完成、问题反复出现、"踩坑"、"之前遇到过"、进入 Debug mode
- **输出**: `.cursor/pitfalls/pitfalls.md` 条目或匹配到的既有经验
- **路径**: .cursor/skills/pitfall-journal/SKILL.md
### problem-distillery
- **类型**: 基础设施
- **能力**: 追踪反复出现的顽固问题,记录解决过程和弯路,定期蒸馏精炼方法论,经实践验证后自动升级为新会话常规注入
- **触发场景**: "还有问题"、"没解决"、"还是一样"、"又出现了"、"试了好多次"、"反复出现"、Agent 意识到同一问题尝试 2 次以上未解决、"蒸馏"、"总结经验"
- **输出**: .cursor/distillery/ 下的 problems.mdinsights.mdgolden-rules.md
- **能力**: 追踪反复未解决的问题,蒸馏方法论,并把经验证的 insight 升级为 Golden Rule
- **触发场景**: "还有问题"、"没解决"、"还是一样"、同一问题尝试两次以上、"蒸馏"、"总结经验"
- **输出**: `.cursor/distillery/problems.md``insights.md``golden-rules.md`
- **路径**: .cursor/skills/problem-distillery/SKILL.md
### profile-memory
- **类型**: 个人级
- **能力**: 在对话中被动检测用户个人特质和项目信息,经确认持久化为精简画像和详细日志
- **触发场景**: "画像"、"profile"、"我的偏好"、"查看画像"、"项目信息"、"查看项目画像"、用户主动管理画像
- **输出**: ~/.cursor/profile/user-profile.md、.cursor/profile/project-profile.md 及对应 log 文件
- **能力**: 检测并经确认持久化用户偏好与项目画像,支持查看、修改、删除和溯源
- **触发场景**: 持久偏好或项目决策出现、"画像"、"profile"、"我的偏好"、"查看项目画像"
- **输出**: 用户与项目的精简 Profile 及详细 Log
- **路径**: .cursor/skills/profile-memory/SKILL.md
### epee-orchestrator
- **类型**: 基础设施
- **能力**: 元层调度系统,检测任务是否可由已有 Skill 处理并分流,或发现 Skill 缺口并引导创建新 Skill同时负责 Skill Registry 维护
- **触发场景**: 手动配置密集、重复模式明确、手工指引过长的任务、Skill 缺口发现、Registry 同步维护
- **输出**: 分流决策(调用已有 Skill / 创建新 Skill、.cursor/skills/epee-orchestrator/registry.md 维护
- **路径**: .cursor/skills/epee-orchestrator/SKILL.md
- **备注**: 元层 Skill自身注册以便其他 Agent 了解调度能力的可用性
### html-doc
- **类型**: 个人级
- **能力**: 生成统一深色主题的单文件 HTML 文档,并可选提供本地暂存和回传批注功能
- **触发场景**: HTML 参考手册、说明页、报告、清单、统一 HTML 样式、可批注文档
- **输出**: 内联 CSS/JS 的自包含 `.html` 文档
- **路径**: .cursor/skills/html-doc/SKILL.md