大改版,可以针对不同项目引擎进行初始化
This commit is contained in:
@@ -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 的同步作为独立检查项。
|
||||
|
||||
@@ -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、初始化 cursor、cursor 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.md、insights.md、golden-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
|
||||
|
||||
Reference in New Issue
Block a user