Super Cursor

查看 GitHub 仓库 →

让 Cursor Agent 像资深同事一样协作：先规划、再执行、可验收、能收尾、能发版。不是零散 .cursorrules 片段，而是 rules + skills + hooks + config 的可安装母版；项目特化知识进 .cursorGrowth/（git 忽略），不污染通用模板。

与 Cursor AI Rules 的差异：Super Cursor 强调 plan/run 闸门、runner.sh 验收链与 7 栈脚手架；cursor-ai-rules 是更早期的全功能规则包（/master · VIBE · 46 skills）。本博客仓库即 Super Cursor 母版实例。

Linux · macOS · Git Bash27 skills7 栈 scaffold

特性

机制	说明
/plan · /run	Goal → TASK → task-verify → commit
gate-check	无 PLAN_APPROVED 不写业务代码
自治 Sprint	默认 AUTONOMOUS:true，一次 /run 连跑
/master	迷路时 AskQuestion 路由
7 栈脚手架	React/Vue/Next/Go/Rust/FastAPI/C++
Growth 边界	.cursorGrowth/plan.md · learn/ 项目私有

环境要求

• Cursor
• Bash（Linux / macOS / Windows Git Bash）
• 可选：jq（部分脚本）、python3

安装

安装到其他项目

git clone https://github.com/wangqiqi/cursor-ai.git
cd cursor-ai
bash .cursor/bin/bootstrap-growth.sh          # 母版首次 clone

./install-super-cursor.sh /path/to/your-project
cd /path/to/your-project
bash .cursor/bin/platform-check.sh            # 可选环境自检

选项	作用
--profile full|lite|rules-only	工作流档位（默认 full）
--replace	升级时先删目标 .cursor/ 再拷贝
--copy-plan	复制 templates/plan.md → .cursorGrowth/plan.md

全局同步（深层目录 → Git 根）

export SUPER_CURSOR_HOME="$HOME/workspace/cursor-ai"
export PATH="$SUPER_CURSOR_HOME/bin:$PATH"
super-cursor-sync --replace

Roo Code 兼容

cp -r /path/to/project/.cursor /path/to/project/.roo

快速开始

记三个指令即可：

/run      # 按 ACTIVE 实现 · 验收 · commit
/plan     # 拆 Sprint（无 ACTIVE 时）
/master   # 真迷路才用

典型路径：

新仓库  →  /scaffold  →  /learn  →  /plan  →  /run
已有代码 →  /learn  →  /plan  →  /run
发版    →  /delivery（可选）→  /release

脚手架

./.cursor/bin/scaffold.sh list
./.cursor/bin/scaffold.sh apply go-api --dry-run
./.cursor/bin/scaffold.sh apply go-api

配置说明

文件	用途
config/workflow.json	plan 路径、自治开关、task_id 前缀
config/release.json	打版模式、tag 格式
config/roles.json	12 人格语气（不影响技术深度）
.cursorGrowth/plan.md	本地 Sprint 面板（gitignore）

安装后 .cursor/ 默认只读（除非用户明确授权修改母版）。

验证

bash .cursor/verify-super-cursor.sh
bash .cursor/bin/cursor-coherence.sh
bash .cursor/bin/template-verify.sh

与 cursor-ai-rules 对照

	Super Cursor	Cursor AI Rules
入口	/plan /run /release	/master /vibe
验收	runner.sh task-verify	verify-system.sh
团队沉淀	/learn · archive	team-experience 技能
适用	要 Sprint 闸门 + 发版链 的团队	要 全量 rules/skills 即插即用

常见问题

Q: 装完 Agent 还是乱改怎么办？
先 /plan 写 Goal 与 TASK，等 PLAN_APPROVED 后再 /run；检查 gate-check 是否通过。

Q: 母版仓库 vs 目标项目？
母版（cursor-ai 仓库）可改 .cursor/；安装到业务项目后默认只读，特化写 .cursorGrowth/。

Q: 和本博客的关系？
vitepress-blog-source 使用 Super Cursor 作为 .cursor/ SOP 包，内容站点与母版同源演进。

源码

• 仓库：wangqiqi/cursor-ai
• 5 分钟上手：quickstart.md
• 致谢上游：cursor-ai-rules · anthropics/skills · github/spec-kit