Super Cursor

Super Cursor

仓库 https://github.com/wangqiqi/cursor-ai 欢迎大家 star 和 follow !

一句话

把「怎么和 Agent 协作」从聊天里的口头约定，变成 rules + skills + hooks + config —— 装一次，每个仓库都能用；项目特化知识进 .cursorGrowth/（git 忽略），不污染通用模板。

适合谁

开箱即用

.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 / 复制）：

.cursor/  install-super-cursor.sh  README.md  CHANGELOG.md  .gitignore  .cursorignore
plan.md   # 本地 plan/run 工作副本（gitignore，安装时从 templates 复制）

一条命令安装到其它项目：

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   # 可选：环境自检

支持 Linux · macOS · Windows（Git Bash） — 无 rsync 自动 cp -a，无 jq 回退 python3。详见 跨平台说明。

工作流一览

核心机制：

• 任务地图 — 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」的差别

30 秒上手

对 Agent 说：

/master

它会 AskQuestion 了解你的意图，并推荐下一步。常见路径：

新仓库     →  /scaffold  →  /plan  →  /run
已有代码   →  /learn  →  /plan  →  /run
小修小补   →  描述复现步骤（自动匹配 bugfix rules）

发版：release skill（清单）· ship agent（自治）。审查：security · api · delivery · git · finish。

8 栈脚手架

每个栈自带 scripts/test.sh（开发循环）+ scripts/verify.sh（全量验收），与 plan/run 验收列对齐。

./.cursor/bin/scaffold.sh list
./.cursor/bin/scaffold.sh apply go-api --dry-run   # 先预览
./.cursor/bin/scaffold.sh apply go-api

完整 walkthrough → 端到端示例

设计原则

1. Universal only — 母版不含公司路径，任何仓库都能装
2. Config over fork — 行为开关在 config/*.json，不必 fork 母版
3. Growth boundary — 项目认知只进 .cursorGrowth/，模板保持干净
4. Immutable after install — Agent 默认不改 .cursor/，除非你明确要求

文档

验证

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/）