Super Cursor
仓库 https://github.com/wangqiqi/cursor-ai 欢迎大家 star 和 follow !
一句话
把「怎么和 Agent 协作」从聊天里的口头约定，变成 rules + skills + hooks + config ------ 装一次，每个仓库都能用；项目特化知识进 .cursorGrowth/（git 忽略），不污染通用模板。
适合谁
| 你可能是... | Super Cursor 帮你... |
|---|---|
| 独立开发者 | 空仓库 5 分钟起盘，Agent 不再乱改一通 |
| 技术负责人 | 统一 plan/run 闸门，任务可追溯、验收可脚本化 |
| 新加入的成员 | /master 路由 + /learn 项目常识，少问重复问题 |
| 开源维护者 | security/api/git 审查 skills，发版有 release/ship 清单 |
开箱即用
text
.cursor/
├── rules/ 沟通 · 执行 · 反馈 · 13 种 tech 细则（含 Svelte）· 栈专用见 rules/local/
├── skills/ 18 个：master · plan · run · learn · scaffold · git · finish · release · security · api · debug · test · mcp · refactor · perf · review · study · delivery
├── agents/ ship · review · spike
├── hooks/ 会话初始化 · run 循环控制
├── config/ workflow.json · release.json · roles.json
├── bin/ gate-check · task-verify · scaffold · cursor-coherence
└── templates/ plan.md · 8 栈脚手架根目录（可直接 clone / 复制）：
text
.cursor/ install-super-cursor.sh README.md CHANGELOG.md .gitignore .cursorignore
plan.md # 本地 plan/run 工作副本（gitignore，安装时从 templates 复制）一条命令安装到其它项目：
bash
git clone https://github.com/wangqiqi/cursor-ai.git
./install-super-cursor.sh /path/to/your-project
cd /path/to/your-project
bash .cursor/bin/platform-check.sh # 可选：环境自检| profile | 适合 |
|---|---|
full（默认） |
团队：plan/run + hooks |
lite |
个人：plan/run，无 hooks |
rules-only |
只要 rules/skills |
支持 Linux · macOS · Windows（Git Bash） --- 无 rsync 自动 cp -a，无 jq 回退 python3。详见 跨平台说明。
工作流一览
#mermaid-svg-jyMp1IEw7clKwWKo{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-jyMp1IEw7clKwWKo .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-jyMp1IEw7clKwWKo .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-jyMp1IEw7clKwWKo .error-icon{fill:#552222;}#mermaid-svg-jyMp1IEw7clKwWKo .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-jyMp1IEw7clKwWKo .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-jyMp1IEw7clKwWKo .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-jyMp1IEw7clKwWKo .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-jyMp1IEw7clKwWKo .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-jyMp1IEw7clKwWKo .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-jyMp1IEw7clKwWKo .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-jyMp1IEw7clKwWKo .marker{fill:#333333;stroke:#333333;}#mermaid-svg-jyMp1IEw7clKwWKo .marker.cross{stroke:#333333;}#mermaid-svg-jyMp1IEw7clKwWKo svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-jyMp1IEw7clKwWKo p{margin:0;}#mermaid-svg-jyMp1IEw7clKwWKo .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-jyMp1IEw7clKwWKo .cluster-label text{fill:#333;}#mermaid-svg-jyMp1IEw7clKwWKo .cluster-label span{color:#333;}#mermaid-svg-jyMp1IEw7clKwWKo .cluster-label span p{background-color:transparent;}#mermaid-svg-jyMp1IEw7clKwWKo .label text,#mermaid-svg-jyMp1IEw7clKwWKo span{fill:#333;color:#333;}#mermaid-svg-jyMp1IEw7clKwWKo .node rect,#mermaid-svg-jyMp1IEw7clKwWKo .node circle,#mermaid-svg-jyMp1IEw7clKwWKo .node ellipse,#mermaid-svg-jyMp1IEw7clKwWKo .node polygon,#mermaid-svg-jyMp1IEw7clKwWKo .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-jyMp1IEw7clKwWKo .rough-node .label text,#mermaid-svg-jyMp1IEw7clKwWKo .node .label text,#mermaid-svg-jyMp1IEw7clKwWKo .image-shape .label,#mermaid-svg-jyMp1IEw7clKwWKo .icon-shape .label{text-anchor:middle;}#mermaid-svg-jyMp1IEw7clKwWKo .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-jyMp1IEw7clKwWKo .rough-node .label,#mermaid-svg-jyMp1IEw7clKwWKo .node .label,#mermaid-svg-jyMp1IEw7clKwWKo .image-shape .label,#mermaid-svg-jyMp1IEw7clKwWKo .icon-shape .label{text-align:center;}#mermaid-svg-jyMp1IEw7clKwWKo .node.clickable{cursor:pointer;}#mermaid-svg-jyMp1IEw7clKwWKo .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-jyMp1IEw7clKwWKo .arrowheadPath{fill:#333333;}#mermaid-svg-jyMp1IEw7clKwWKo .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-jyMp1IEw7clKwWKo .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-jyMp1IEw7clKwWKo .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-jyMp1IEw7clKwWKo .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-jyMp1IEw7clKwWKo .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-jyMp1IEw7clKwWKo .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-jyMp1IEw7clKwWKo .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-jyMp1IEw7clKwWKo .cluster text{fill:#333;}#mermaid-svg-jyMp1IEw7clKwWKo .cluster span{color:#333;}#mermaid-svg-jyMp1IEw7clKwWKo div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-jyMp1IEw7clKwWKo .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-jyMp1IEw7clKwWKo rect.text{fill:none;stroke-width:0;}#mermaid-svg-jyMp1IEw7clKwWKo .icon-shape,#mermaid-svg-jyMp1IEw7clKwWKo .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-jyMp1IEw7clKwWKo .icon-shape p,#mermaid-svg-jyMp1IEw7clKwWKo .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-jyMp1IEw7clKwWKo .icon-shape .label rect,#mermaid-svg-jyMp1IEw7clKwWKo .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-jyMp1IEw7clKwWKo .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-jyMp1IEw7clKwWKo .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-jyMp1IEw7clKwWKo :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 通过
未通过
/master
不确定？先路由
/scaffold
空仓库起盘
/learn
项目认知
/plan
先总后分 · Sprint
gate-check
/run
实现 + 验收
task-verify
commit + next-task
/delivery
交付验收（可选）
/finish
merge/PR
verify + release/ship
核心机制：
- 任务地图 --- ROADMAP/Goal（总）→ TASK/ACTIVE（分）→ 验收/archive；详见 plan/run
- 闸门 --- 无
PLAN_APPROVED不写业务代码，避免 Agent「想到哪改到哪」 - 验收 --- 每个
TASK-*有可执行 Acceptance 列，task-verify不过不 commit - 沉淀 --- 项目路径、模块地图、发版节奏 →
/learn写入.cursorGrowth/learn/ - 边界 --- 安装后
.cursor/默认只读；团队差异用config/*.json或.cursor/rules/local/（社区 rules → rules-catalog）
和「只用 Cursor 默认 Agent」的差别
| 场景 | 默认 Agent | Super Cursor |
|---|---|---|
| 空仓库 | 「帮我建个 React 项目」→ 结构各异 | /scaffold → 8 栈标准层（lint/test/verify/CI） |
| 大需求 | 一次改很多文件，难 review | /plan 先总后分 → /run 逐条验收 |
| 新会话 | 重新解释项目结构 | /learn 读过 .cursorGrowth/learn/ |
| 分支收尾 | merge/PR 靠口头约定 | finish skill（4 选 1）· PR 维护用 babysit |
| 合并前 | 靠人想起来查安全/API | security · api · delivery · git skills |
| 发版 | 口头 checklist | release skill 或 ship agent |
30 秒上手
对 Agent 说：
text
/master它会 AskQuestion 了解你的意图，并推荐下一步。常见路径：
text
新仓库 → /scaffold → /plan → /run
已有代码 → /learn → /plan → /run
小修小补 → 描述复现步骤（自动匹配 bugfix rules）| Command | 作用 |
|---|---|
/master |
不确定时 --- 路由到下方入口 |
/plan |
先总后分：Goal · Done when → 拆 TASK · 写 plan.md（≠ IDE Plan 模式） |
/run |
按 ACTIVE 实现 · task-verify · commit |
/finish |
Sprint/Task 完成后 merge / PR / 保留 / 丢弃 |
/delivery |
交付验收：视觉 · i18n · 文档对齐 · 生产就绪（finish 前建议） |
/learn |
项目认知 → .cursorGrowth/learn/ |
/scaffold |
8 栈脚手架 / 已有项目 audit |
发版：release skill（清单）· ship agent（自治）。审查：security · api · delivery · git · finish。
8 栈脚手架
每个栈自带 scripts/test.sh（开发循环）+ scripts/verify.sh（全量验收），与 plan/run 验收列对齐。
| 类别 | scaffold id | 技术栈 |
|---|---|---|
| 前端 | react-vite-ts |
React + Vite + TS + Vitest |
| 前端 | vue-vite-ts |
Vue 3 + Vite + TS |
| 前端 | nextjs-ts |
Next.js App Router + Vitest |
| 后端 | go-api |
Go HTTP API |
| 后端 | rust-axum |
Rust + Axum |
| 后端 | python-fastapi |
FastAPI + ruff + mypy + pytest |
| 后端 | java-gradle |
Java + Gradle Wrapper |
| 系统 | cpp-cmake |
C++ + CMake + ctest |
bash
./.cursor/bin/scaffold.sh list
./.cursor/bin/scaffold.sh apply go-api --dry-run # 先预览
./.cursor/bin/scaffold.sh apply go-api完整 walkthrough → 端到端示例
设计原则
- Universal only --- 母版不含公司路径，任何仓库都能装
- Config over fork --- 行为开关在
config/*.json，不必 fork 母版 - Growth boundary --- 项目认知只进
.cursorGrowth/，模板保持干净 - Immutable after install --- Agent 默认不改
.cursor/，除非你明确要求
文档
| 文档 | 说明 |
|---|---|
| 5 分钟上手 | 最短闭环 |
| plan/run | 闸门、验收、hooks、先总后分 |
| rules-catalog | 社区 rules 索引 · rules/local/ 引用 |
| 使用场景（20+） | onboarding → 发版全场景 |
| scaffold | 脚手架与 audit |
| 端到端示例 | go-api 可跟练 |
| Building | 扩展母版、贡献指南 |
验证
bash
bash .cursor/verify-super-cursor.sh # 布局检查
bash .cursor/bin/cursor-coherence.sh # 交叉自洽（skills/agents/rules 注册）
bash .cursor/bin/template-verify.sh # 母版完整自测（含 install/scaffold/runner/coherence）参与
如果 Super Cursor 帮你省了重复教 Agent 的时间 ------ 欢迎 Star 支持，或用 Issue/PR 反馈缺口。
- 扩展通用能力 → 改本仓库
- 项目私有 约定 → 目标仓库的
.cursor/rules/local/（见 rules-catalog · 勿 commit 进母版.cursor/）