命名与官方约定

Super Cursor 命名：短、见名知意、不与 Cursor 内置冲突。

速查

类型	本模板	避开
Skill	`master` `plan` `run` `learn` `scaffold` `git` `release` `security` `api`	`shell` `loop` `canvas` `sdk`…（见下）
Agent	`ship`（发版 subagent）	`release`（Cursor 内置 subagent）
Command	【日常】 `/run` `/plan` `/master` · 【生命周期】 `/scaffold` `/learn` `/long` `/release` · 【高级】 `/delivery` `/manual` `/report`（其余 skill 无 slash）；详表 → `skills/master/routes.md`
Config	`workflow.json` `release.json`	—
Hooks 脚本	`growth-init` `run-start` `run-stop`	事件名用官方：`sessionStart` `stop` 等

Skills

路径：.cursor/skills/<name>/SKILL.md
name 字段：小写、短词；与文件夹名一致
禁止写入 ~/.cursor/skills-cursor/（Cursor 内置目录）

内置 skill 名（勿占用）

automate autopilot canvas create-hook create-rule create-skill create-subagent cursor-blame loop migrate-to-skills review review-bugbot review-security sdk shell split-to-prs statusline update-cli-config update-cursor-settings

内置名随 Cursor 版本增删（曾存在 babysit / onboard，现由 autopilot 承担 PR 跟进）。引用内置 slash 前以官方 Skills 文档为准。

Agents

路径：.cursor/agents/<name>.md
name：小写字母与连字符（官方要求）

为何 agent 叫 `ship` 而非 `release`

Cursor Task 体系有内置 subagent release。项目 .cursor/agents/release.md 会覆盖同名内置 agent。

本模板将发版 subagent 定为 ship，打版 checklist 仍用 skill release，职责分离、无冲突。

易混语义（非冲突）

名称	本模板	Cursor 其他含义
`plan`	规划 skill + `/plan`	IDE Plan 模式（只读规划 UI；`CreatePlan` 等为模式内工具）
`run`	执行 skill + `/run`	Agent 一次 run（口语）
`release`	Sprint 出口 skill（§分支 + §打版）	内置 release subagent（我们用 `ship` 代替）
`review`	项目 review skill + review agent（REV-* · PR 清单）	全局 `~/.cursor/skills-cursor/review`（路由 Bugbot / Security Review）
`ux` · `ia` · `debug` · `pencil-design`	skill-only（无 project command）	关键词 / `@skill` / Agent 自动选用
`week` · `disk` · `maintain` · `ops-deploy` · `code-stats-viz`	skill-only + `disable-model-invocation: true`	仅显式 `/skill` 调用（Agent 不按关键词自动选用）

官方工具与模型差异（Agent 须知）

工具 / 能力	约定
AskQuestion	优先用；部分模型未注入（官方对 Cursor Grok 曾确认）→ 正文编号选项（master「AskQuestion 约定」）
SwitchMode	平台级：通常仅 Agent → Plan；勿假定可切 Debug/Ask
CreatePlan	Plan 模式会话工具；Agent 模式 SOP 不依赖
GetMcpTools → CallMcpTool	MCP 调用前先取 schema（见 mcp skill）
Task	子代理；可用性随模式/模型变化，失败则母会话自办

本模板 不绑死 Cursor 内部 tool 旧名（如已废弃的 edit_file / run_terminal_cmd）；以会话实际工具表为准。

四层关系（skills · agents · rules · hooks）

text

你记的 slash（Cursor 2.4+）     skills/<name>/SKILL.md（SOP · 唯一 SSOT）
【日常】/run /plan /master ────────────────→ run · plan · master（多数 dmi=true）
【生命周期】/scaffold /learn /long /release → scaffold · learn · long · release
【高级】/delivery /manual /report ─────────→ delivery · user-manual · test-report
ux · ia · debug · review · week · disk … ──→ Agent 按意图自动读 skill（无 slash / 或 dmi 显式调用）

agents/     仅委派：ship（自治打版）· review/spike（只读）
rules/      编辑匹配文件时 glob 自动加载
hooks/      会话：growth-init · plan 上下文注入

约定：slash 直接加载 skill（无 .cursor/commands/ 薄指针）。disable-model-invocation: true 的 skill 仅显式 /skill-name；其余可由 Agent 按 description 自动选用。主路由 / more / 关键词索引的 canonical 长表 → skills/master/routes.md（.cursor/README.md 与 docs/training/skills.md 只保留摘要 + 链接，不双写三层 Command 表）。

review（项目内）：同名 skill（母会话清单）+ agent（只读子进程）— 委派时用 agent。
全局 review（skills-cursor/review）只路由 Bugbot / Security — 与项目 REV-* 无关；安全专项优先 security skill。

Rules

格式：.mdc + YAML frontmatter
文件名：短词，如 core.mdc workflow.mdc commit.mdc

Hooks

配置：.cursor/hooks.json，version: 1
脚本：.cursor/hooks/*.sh，名称自定；事件 key 必须用官方名
Cloud / Tab 事件与母版默认 → platforms.md §Cursor Hooks

项目认知

不得把 CHANGELOG 摘要等写入 .cursor/
统一 → .cursorGrowth/learn/（git 忽略），入口 /learn

验证

bash

bash .cursor/verify-super-cursor.sh   # mother | hybrid（见下）
bash .cursor/bin/cursor-coherence.sh

模式	何时	纯母版 layout 项
mother	纯母版空仓	必须满足（`install-super-cursor.sh` 等）
hybrid	根有 `scripts/` / `backend/` / `frontend/`（自动）	SKIP；改验 `scripts/verify.sh`

检查含：无 agents/release.md、存在 agents/ship.md、无旧版 jw 前缀 skill 名、CHANGELOG 版本序（若有根 CHANGELOG.md）。

命名与官方约定 ​

速查 ​

Skills ​

内置 skill 名（勿占用） ​

Agents ​

为何 agent 叫 ship 而非 release ​

易混语义（非冲突） ​

官方工具与模型差异（Agent 须知） ​

四层关系（skills · agents · rules · hooks） ​

Rules ​

Hooks ​

项目认知 ​

验证 ​