43 lines
1.9 KiB
Plaintext
43 lines
1.9 KiB
Plaintext
---
|
||
description: 首次会话检查 Cursor 初始化状态，并响应显式初始化或重置请求
|
||
alwaysApply: true
|
||
---
|
||
|
||
# Cursor 初始化触发
|
||
|
||
## 首次会话自检
|
||
|
||
处理每次会话的第一个用户任务前，先检查项目根 `.cursor-init-source`：
|
||
|
||
- 存在：当前仓库用于开发初始化框架，不自动运行 cursor-init；用户讨论或修改初始化流程也不视为手动初始化。
|
||
- 不存在：再检查 `.cursor/.init-done`。
|
||
|
||
目标项目中的 sentinel 规则：
|
||
|
||
- 文件存在：正常处理任务；没有显式触发词时不重复提醒。
|
||
- 文件不存在：说明仓库尚未完成 Cursor 初始化，概述原任务，并在执行清理、移动、覆盖等操作前取得用户确认。
|
||
- 用户要求跳过初始化时，继续原任务并简短提示下次会话仍会检查；不得强制初始化。
|
||
|
||
用户确认后读取 `.cursor/skills/cursor-init/SKILL.md`，严格按其当前阶段执行。Skill 不存在时停止初始化并报告缺失，不自行实施破坏性替代流程。
|
||
|
||
项目类型选项必须来自：
|
||
|
||
```bash
|
||
python .cursor/bootstrap/tools/cursor_init.py --list-types --json
|
||
```
|
||
|
||
只展示脚本返回的 ready 类型，不把文档中的示例、draft bundle 或 MCP 工具当作支持类型。
|
||
|
||
## 手动触发
|
||
|
||
以下意图触发完整初始化或重置：`初始化 cursor`、`cursor init`、`重置 cursor`、`reset cursor`、清理复制来的 `.cursor`。
|
||
|
||
以下意图仅触发 Skill 中的 `.gitignore` 流程：`补 gitignore`、`生成 .gitignore`、`gitignore 模板`。
|
||
|
||
## 执行约束
|
||
|
||
- 开始前检查工作区状态，提醒用户处理未提交改动。
|
||
- 删除、重置、覆盖和批量移动前提供脚本生成的完整 dry-run 与 `PLAN_DIGEST` 并取得确认。
|
||
- 分类不清的文件逐项询问，不猜测归属。
|
||
- 流程保持幂等；重复执行不应破坏已经正确的状态。
|