大改版，可以针对不同项目引擎进行初始化
This commit is contained in:
Nostars Developer
@@ -1,199 +1,132 @@
|
||||
---
|
||||
name: cursor-init
|
||||
description: >-
|
||||
初始化或重置项目的 .cursor 基础设施：保留 canonical Rules、Skills、Hooks 与
|
||||
Godot baseline，清除模板历史数据，采集本机环境，生成 .gitignore，并在验证成功后
|
||||
写入 .init-done。首次缺少 sentinel 时自动使用；也用于“初始化 cursor”、
|
||||
“重置 cursor”、“补 gitignore”等请求。
|
||||
按项目内 catalog 与 manifest 初始化或重置 Cursor 基础设施。首次缺少 sentinel，
|
||||
或用户要求初始化、重置、补齐 Git 忽略配置时使用；只展示当前 ready 的项目类型，
|
||||
经 dry-run 确认后物化对应 Rules、Skills、Hooks 与本机配置。
|
||||
---
|
||||
|
||||
# Cursor Init
|
||||
|
||||
把模板仓库或复制来的 `.cursor/` 变成可安全使用、可重复执行的 Godot 项目基线。
|
||||
|
||||
详细白名单、清理模式、状态模板、sentinel 和 `.gitignore` 片段统一见
|
||||
[reference.md](reference.md)。执行全流程或仅补 `.gitignore` 前都必须直接读取该文件，
|
||||
不得凭记忆重建清单。
|
||||
把复制到目标仓库的 common Cursor 基线与惰性项目 bundle，转换为只激活一个
|
||||
`project_type` 的可重复状态。流程与安全契约见 [reference.md](reference.md)，机器真相源位于
|
||||
`.cursor/bootstrap/`。
|
||||
|
||||
## 入口
|
||||
|
||||
### 首次自动初始化
|
||||
- 首次会话：`.cursor/.init-done` 不存在，且用户同意初始化。
|
||||
- 手动全流程：`初始化 cursor`、`cursor init`、`重置 cursor`、`reset cursor`。
|
||||
- 只补 Git 配置：`补 gitignore`、`生成 .gitignore`、`gitignore 模板`。
|
||||
|
||||
每次会话首次响应前由 `.cursor/rules/common/cursor-init-recall.mdc` 检查
|
||||
`.cursor/.init-done`。若 sentinel 不存在：
|
||||
|
||||
1. 暂存用户原请求，说明需要先初始化。
|
||||
2. 获得用户同意后执行本 Skill 的阶段 0–7。
|
||||
3. 仅在阶段 6 全部通过后写 sentinel。
|
||||
4. 初始化成功后继续原请求。
|
||||
|
||||
若用户暂时拒绝，尊重选择；不要写 sentinel，下次会话仍会提醒。
|
||||
|
||||
### 手动全流程
|
||||
|
||||
触发词包括：`初始化 cursor`、`cursor init`、`重置 cursor`、`reset cursor`、
|
||||
“清理复制来的 .cursor”、“按基线归位”。
|
||||
|
||||
sentinel 已存在时必须先展示其元数据并再次确认；不得把手动触发当作无提示重置。
|
||||
|
||||
### 仅补 `.gitignore`
|
||||
|
||||
触发词包括：`补 gitignore`、`生成 .gitignore`、`gitignore 模板`。
|
||||
只执行阶段 5；不得改动 `.cursor/` 的其他内容。若 sentinel 存在，只更新
|
||||
`gitignore_generated`；若不存在，询问是否改跑完整初始化，不得只为补
|
||||
`.gitignore` 创建 sentinel。
|
||||
用户明确要求跳过时不得执行；本初始化框架源码仓也不得因缺少 sentinel 被自动初始化。
|
||||
|
||||
## 不可协商的安全契约
|
||||
|
||||
1. **先 dry-run，后确认，才写入**：删除、重置、移动、覆盖、追加都进入同一份预览清单。
|
||||
2. **canonical 永不删除**：尤其不得清空 `.cursor/rules/project/`；六个 Godot baseline
|
||||
project rules 必须保留。
|
||||
3. **精确白名单**：`.cursor/skills/` 最终只能有 reference 中列出的 8 个目录。
|
||||
4. **不触碰来源树**：只处理目标项目；不得删除或修改 `source/`。
|
||||
5. **幂等**：同一输入重复执行，第二次应只产生空或等价 dry-run。
|
||||
6. **失败不写 sentinel**：取消、异常、验证失败或未决冲突都不得创建/更新
|
||||
`.cursor/.init-done`。
|
||||
7. **运行态不冒充 canonical**：`.cursor/local-env.json`、`.cursor/changelog/.changelog-ack`
|
||||
与 `.cursor/changelog/.session-start` 都是 gitignored 本机文件，不是 tracked 白名单项。
|
||||
8. **文本规范**：新写文本使用 UTF-8 无 BOM、LF。
|
||||
1. 先检查 Git 状态，再列出支持类型；未确认完整 dry-run 前不写文件。
|
||||
2. 类型选项只能来自脚本 `--list-types` 输出，不在对话中硬编码或展示 `draft` bundle。
|
||||
3. `.cursor/bootstrap/**` 是自包含可信源，初始化、重置和 cleanup 永不删除或覆盖。
|
||||
4. common canonical 缺失、foreign Rule/Skill、用户修改过的 managed 文件或摘要变化都是阻塞项。
|
||||
5. Apply 必须携带用户确认的 `PLAN_DIGEST`；扫描变化后重新 dry-run。
|
||||
6. 失败、取消或验证未通过时不得写 `.cursor/.init-done`。
|
||||
7. 新写文本使用 UTF-8 无 BOM、LF；不得安装第三方依赖。
|
||||
8. 不运行本 Skill 自行初始化当前 CursorInitGeneral 源码仓。
|
||||
|
||||
## 阶段 0：前置检查
|
||||
## 标准流程
|
||||
|
||||
1. 确认项目根存在 `.cursor/`；不存在则停止并说明缺失。
|
||||
2. 读取 `.cursor/.init-done`：
|
||||
- 不存在：进入首次初始化。
|
||||
- 存在：展示 `initialized_at`、`project_type`、`skill_version`，等待用户明确继续。
|
||||
3. 执行 `git status`。有未提交改动时建议先 commit/stash，并等待明确继续；非 Git
|
||||
仓库则建议备份，但可继续。
|
||||
4. 读取 [reference.md](reference.md)，声明本轮会保留、删除、重置、生成的范围。
|
||||
5. 未获得明确确认前不得进入写入阶段。
|
||||
### 阶段 0：前置检查
|
||||
|
||||
## 阶段 1：一次性采集本机配置
|
||||
1. 检查项目根、`.cursor/bootstrap/catalog.json` 与脚本是否存在。
|
||||
2. 读取现有 `.cursor/.init-done`；存在时展示 `project_type`、`skill_version` 与
|
||||
`manifest_digest`，重置或换类型前再次确认。
|
||||
3. 执行 `git status`；有未提交改动时提醒用户先处理，用户明确继续后才进入问卷。
|
||||
4. 确认项目声明 Python 3.10+，再运行脚本；版本不满足时停止，不修改业务文件迁就环境。
|
||||
|
||||
在**一轮提问**中采集：
|
||||
### 阶段 1：动态问卷
|
||||
|
||||
1. `changelog-author`：稳定、适合文件名的作者 handle。
|
||||
2. `shell`：`powershell`、`bash` 或 `zsh`；可把当前探测值作为默认。
|
||||
3. `godot4_path`：Godot 4 executable 的绝对路径；允许留空。
|
||||
先运行：
|
||||
|
||||
同一轮可附带询问 `.gitignore` 的写入方式（新建 / 追加 / 替换 / 跳过）和自定义忽略项，
|
||||
不要把三个环境字段拆成多轮追问。仅收集值，此阶段不写文件。
|
||||
```bash
|
||||
python .cursor/bootstrap/tools/cursor_init.py --list-types --json
|
||||
```
|
||||
|
||||
## 阶段 2：扫描、分类与 dry-run
|
||||
仅把输出中的类型作为单选项。用户选择后运行：
|
||||
|
||||
递归扫描 `.cursor/`，按 reference 分为：
|
||||
```bash
|
||||
python .cursor/bootstrap/tools/cursor_init.py --describe-type --project-type <type> --json
|
||||
```
|
||||
|
||||
- **A / canonical**：精确白名单，保留；缺失项记为阻塞错误。
|
||||
- **B / cleanup**：历史 fragment、备份、缓存、设备配置、ack、临时文件和状态数据。
|
||||
- **C / foreign**：不属于 A/B 的文件。
|
||||
在一轮提问中只采集 `collect_at_init` 未设为 `false` 且非 `sensitive` 的
|
||||
`local_env_fields`，并询问是否跳过 `.gitignore` / `.gitattributes` managed block。
|
||||
敏感字段只展示键名和说明，要求用户稍后手工填写 `.cursor/local-env.json`，不得在聊天、
|
||||
命令行或 `--set` 中索取。`general` 表示 common-only；common 不作为额外选项。
|
||||
|
||||
处理 C 组：
|
||||
### 阶段 2：dry-run
|
||||
|
||||
- 非白名单 Skill 必须从 `.cursor/skills/` 移除；如用户要保留，先迁出该目录再删原件。
|
||||
- 非 baseline project rule 视为模板项目遗留；逐项预览，确认后删除或迁出。
|
||||
- 通用 `.mdc` 可建议迁到 `.cursor/rules/common/`，但只有九个 common rule 属于本基线；
|
||||
最终仍需用户明确决定。
|
||||
- 重名冲突永远保留 canonical 版本；冲突副本只能在用户确认后临时放入
|
||||
`.cursor/_init-backup/`，并须在阶段 6 前移出或删除。
|
||||
把允许初始化采集的用户输入作为重复的 `--set KEY=VALUE` 传入；值含空格时按当前
|
||||
shell 正确引用。不得用 `--set` 传入 sensitive 或 `collect_at_init: false` 字段：
|
||||
|
||||
输出一份合并 dry-run，至少列出：
|
||||
```bash
|
||||
python .cursor/bootstrap/tools/cursor_init.py \
|
||||
--dry-run \
|
||||
--project-type <type> \
|
||||
--set shell=<shell> \
|
||||
--set changelog-author=<handle>
|
||||
```
|
||||
|
||||
- 保留及缺失的 canonical 项；
|
||||
- 删除的文件/目录；
|
||||
- 重置的状态文件；
|
||||
- C 组迁移/删除动作；
|
||||
- `local-env.json` 生成计划；
|
||||
- registry 重写计划；
|
||||
- `.gitignore` 新建/追加/替换计划。
|
||||
用户选择跳过 Git 文件时附加 `--skip-git-files`。dry-run 必须完整展示：
|
||||
|
||||
等待用户对整份计划明确确认。分类不清就问，不得猜。
|
||||
- 创建、更新、删除的 managed 文件；
|
||||
- 状态模板和 changelog 历史 cleanup；
|
||||
- foreign、冲突、缺失 common canonical 与必填输入；
|
||||
- `PLAN_DIGEST`。
|
||||
|
||||
## 阶段 3：执行 cleanup
|
||||
任何阻塞项都先处理并重新 dry-run。让用户确认整份清单与 digest，不拆成多次隐式确认。
|
||||
|
||||
严格按已确认 dry-run 和 reference 的 cleanup 表执行：
|
||||
### 阶段 3：Apply 与验证
|
||||
|
||||
1. 删除全部历史 changelog fragments，只保留 `entries/.gitkeep`。
|
||||
2. 删除全部 backup、cache、编译缓存、ack、session marker、日志和 init 临时文件。
|
||||
3. 删除旧 `.cursor/local-env.json`；后续从 example 重新生成。
|
||||
4. 删除非白名单 Skill；最终目录名必须恰好为 8 个。
|
||||
5. 保留六个 Godot baseline project rules，绝不执行“清空 rules/project”。
|
||||
6. 重置 deferred、pitfalls、distillery、profile 状态文件。
|
||||
7. 在 entries 为空后运行 `changelog_build.py`，确定性重建四个 changelog 视图。
|
||||
使用与 dry-run 完全相同的类型、`--set` 和 skip 参数，并附确认摘要：
|
||||
|
||||
某一步失败立即停止；不要继续“尽量完成”，也不要写 sentinel。
|
||||
```bash
|
||||
python .cursor/bootstrap/tools/cursor_init.py \
|
||||
--apply \
|
||||
--project-type <type> \
|
||||
--plan-digest <PLAN_DIGEST> \
|
||||
--set shell=<shell> \
|
||||
--set changelog-author=<handle>
|
||||
```
|
||||
|
||||
## 阶段 4：重建本机配置与 Registry
|
||||
脚本会：
|
||||
|
||||
### `local-env.json`
|
||||
1. 重算摘要并拒绝时序变化；
|
||||
2. 重置模板状态、清理历史运行数据；
|
||||
3. 只物化所选类型的 Rules/Skills，移除未选 bundle 的未修改 managed 文件；
|
||||
4. 生成 `local-env.example.json`、`local-env.json`、EPEE Registry 与 Hook scan profile；
|
||||
5. 更新 Git managed blocks（未跳过时）；
|
||||
6. 验证活动闭包，最后写 `.cursor/.init-state.json` 与 `.cursor/.init-done`。
|
||||
|
||||
1. 读取 `.cursor/local-env.example.json`。
|
||||
2. 深拷贝其 JSON 结构到 `.cursor/local-env.json`，保留 example 中不认识的键。
|
||||
3. 用阶段 1 的值设置 `changelog-author`、`shell`、`godot4_path`。
|
||||
4. `godot4_path` 留空时写空字符串，不伪造路径。
|
||||
5. 验证 JSON 可解析，且 `.gitignore` 忽略该文件。
|
||||
完成后运行：
|
||||
|
||||
不要引用或等待额外的环境检查 Rule；本阶段就是唯一初始化入口。
|
||||
```bash
|
||||
python .cursor/bootstrap/tools/cursor_init.py --check
|
||||
python .cursor/changelog/tools/changelog_build.py --check
|
||||
```
|
||||
|
||||
### Skill Registry
|
||||
任一失败都报告具体漂移，不手工伪造 sentinel。
|
||||
|
||||
将 `.cursor/skills/epee-orchestrator/registry.md` 校准为磁盘上的 8 个真实 Skill：
|
||||
## 只补 Git 配置
|
||||
|
||||
`cursor-init`、`deferred-decisions`、`dev-changelog`、`epee-orchestrator`、
|
||||
`pitfall-journal`、`problem-distillery`、`profile-memory`、`html-doc`。
|
||||
仍先动态列出并选择项目类型，再采集允许初始化采集的本机字段；敏感字段继续由用户
|
||||
手工维护。使用正常 dry-run/apply，但在确认清单中只允许 Git managed blocks 与必要生成文件
|
||||
发生预期变化；若出现 cleanup、类型切换或活动文件变化，询问用户是否改跑完整初始化，
|
||||
不得把它伪装成“只补 gitignore”。
|
||||
|
||||
不得保留这 8 项之外的条目或任何磁盘上不存在的 Skill。
|
||||
每条的路径、类型、能力、触发场景、输出必须与对应 `SKILL.md` 一致。
|
||||
## Bundle 就绪门槛
|
||||
|
||||
## 阶段 5：生成或补齐 `.gitignore`
|
||||
类型只有同时满足以下条件才能在 catalog 标记为 `ready`：
|
||||
|
||||
使用 [reference.md](reference.md) 的片段，不得临时拼写：
|
||||
- manifest、payload、Git 片段与 Hook scan 策略完整；
|
||||
- manifest 引用的 Skill 在 `skills.json` 中登记且 payload 含完整 `SKILL.md` 目录；
|
||||
- 初始化引擎与 Hook 双平台测试通过；
|
||||
- `--check` 能验证该类型的活动闭包。
|
||||
|
||||
1. 固定加入 Cursor 运行态片段。
|
||||
2. 固定加入 Godot 片段：忽略 `.godot/`，但提交 `*.uid` 和资源 `*.import` sidecar。
|
||||
3. 按用户 shell/OS 与自定义项补充其他片段。
|
||||
4. 已有 `.gitignore` 时按阶段 1 的新建/追加/替换/跳过选择处理。
|
||||
5. 写入前展示最终预览；用户调整后重新预览。
|
||||
6. 清除与 `*.uid`、`*.import` 提交要求冲突的旧忽略规则；不要忽略
|
||||
`.cursor/.init-done`。
|
||||
|
||||
用户跳过时记录 `gitignore_generated: false`；这不等于流程失败，但报告中必须明确。
|
||||
|
||||
## 阶段 6：验证
|
||||
|
||||
逐项验证，任何失败都回到修复或停止状态：
|
||||
|
||||
1. reference 中全部 canonical 文件存在。
|
||||
2. 九个 common rules 和六个 Godot baseline project rules 全部存在。
|
||||
3. `.cursor/skills/` 的一级目录集合与 8 项白名单**完全相等**。
|
||||
4. 所有历史 fragments、backup、cache、旧 ack、session marker 和临时文件均不存在。
|
||||
5. `entries/.gitkeep` 存在，entries 下无其他文件。
|
||||
6. 四个 changelog 视图与空 entries 经生成器重建的结果一致。
|
||||
7. 状态文件等于 reference 模板。
|
||||
8. `local-env.json` 可解析、字段与用户输入一致且被 Git 忽略。
|
||||
9. registry 恰有 8 项，路径均存在，无三个排除项或旧项目名。
|
||||
10. 所有 Skill frontmatter `name` 与目录一致，description 同时说明 what + when。
|
||||
11. Skill 内相对引用均存在；不存在环境检查 Rule 的悬空引用。
|
||||
12. `.gitignore` 忽略 `.godot/`、`local-env.json`、ack、session marker，同时不忽略 `*.uid` 和
|
||||
资源 `*.import`。
|
||||
13. 本次写入的文本为 UTF-8 无 BOM、LF。
|
||||
|
||||
报告移动、删除、重置、生成、跳过和未解决项。未解决项不为空时不得进入阶段 7。
|
||||
|
||||
## 阶段 7：写 sentinel
|
||||
|
||||
仅在阶段 6 全部通过后，按 reference 模板写 `.cursor/.init-done`。写入后再次读取并验证
|
||||
字段。`project_type` 固定为 `godot`，`gitignore_generated` 反映阶段 5 实际结果。
|
||||
|
||||
最后提醒用户检查 `git status` 和 diff，并提交 `.cursor/.init-done`；不要代替用户提交。
|
||||
|
||||
## 验收结果
|
||||
|
||||
完整初始化后：
|
||||
|
||||
- baseline 结构完整，六个 Godot project rules 仍在；
|
||||
- `.cursor/skills/` 只有指定 8 个目录；
|
||||
- 历史数据、backup、cache、ack 与临时文件已清；
|
||||
- 状态模板与四视图已重置；
|
||||
- `local-env.json` 已由 example 生成且 gitignored；
|
||||
- `.gitignore` 正确区分 Godot 缓存和需提交的 sidecar；
|
||||
- `.init-done` 只在所有验证通过后存在。
|
||||
只有计划或空目录的类型必须保持 `draft`；Roblox 在完成上述门槛前不得出现在用户问卷中。
|
||||
|
||||
@@ -1,552 +1,198 @@
|
||||
# Cursor Init Reference
|
||||
|
||||
本文件是 `cursor-init` 的精确数据契约。`SKILL.md` 负责流程，本文件负责 canonical、
|
||||
cleanup、状态模板、sentinel 与 `.gitignore` 片段。路径均相对项目根。
|
||||
本文件说明多类型初始化的数据契约和验收规则。机器真相源是 `.cursor/bootstrap/*.json`；
|
||||
流程入口是 [SKILL.md](SKILL.md)。不得在本文件重新维护固定 Rule/Skill 数量。
|
||||
|
||||
## 1. Canonical 白名单
|
||||
|
||||
canonical 是初始化期间必须保留的 tracked 基线。缺失项应报错并从可信模板恢复，
|
||||
不得用空文件伪造。除这里列出的 8 个 Skill 目录外，`.cursor/skills/` 不允许有其他
|
||||
一级目录。
|
||||
|
||||
### 1.1 顶层配置与生成标记
|
||||
## 1. 目录边界
|
||||
|
||||
```text
|
||||
.cursor/hooks.json
|
||||
.cursor/local-env.example.json
|
||||
.cursor/.init-done
|
||||
.cursor/
|
||||
├─ bootstrap/ # tracked、惰性、自包含可信源
|
||||
│ ├─ catalog.json # 支持类型与状态
|
||||
│ ├─ common.manifest.json # common canonical、重置与公共策略
|
||||
│ ├─ skills.json # 全部 Skill 与 Registry 元数据
|
||||
│ ├─ fragments/ # common Git managed block 片段
|
||||
│ ├─ templates/ # 状态与空 changelog 模板
|
||||
│ ├─ tools/cursor_init.py # dry-run/apply/check 引擎
|
||||
│ ├─ tests/test_cursor_init.py
|
||||
│ └─ types/<type>/
|
||||
│ ├─ manifest.json
|
||||
│ ├─ fragments/
|
||||
│ └─ payload/ # 未选时不会进入 Cursor 活动目录
|
||||
├─ rules/common/ # 始终活动
|
||||
├─ rules/project/ # 只含所选类型；general 时仅 .gitkeep
|
||||
├─ skills/ # common + 所选类型 Skill
|
||||
├─ hooks/changelog-scan.json # 按类型生成的活动扫描策略
|
||||
├─ .init-state.json # managed payload 文件 hash
|
||||
└─ .init-done # 全部验证通过后的提交标记
|
||||
```
|
||||
|
||||
说明：
|
||||
### 保护边界
|
||||
|
||||
- `.cursor/.init-done` 是阶段 7 生成后需要提交的文件；模板源在首次 init 前可以没有。
|
||||
- `.cursor/local-env.json` 是由 example 生成的 gitignored 运行态，不是 canonical。
|
||||
- `.cursor/changelog/.changelog-ack` 是 gitignored hook 运行态，不是 canonical。
|
||||
- `.cursor/changelog/.session-start` 是 sessionStart hook 刷新的 gitignored 运行态，不是 canonical。
|
||||
- `.cursor/bootstrap/**` 永不被 cleanup、类型切换或 reset 修改。
|
||||
- common 只在活动层保存一份；缺失时阻塞，不从不明来源生成空文件。
|
||||
- payload 中的 `.mdc` / `SKILL.md` 不位于 Cursor 活动路径，未选类型不得物化。
|
||||
- `source/` 和业务目录不属于初始化管理范围。
|
||||
|
||||
### 1.2 Common Rules（恰好 9 个基线项）
|
||||
## 2. Catalog
|
||||
|
||||
`.cursor/bootstrap/catalog.json` 字段：
|
||||
|
||||
- `schema_version`：当前为 `1`；
|
||||
- `skill_version`：sentinel 使用的初始化契约版本；
|
||||
- `common_manifest`、`skills_catalog`：相对 bootstrap 的安全路径；
|
||||
- `types[]`：`id`、用户标签 `label`、`status` 与 manifest 路径。
|
||||
|
||||
合法状态只有：
|
||||
|
||||
- `ready`：payload 和片段完整且可通过校验；会出现在 `--list-types`；
|
||||
- `draft`：允许保留设计占位，但不会暴露给用户，也不能 dry-run/apply。
|
||||
|
||||
Agent 只能展示脚本返回的 ready 类型，不从文档、MCP 或目录名猜测支持范围。
|
||||
|
||||
## 3. Common Manifest
|
||||
|
||||
`.cursor/bootstrap/common.manifest.json` 是跨类型契约：
|
||||
|
||||
- `canonical_files`：必须存在的活动 common 文件；
|
||||
- `skills`：始终活动的 Skill ID；
|
||||
- `local_env_fields`：所有类型都声明的本机字段；是否由初始化采集由字段元数据决定；
|
||||
- `scan`：Hook 公共扫描策略；
|
||||
- `gitignore_fragments` / `gitattributes_fragments`：公共 Git 片段；
|
||||
- `reset_files`：初始化时恢复为空模板的状态文件；
|
||||
- `cleanup_globs`：确认后删除的历史 fragment、缓存、备份和运行标记。
|
||||
|
||||
所有路径必须是项目根或 manifest 根内的相对路径；`..` 与绝对路径非法。
|
||||
|
||||
## 4. Type Manifest
|
||||
|
||||
每个 `.cursor/bootstrap/types/<type>/manifest.json` 声明：
|
||||
|
||||
- `id`、`version`；
|
||||
- `readiness`：是否允许空 payload，以及 ready 时是否强制要求 scan / gitignore；
|
||||
- `files[]`：单文件 source → 活动 target；
|
||||
- `trees[]`：完整目录 source → 活动 target，适合项目专属 Skill；
|
||||
- `skills[]`：该类型激活的 Skill ID；
|
||||
- `local_env_fields`：仅选择该类型时生成；是否由初始化采集由字段元数据决定；
|
||||
- `scan`：与 common 合并的 Hook 文件名、扩展名和排除目录；
|
||||
- Git managed block 片段。
|
||||
|
||||
`general` 表示 common-only，不物化 project Rule/Skill。类型切换时，只删除已知 managed
|
||||
且 hash 未被用户修改的旧 bundle 文件；用户改动过的文件必须成为阻塞项。
|
||||
|
||||
## 5. Skill Registry
|
||||
|
||||
`.cursor/bootstrap/skills.json` 保存每个 Skill 的：
|
||||
|
||||
- `id`、`scope`、活动 `target`；
|
||||
- Registry 的类型、能力、触发场景和输出。
|
||||
|
||||
common manifest 和 type manifest 只引用 Skill ID。初始化脚本按活动 ID 生成
|
||||
`.cursor/skills/epee-orchestrator/registry.md`，并验证对应目录存在 `SKILL.md`。
|
||||
创建、删除、重命名或实质修改 Skill 时，先更新 `skills.json` 与所属 manifest，再重新生成 Registry。
|
||||
|
||||
## 6. Dry-run 与所有权
|
||||
|
||||
dry-run 至少包含：
|
||||
|
||||
```text
|
||||
.cursor/rules/common/baserule.mdc
|
||||
.cursor/rules/common/changelog-recall.mdc
|
||||
.cursor/rules/common/cursor-init-recall.mdc
|
||||
.cursor/rules/common/deferred-recall.mdc
|
||||
.cursor/rules/common/distillery-recall.mdc
|
||||
.cursor/rules/common/epee-orchestrator.mdc
|
||||
.cursor/rules/common/pitfall-recall.mdc
|
||||
.cursor/rules/common/profile-recall.mdc
|
||||
.cursor/rules/common/dependency-governance.mdc
|
||||
创建 / 更新 / 删除
|
||||
Foreign
|
||||
阻塞
|
||||
PLAN_DIGEST
|
||||
```
|
||||
|
||||
### 1.3 Godot baseline Project Rules（首次 init 必须保留）
|
||||
阻塞条件包括：
|
||||
|
||||
- common canonical、ready payload 或片段缺失；
|
||||
- 活动目录存在 manifest 未登记的 Rule/Skill；
|
||||
- managed 文件内容既不等于 payload，也不等于 `.init-state.json` 记录的安装 hash；
|
||||
- 本机必填字段缺失；
|
||||
- Git managed block 标记缺失一端、重复或损坏；
|
||||
- 路径越界或 schema 无效。
|
||||
|
||||
Apply 必须重算同一份计划并比对 digest。只有无阻塞计划才可执行。
|
||||
|
||||
## 7. 生成文件
|
||||
|
||||
### `local-env.example.json` / `local-env.json`
|
||||
|
||||
common 与所选类型的 `local_env_fields` 按顺序合并。每个字段可使用：
|
||||
|
||||
- `required`：初始化完成前是否必须提供；
|
||||
- `sensitive`：值是否属于密钥等敏感信息；
|
||||
- `collect_at_init`：初始化问卷和 `--set` 是否允许采集。
|
||||
|
||||
example 可提交且只能包含占位值；local-env 保留未知键和已有用户值，并由 `.gitignore`
|
||||
忽略。只有非 sensitive 且 `collect_at_init` 未设为 `false` 的字段才允许通过
|
||||
`--set KEY=VALUE` 提供。敏感字段不阻塞初始化，也不参与状态漂移，真实值必须由用户
|
||||
手工写入 `.cursor/local-env.json`；不得保存密码、Cookie 或会话令牌。
|
||||
|
||||
### `changelog-scan.json`
|
||||
|
||||
common + type 的 `included_names`、`included_extensions`、`excluded_directories` 去重合并。
|
||||
PowerShell/Bash Hook 只读取此文件；会话标记、Git 内容状态与 mtime 的守卫逻辑留在脚本中。
|
||||
|
||||
### Git managed blocks
|
||||
|
||||
脚本只维护以下标记之间的内容：
|
||||
|
||||
```text
|
||||
.cursor/rules/project/godot-architecture.mdc
|
||||
.cursor/rules/project/godot-assets.mdc
|
||||
.cursor/rules/project/godot-data-systems.mdc
|
||||
.cursor/rules/project/godot-gdscript-style.mdc
|
||||
.cursor/rules/project/godot-scene-conventions.mdc
|
||||
.cursor/rules/project/godot-testing.mdc
|
||||
# >>> cursor-init managed >>>
|
||||
...
|
||||
# <<< cursor-init managed <<<
|
||||
```
|
||||
|
||||
禁止用 `.cursor/rules/project/*.mdc` 之类的通配删除覆盖这些文件。
|
||||
标记外用户内容不得覆盖。选择 `--skip-git-files` 时不改 `.gitignore` / `.gitattributes`，
|
||||
sentinel 写 `gitignore_generated: false`。
|
||||
|
||||
### 1.4 Skills（最终恰好 8 个目录）
|
||||
### `.init-state.json`
|
||||
|
||||
```text
|
||||
.cursor/skills/cursor-init/
|
||||
.cursor/skills/deferred-decisions/
|
||||
.cursor/skills/dev-changelog/
|
||||
.cursor/skills/epee-orchestrator/
|
||||
.cursor/skills/pitfall-journal/
|
||||
.cursor/skills/problem-distillery/
|
||||
.cursor/skills/profile-memory/
|
||||
.cursor/skills/html-doc/
|
||||
```
|
||||
记录当前项目类型、bundle 版本、manifest digest 与已物化 payload 文件 hash，用于区分
|
||||
bundle 升级和用户修改。它需要提交，不能包含本机绝对路径或秘密。
|
||||
|
||||
目录内 canonical 文件：
|
||||
## 8. Sentinel
|
||||
|
||||
```text
|
||||
.cursor/skills/cursor-init/SKILL.md
|
||||
.cursor/skills/cursor-init/reference.md
|
||||
.cursor/skills/deferred-decisions/SKILL.md
|
||||
.cursor/skills/dev-changelog/SKILL.md
|
||||
.cursor/skills/epee-orchestrator/SKILL.md
|
||||
.cursor/skills/epee-orchestrator/registry.md
|
||||
.cursor/skills/pitfall-journal/SKILL.md
|
||||
.cursor/skills/problem-distillery/SKILL.md
|
||||
.cursor/skills/profile-memory/SKILL.md
|
||||
.cursor/skills/html-doc/SKILL.md
|
||||
.cursor/skills/html-doc/assets/theme.css
|
||||
.cursor/skills/html-doc/assets/annotate.js
|
||||
.cursor/skills/html-doc/templates/skeleton.html
|
||||
```
|
||||
|
||||
### 1.5 Hooks 全套
|
||||
|
||||
```text
|
||||
.cursor/hooks.json
|
||||
.cursor/hooks/README.md
|
||||
.cursor/hooks/run-hook.ps1
|
||||
.cursor/hooks/session-init.ps1
|
||||
.cursor/hooks/session-init.sh
|
||||
.cursor/hooks/check-changelog.ps1
|
||||
.cursor/hooks/check-changelog.sh
|
||||
```
|
||||
|
||||
### 1.6 Changelog tools 全套
|
||||
|
||||
```text
|
||||
.cursor/changelog/tools/changelog_build.py
|
||||
.cursor/changelog/tools/migrate_changelog.py
|
||||
.cursor/changelog/tools/install-git-hooks.ps1
|
||||
.cursor/changelog/tools/install-git-hooks.sh
|
||||
.cursor/changelog/tools/merge-import.ps1
|
||||
.cursor/changelog/tools/merge-import.sh
|
||||
.cursor/changelog/tools/git-hooks/pre-commit
|
||||
.cursor/changelog/tools/git-hooks/post-merge
|
||||
```
|
||||
|
||||
`tools/__pycache__/` 和 `*.pyc` 永远不是 canonical。
|
||||
|
||||
### 1.7 Changelog 四视图与 entries 占位
|
||||
|
||||
```text
|
||||
.cursor/changelog/changelog-full.md
|
||||
.cursor/changelog/changelog-recent.md
|
||||
.cursor/changelog/changelog-headlines.md
|
||||
.cursor/changelog/changelog-by-author.md
|
||||
.cursor/changelog/entries/.gitkeep
|
||||
```
|
||||
|
||||
四视图由 `changelog_build.py` 生成，不手改。初始化时先清空 entries（保留
|
||||
`.gitkeep`），再运行生成器得到空视图。
|
||||
|
||||
### 1.8 状态模板文件
|
||||
|
||||
```text
|
||||
.cursor/deferred/registry.md
|
||||
.cursor/pitfalls/pitfalls.md
|
||||
.cursor/distillery/problems.md
|
||||
.cursor/distillery/insights.md
|
||||
.cursor/distillery/golden-rules.md
|
||||
.cursor/profile/project-profile.md
|
||||
.cursor/profile/project-profile-log.md
|
||||
```
|
||||
|
||||
## 2. Cleanup 清单
|
||||
|
||||
### 2.1 强制删除
|
||||
|
||||
下面内容必须进入 dry-run，确认后删除：
|
||||
|
||||
```text
|
||||
# 全部历史 changelog fragment；唯一例外是 entries/.gitkeep
|
||||
.cursor/changelog/entries/**
|
||||
!.cursor/changelog/entries/.gitkeep
|
||||
|
||||
# 历史备份
|
||||
.cursor/changelog/_backup/**
|
||||
.cursor/_init-backup/**
|
||||
.cursor/**/_backup/**
|
||||
.cursor/**/*.bak
|
||||
.cursor/**/*.backup
|
||||
|
||||
# 缓存和编译产物
|
||||
.cursor/**/__pycache__/**
|
||||
.cursor/**/*.pyc
|
||||
.cursor/**/*.pyo
|
||||
.cursor/**/*.cache
|
||||
.cursor/**/.cache/**
|
||||
|
||||
# 设备绑定与 hook 运行态
|
||||
.cursor/local-env.json
|
||||
.cursor/changelog/.changelog-ack
|
||||
.cursor/changelog/.session-start
|
||||
|
||||
# init / 调试临时产物
|
||||
.cursor/_gitignore-preview
|
||||
.cursor/**/*.tmp
|
||||
.cursor/**/*.temp
|
||||
.cursor/**/*.log
|
||||
.cursor/debug-*.log
|
||||
```
|
||||
|
||||
模式中的 `!` 只是“例外”说明，不表示可把这段直接交给任意删除命令。实现时必须先枚举
|
||||
实际文件并逐项比对白名单，防止通配误删。
|
||||
|
||||
此外：
|
||||
|
||||
- 删除 `.cursor/skills/` 下所有非 8 项白名单目录。
|
||||
- 删除或迁出非 baseline project rules，但必须逐项确认；六个 baseline 永不删除。
|
||||
- 删除任何非 8 项白名单 Skill。
|
||||
- 不删除 `source/`，不修改项目根 Git 文件（`.gitignore` 仅在用户明确选择时例外）。
|
||||
|
||||
### 2.2 重置而非删除
|
||||
|
||||
以下文件保留路径并重置为第 3 节模板：
|
||||
|
||||
```text
|
||||
.cursor/deferred/registry.md
|
||||
.cursor/pitfalls/pitfalls.md
|
||||
.cursor/distillery/problems.md
|
||||
.cursor/distillery/insights.md
|
||||
.cursor/distillery/golden-rules.md
|
||||
.cursor/profile/project-profile.md
|
||||
.cursor/profile/project-profile-log.md
|
||||
```
|
||||
|
||||
四个 changelog 视图不使用手写模板覆盖：删除 fragments 后运行生成器重建。
|
||||
|
||||
### 2.3 环境配置入口
|
||||
|
||||
本机环境只由 `cursor-init` 阶段 1 和阶段 4 一次性采集、生成，不依赖额外环境检查 Rule。
|
||||
|
||||
## 3. 状态模板
|
||||
|
||||
写入时替换 `{{DATE}}` 为本地日期 `YYYY-MM-DD`。
|
||||
|
||||
### 3.1 `.cursor/deferred/registry.md`
|
||||
|
||||
```markdown
|
||||
# Deferred Decisions Registry
|
||||
|
||||
## Active Items
|
||||
|
||||
（暂无延期方案）
|
||||
|
||||
---
|
||||
|
||||
## Completed / Cancelled Items
|
||||
|
||||
（暂无已完成或已废弃的方案）
|
||||
```
|
||||
|
||||
### 3.2 `.cursor/pitfalls/pitfalls.md`
|
||||
|
||||
```markdown
|
||||
# Pitfall Journal
|
||||
|
||||
开发过程中踩过的坑，按时间倒序排列。
|
||||
Agent 进入 Debug mode 或遇到运行时错误时自动检索匹配。
|
||||
|
||||
---
|
||||
```
|
||||
|
||||
### 3.3 `.cursor/distillery/problems.md`
|
||||
|
||||
```markdown
|
||||
# Problem Distillery — Problems
|
||||
|
||||
反复出现的顽固问题追踪记录，按时间倒序排列。
|
||||
|
||||
<!-- 新条目追加在此行下方 -->
|
||||
```
|
||||
|
||||
### 3.4 `.cursor/distillery/insights.md`
|
||||
|
||||
```markdown
|
||||
# Problem Distillery — Insights
|
||||
|
||||
从已解决的顽固问题中蒸馏出的精炼方法论。
|
||||
|
||||
<!-- 新条目追加在此行下方 -->
|
||||
|
||||
---
|
||||
last_distill_date: {{DATE}}
|
||||
```
|
||||
|
||||
### 3.5 `.cursor/distillery/golden-rules.md`
|
||||
|
||||
```markdown
|
||||
# Golden Rules
|
||||
|
||||
经过实践验证（权重 >= 5）的精炼认知，每次新会话自动注入。
|
||||
|
||||
<!-- 当条目达到权重阈值后由 Agent 自动写入 -->
|
||||
```
|
||||
|
||||
### 3.6 `.cursor/profile/project-profile.md`
|
||||
|
||||
```markdown
|
||||
# Project Profile
|
||||
|
||||
## 项目定位
|
||||
|
||||
## 技术栈与架构
|
||||
|
||||
## 设计约定
|
||||
|
||||
## 产品方向
|
||||
```
|
||||
|
||||
### 3.7 `.cursor/profile/project-profile-log.md`
|
||||
|
||||
```markdown
|
||||
# Project Profile Log
|
||||
|
||||
详细记录每次项目画像更新的完整上下文，按时间正序追加。
|
||||
|
||||
## 记录
|
||||
```
|
||||
|
||||
## 4. 空 Changelog 四视图
|
||||
|
||||
以 `.cursor/changelog/tools/changelog_build.py` 的输出为准。entries 仅有 `.gitkeep` 时，
|
||||
生成结果应具备以下固定头部且无条目：
|
||||
|
||||
### 4.1 `changelog-headlines.md`
|
||||
|
||||
```markdown
|
||||
# Dev Changelog — Headlines
|
||||
|
||||
最近 ~50 次改动的一句话概要，按时间倒序排列。每次会话自动注入上下文。
|
||||
> 本文件由 `tools/changelog_build.py` 从 `entries/` 自动生成，请勿手改。
|
||||
```
|
||||
|
||||
### 4.2 `changelog-recent.md`
|
||||
|
||||
```markdown
|
||||
# Dev Changelog — Recent
|
||||
|
||||
最近 ~20 次改动的摘要记录，按时间倒序排列。
|
||||
当 Agent 检测到当前任务与近期改动相关时自动读取。
|
||||
> 本文件由 `tools/changelog_build.py` 从 `entries/` 自动生成，请勿手改。
|
||||
```
|
||||
|
||||
### 4.3 `changelog-full.md`
|
||||
|
||||
```markdown
|
||||
# Dev Changelog — Full
|
||||
|
||||
完整的开发改动记录，按时间倒序排列。作为主动 RAG 的数据源，用户手动唤醒时读取。
|
||||
> 本文件由 `tools/changelog_build.py` 从 `entries/` 自动生成，请勿手改；新增/修改请编辑 `entries/<author>/<id>.md` 后重跑生成器。
|
||||
|
||||
## 记录
|
||||
```
|
||||
|
||||
### 4.4 `changelog-by-author.md`
|
||||
|
||||
```markdown
|
||||
# Dev Changelog — By Author
|
||||
|
||||
按作者聚合的贡献概览，便于多人协作时区分提交来源。
|
||||
> 本文件由 `tools/changelog_build.py` 自动生成，请勿手改。
|
||||
```
|
||||
|
||||
生成器统一以单个 LF 结尾，不保留多余空白行；验证应比较生成器实际输出，不自行 trim 后回写。
|
||||
|
||||
## 5. `local-env.json` 生成契约
|
||||
|
||||
必须读取 `.cursor/local-env.example.json`，复制完整 JSON 结构，再覆盖三个键：
|
||||
|
||||
```json
|
||||
{
|
||||
"shell": "{{SHELL}}",
|
||||
"changelog-author": "{{CHANGELOG_AUTHOR}}",
|
||||
"godot4_path": "{{GODOT4_EXECUTABLE_OR_EMPTY}}"
|
||||
}
|
||||
```
|
||||
|
||||
规则：
|
||||
|
||||
- example 中其他键原样保留，不以这段最小示例覆盖整个文件。
|
||||
- `godot4_path` 可为空字符串。
|
||||
- 不写用户未确认的自动猜测值。
|
||||
- 文件必须能被 JSON parser 读取，并由 `.gitignore` 忽略。
|
||||
- 不提交 `local-env.json`。
|
||||
|
||||
## 6. `.init-done` 模板
|
||||
|
||||
仅在全部验证通过后写入：
|
||||
`.cursor/.init-done` 仅在 apply 后活动闭包再次验证通过时写入：
|
||||
|
||||
```yaml
|
||||
# .cursor/.init-done — cursor-init 写入的初始化标记
|
||||
# 必须提交此文件，避免 clone 后重复触发初始化
|
||||
initialized_at: {{ISO_DATETIME}}
|
||||
initialized_by: cursor-init
|
||||
skill_version: 3
|
||||
project_type: godot
|
||||
gitignore_generated: {{BOOL}}
|
||||
initialized_at: <ISO_DATETIME>
|
||||
schema_version: 1
|
||||
skill_version: <catalog.skill_version>
|
||||
project_type: <single-ready-type>
|
||||
bundle_version: <type-manifest.version>
|
||||
manifest_digest: <sha256>
|
||||
gitignore_generated: true|false
|
||||
```
|
||||
|
||||
`{{BOOL}}` 只能是 `true` 或 `false`。流程失败、取消或存在未解决项时不得写入。
|
||||
sentinel 和 `.init-state.json` 字段必须与当前 manifest 一致。取消、摘要变化、部分写入或验证失败
|
||||
都不得创建/更新 sentinel。
|
||||
|
||||
## 7. `.gitignore` 片段
|
||||
## 9. Hook 契约
|
||||
|
||||
拼装顺序：
|
||||
`check-changelog.ps1` 与 `.sh` 必须保持相同行为：
|
||||
|
||||
1. Cursor runtime
|
||||
2. Godot
|
||||
3. OS / IDE / Language（如用户需要）
|
||||
4. Custom
|
||||
1. 非 Agent mode、缺 changelog、缺 scan config、缺 `.session-start` 时返回 `{}`；
|
||||
2. Git 不可用、状态失败或工作区无内容差异时返回 `{}`；
|
||||
3. 只扫描活动配置命中的文件，并要求 mtime 晚于 session/changelog；
|
||||
4. 候选路径还必须被 `git status --porcelain` 判定为未提交改动；
|
||||
5. 任意解析或运行错误 fail-open，不阻断用户。
|
||||
|
||||
追加到已有文件时，用以下分隔：
|
||||
回归测试入口：
|
||||
|
||||
```gitignore
|
||||
# --- 以下由 cursor-init 追加 ---
|
||||
```bash
|
||||
python .cursor/hooks/tests/test_check_changelog.py
|
||||
```
|
||||
|
||||
### 7.1 Cursor runtime（固定）
|
||||
## 10. 验收
|
||||
|
||||
```gitignore
|
||||
# === Cursor runtime ===
|
||||
.cursor/local-env.json
|
||||
.cursor/changelog/.changelog-ack
|
||||
.cursor/changelog/.session-start
|
||||
.cursor/_init-backup/
|
||||
.cursor/_gitignore-preview
|
||||
初始化或重置完成后：
|
||||
|
||||
# .cursor/.init-done 是需提交的完成标记，不得忽略
|
||||
```
|
||||
|
||||
### 7.2 Godot（固定）
|
||||
|
||||
```gitignore
|
||||
# === Godot ===
|
||||
# 编辑器导入缓存可重建，不提交
|
||||
.godot/
|
||||
|
||||
# Godot 4 UID sidecar 与资源导入配置是项目元数据，必须提交
|
||||
!*.uid
|
||||
!**/*.uid
|
||||
!*.import
|
||||
!**/*.import
|
||||
```
|
||||
|
||||
写入前检查并移除或修正已有的冲突规则，例如 `*.uid`、`*.import`、`**/*.uid`、
|
||||
`**/*.import`。不要把 `.godot/` 内的生成缓存误认为资源旁的 `*.import` sidecar。
|
||||
|
||||
### 7.3 Windows
|
||||
|
||||
```gitignore
|
||||
# === OS: Windows ===
|
||||
Thumbs.db
|
||||
Thumbs.db:encryptable
|
||||
ehthumbs.db
|
||||
ehthumbs_vista.db
|
||||
Desktop.ini
|
||||
$RECYCLE.BIN/
|
||||
*.stackdump
|
||||
*.lnk
|
||||
```
|
||||
|
||||
### 7.4 macOS
|
||||
|
||||
```gitignore
|
||||
# === OS: macOS ===
|
||||
.DS_Store
|
||||
.AppleDouble
|
||||
.LSOverride
|
||||
Icon
|
||||
._*
|
||||
.DocumentRevisions-V100
|
||||
.fseventsd
|
||||
.Spotlight-V100
|
||||
.TemporaryItems
|
||||
.Trashes
|
||||
.VolumeIcon.icns
|
||||
.com.apple.timemachine.donotpresent
|
||||
```
|
||||
|
||||
### 7.5 Linux
|
||||
|
||||
```gitignore
|
||||
# === OS: Linux ===
|
||||
*~
|
||||
.fuse_hidden*
|
||||
.directory
|
||||
.Trash-*
|
||||
.nfs*
|
||||
```
|
||||
|
||||
### 7.6 VS Code
|
||||
|
||||
```gitignore
|
||||
# === IDE: VS Code ===
|
||||
.vscode/*
|
||||
!.vscode/settings.json
|
||||
!.vscode/tasks.json
|
||||
!.vscode/launch.json
|
||||
!.vscode/extensions.json
|
||||
!.vscode/*.code-snippets
|
||||
.history/
|
||||
*.vsix
|
||||
```
|
||||
|
||||
### 7.7 JetBrains
|
||||
|
||||
```gitignore
|
||||
# === IDE: JetBrains ===
|
||||
.idea/
|
||||
*.iml
|
||||
*.ipr
|
||||
*.iws
|
||||
.idea_modules/
|
||||
```
|
||||
|
||||
### 7.8 Visual Studio
|
||||
|
||||
```gitignore
|
||||
# === IDE: Visual Studio ===
|
||||
.vs/
|
||||
*.user
|
||||
*.suo
|
||||
*.userprefs
|
||||
bin/
|
||||
obj/
|
||||
[Dd]ebug/
|
||||
[Rr]elease/
|
||||
x64/
|
||||
x86/
|
||||
```
|
||||
|
||||
### 7.9 Vim / Emacs
|
||||
|
||||
```gitignore
|
||||
# === IDE: Vim / Emacs ===
|
||||
*.swp
|
||||
*.swo
|
||||
*.swn
|
||||
Session.vim
|
||||
.netrwhist
|
||||
*~
|
||||
\#*\#
|
||||
.\#*
|
||||
```
|
||||
|
||||
### 7.10 Custom
|
||||
|
||||
```gitignore
|
||||
# === Custom ===
|
||||
# 在此追加项目专属忽略项
|
||||
```
|
||||
|
||||
## 8. Dry-run 输出格式
|
||||
|
||||
```markdown
|
||||
## cursor-init dry-run
|
||||
|
||||
### 保留
|
||||
- path — canonical
|
||||
|
||||
### 缺失（阻塞）
|
||||
- path — 需要从可信模板恢复
|
||||
|
||||
### 删除
|
||||
- path — cleanup 原因
|
||||
|
||||
### 重置
|
||||
- path — 使用的模板
|
||||
|
||||
### 迁移 / 冲突
|
||||
- from → to — 原因与是否需要用户选择
|
||||
|
||||
### 生成
|
||||
- .cursor/local-env.json — 输入字段摘要（不要泄露不必要的本机信息）
|
||||
- .cursor/skills/epee-orchestrator/registry.md — 8 项
|
||||
- .gitignore — 新建 / 追加 / 替换 / 跳过
|
||||
- .cursor/.init-done — 仅验证成功后
|
||||
```
|
||||
|
||||
确认必须覆盖整份 dry-run。dry-run 后扫描结果变化时应重新生成清单并再次确认。
|
||||
- `python .cursor/bootstrap/tools/cursor_init.py --check` 通过；
|
||||
- 活动 project Rules/Skills 与单选类型闭包完全一致，未选 payload 仍惰性保留；
|
||||
- Registry、scan config、local-env example、Git managed blocks 与 manifest 一致；
|
||||
- cleanup 后 changelog entries 仅有 `.gitkeep`，状态文件等于模板；
|
||||
- `python .cursor/changelog/tools/changelog_build.py --check` 通过；
|
||||
- Hook 双实现测试、初始化引擎测试、`git diff --check` 通过；
|
||||
- 本轮写入文本为 UTF-8 无 BOM、LF。
|
||||
|
||||
Reference in New Issue
Block a user