大改版,可以针对不同项目引擎进行初始化

This commit is contained in:
Nostars Developer
2026-07-27 15:09:13 +08:00
parent 6446261c69
commit 62efb3778c
112 changed files with 11020 additions and 899 deletions

View File

@@ -84,17 +84,18 @@ description: >-
```
1. 读取目标 Skill 的 SKILL.md
2. 从 frontmatter 提取 name 和 description
3. 从正文提取核心能力和触发场景关键词
4. 读取 registry.md
5. 新增或更新对应条目,遵循 registry.md 中定义的条目格式
6. 写回 registry.md
2. 更新 .cursor/bootstrap/skills.json 中对应条目的作用域、能力、触发场景和输出
3. 若 Skill 是项目类型专属,同时更新所属 type manifest 的 skills 与 payload 文件树
4. 若 Skill 是 common同时更新 common.manifest.json 的 skills 与 canonical_files
5. 运行:
python .cursor/bootstrap/tools/cursor_init.py --sync-registry
6. 运行初始化引擎测试与 --check确认 Registry 和磁盘活动 Skill 一致
```
### 条目格式
参见 [registry.md](registry.md) 中的条目结构。Registry 条目必须对应磁盘上真实存在的
Skill删除 Skill 时同步移除条目
机读格式见 `.cursor/bootstrap/skills.json`[registry.md](registry.md) 是生成视图,不手改。
Registry 条目必须对应磁盘上真实存在的活动 Skill删除 Skill 时同步移除机读条目和 manifest 引用
## Skill 创建价值判断标准
@@ -116,7 +117,7 @@ Skill删除 Skill 时同步移除条目。
| `create-skill` Skill | 下游委托 | 操作 B 创建流程的执行者 |
| `deferred-decisions` Skill | 下游工具 | 操作 B 延期记录的执行者 |
| `deferred-recall` Rule | 协同 | 延期建议通过 deferred-recall 在未来自动提醒 |
| `cursor-init` Skill | 校准 | 初始化时把 Registry 校准为实际 8 个 Skill |
| `cursor-init` Skill | 校准 | 初始化时按 common + 所选项目类型生成活动 Registry |
## 自迭代日志
@@ -126,4 +127,4 @@ Skill删除 Skill 时同步移除条目。
1. **收尾动作级联遗漏** — 当 Agent 遗漏了一个收尾动作(如 changelog 写入)后,
后续的 Registry 同步也容易遗漏。每次创建、删除或实质修改 Skill 后都应把
Registry 同步作为独立检查项。
`skills.json`、所属 manifest 与生成 Registry 同步作为独立检查项。

View File

@@ -1,66 +1,56 @@
# EPEE Skill Registry
> 本文件由 EPEE Skill Orchestrator 维护,只登记磁盘上真实存在的 Skill
> 创建、删除或实质修改 Skill 后必须同步更新。
## 条目格式
- **类型**:基础设施 / 个人级
- **能力**:该 Skill 做什么
- **触发场景**:何时使用
- **输出**:实际产出
- **路径**:存在的 `SKILL.md` 相对路径
---
> 本文件由 `.cursor/bootstrap/tools/cursor_init.py` 根据 `skills.json` 生成
> 创建、删除或实质修改 Skill 后必须更新机读源并重新生成
## 已注册 Skill
### cursor-init
- **类型**: 基础设施
- **能力**: 以精确 canonical 白名单初始化或重置 `.cursor/`,保留 Godot baseline清理历史运行数据生成本机配置与 `.gitignore`,并在验证成功后写 sentinel
- **触发场景**: 首次缺少 `.cursor/.init-done`、"初始化 cursor"、"cursor init"、"重置 cursor"、"补 gitignore"
- **输出**: 干净且通过验证的 `.cursor/` 基线、gitignored `local-env.json`、可选 `.gitignore``.cursor/.init-done`
- **能力**: 按机读 catalog 与 manifest 安全初始化或重置 Cursor 基础设施,并校验活动 Rules、Skills、Hooks 与项目类型配置
- **触发场景**: 首次缺少 .cursor/.init-done初始化 cursorcursor init重置 cursor补 gitignore
- **输出**: 通过验证的 common 基线、所选项目类型活动文件、本机配置、Git managed blocks 与 .cursor/.init-done
- **路径**: .cursor/skills/cursor-init/SKILL.md
### deferred-decisions
- **类型**: 基础设施
- **能力**: 记录和追踪延期的技术方案或决策,并在关联任务出现时提醒
- **触发场景**: "以后再做"、"先不做"、"defer"、延期方案管理、延期回顾
- **输出**: `.cursor/deferred/registry.md` 条目及状态更新
- **触发场景**: 以后再做、先不做、defer、延期方案管理、延期回顾
- **输出**: .cursor/deferred/registry.md 条目及状态更新
- **路径**: .cursor/skills/deferred-decisions/SKILL.md
### dev-changelog
- **类型**: 基础设施
- **能力**: 以一条一文件的 fragment 记录开发改动,并确定性重建完整、近期、概要和作者四个视图
- **触发场景**: 实质代码或配置改动完成后、"开发日志"、"changelog"、"最近改了什么"、"回顾改动"
- **输出**: `.cursor/changelog/entries/<author>/<id>.md` 与四个生成视图
- **触发场景**: 实质代码或配置改动完成后、开发日志changelog最近改了什么回顾改动
- **输出**: .cursor/changelog/entries/<author>/<id>.md 与四个生成视图
- **路径**: .cursor/skills/dev-changelog/SKILL.md
### epee-orchestrator
- **类型**: 基础设施
- **能力**: 匹配已有 Skill、发现可复用工作流缺口并维护与磁盘一致的 Skill Registry
- **能力**: 匹配已有 Skill、发现可复用工作流缺口并维护与活动 Skill 集合一致的 Registry
- **触发场景**: 手动配置密集、重复模式明确、步骤繁多、Skill 缺口发现、Registry 同步
- **输出**: Skill 分流或创建建议,以及 `.cursor/skills/epee-orchestrator/registry.md` 更新
- **输出**: Skill 分流或创建建议,以及由 skills.json 生成的 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
- **类型**: 基础设施
- **能力**: 追踪反复未解决的问题,蒸馏方法论,并把经验证的 insight 升级为 Golden Rule
- **触发场景**: "还有问题"、"没解决"、"还是一样"、同一问题尝试两次以上、"蒸馏"、"总结经验"
- **输出**: `.cursor/distillery/problems.md``insights.md``golden-rules.md`
- **触发场景**: 还有问题、没解决、还是一样、同一问题尝试两次以上、蒸馏总结经验
- **输出**: .cursor/distillery/problems.mdinsights.mdgolden-rules.md
- **路径**: .cursor/skills/problem-distillery/SKILL.md
### profile-memory
- **类型**: 个人级
- **能力**: 检测并经确认持久化用户偏好与项目画像,支持查看、修改、删除和溯源
- **触发场景**: 持久偏好或项目决策出现、"画像"、"profile"、"我的偏好"、"查看项目画像"
- **触发场景**: 持久偏好或项目决策出现、画像profile我的偏好查看项目画像
- **输出**: 用户与项目的精简 Profile 及详细 Log
- **路径**: .cursor/skills/profile-memory/SKILL.md
@@ -68,5 +58,5 @@
- **类型**: 个人级
- **能力**: 生成统一深色主题的单文件 HTML 文档,并可选提供本地暂存和回传批注功能
- **触发场景**: HTML 参考手册、说明页、报告、清单、统一 HTML 样式、可批注文档
- **输出**: 内联 CSS/JS 的自包含 `.html` 文档
- **输出**: 内联 CSS/JS 的自包含 .html 文档
- **路径**: .cursor/skills/html-doc/SKILL.md