# cursor-coding-base

**Repository Path**: chen934298133/cursor-coding-base

## Basic Information

- **Project Name**: cursor-coding-base
- **Description**: Cursor 工程基座：OpenSpec + Superpowers + CodeGraph 三轨工作流，可直接复制到新项目起步。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-21
- **Last Updated**: 2026-06-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cursor-coding-base

Cursor 工程基座：**OpenSpec + Superpowers + CodeGraph** 三轨工作流，可直接复制到新项目起步。

详细图文指南见 `local/openspec-superpowers-codegraph-guide.html`（本地文件，未入库；需要时可复制到 `docs/`）。

## 已包含什么

| 路径 | 作用 |
|---|---|
| `.cursor/rules/openspec-superpowers-bridge.mdc` | 工作流路由（alwaysApply）：生命周期、风险分级、5 条判准、CodeGraph 阶段表 |
| `.cursor/rules/codegraph.mdc` | CodeGraph MCP 工具选用规则 |
| `.cursor/rules/karpathy-guidelines.mdc` | Agent 编码行为准则（可选保留） |
| `.cursor/rules/headroom-opscenter.mdc` | **opsCenter 专用** Headroom 压缩规则；非 opsCenter 项目复制后请删除 |
| `.cursor/commands/opsx-*.md` | 7 个 slash 命令：new / ff / propose / continue / apply / verify / archive |
| `.cursor/skills/openspec-*` | 与上述命令对应的 OpenSpec skills |
| `.cursor/settings.json` | 启用 Superpowers 插件 |
| `openspec/config.yaml` | 默认 schema `superpowers-bridge` + 项目 context |
| `openspec/schemas/superpowers-bridge/` | 本地 schema（含 design §Affected Symbols、verify §8 CodeGraph） |
| `openspec/changes/` | change 工作目录（运行时 artifact 落此处） |
| `openspec/specs/` | 归档 sync 后的 capability spec |
| `local/` | 本地临时文件（`.gitignore` 忽略内容，仅保留目录） |

### 与指南的对照结论

对照 `local/openspec-superpowers-codegraph-guide.html`，**核心工作流已齐全**：

- 四件套分工、完整生命周期、CodeGraph × opsx 阶段表 → 在 `openspec-superpowers-bridge.mdc` 与 `schema.yaml`
- 7 个 `/opsx:*` 命令 + 7 个 skills → 一一对应
- design 必填 §Affected Symbols、verify 必填 §8 → schema 模板与 instruction 已含
- Superpowers skills 优先级、反模式、简体中文 commit 规范 → rules + schema 已覆盖

**本仓库与 opsCenter 指南的差异（有意为之）：**

| 指南（opsCenter） | 本基座 |
|---|---|
| `openspec/` 在 `.gitignore`，仅本机 | `openspec/` **提交到 git**，作为可复制模板 |
| 验收命令 `mvn compile` | `openspec/config.yaml` 已改为 **FastAPI / pytest** 示例，复制后按项目改 context |
| 含 Headroom opsCenter 规则 | 同上，非 opsCenter 可删 `headroom-opscenter.mdc` |

**复制后仍需自行配置（不入库）：**

- OpenSpec CLI：`npm install -g @fission-ai/openspec@latest`（Node ≥ 20.19）
- Cursor **Superpowers** 插件（Settings → Plugins）
- **CodeGraph** MCP（`.cursor/mcp.json`，已在 `.gitignore`）
- 可选：全局 `~/.config/openspec/config.json` 扩展 workflows，再 `openspec update --force`

## 复制到新项目

```bash
# 在目标项目根目录执行（按需调整路径）
cp -R /path/to/cursor-coding-base/.cursor/rules   ./.cursor/
cp -R /path/to/cursor-coding-base/.cursor/commands ./.cursor/
cp -R /path/to/cursor-coding-base/.cursor/skills  ./.cursor/
cp    /path/to/cursor-coding-base/.cursor/settings.json ./.cursor/  # 若无则合并 plugins 段
cp -R /path/to/cursor-coding-base/openspec        ./

# 非 opsCenter 项目
rm -f .cursor/rules/headroom-opscenter.mdc
```

然后：

1. 编辑 `openspec/config.yaml` 的 `context`（技术栈、目录约定、验收命令）
2. 若尚无 OpenSpec：`openspec init --tools cursor` 后再覆盖上述 `openspec/` 内容，或保留本 schema 直接 `openspec schema validate superpowers-bridge`
3. 配置 CodeGraph MCP；无索引时 Agent 会提示 `codegraph init -i`
4. **重启 Cursor** 使 slash 命令生效
5. 验证：`openspec schema validate superpowers-bridge`

## 日常使用速查

```
brainstorm（口头 superpowers:brainstorming）
  → 5 条判准满足 + 用户 ack
  → /opsx:propose 或 /opsx:new <name>
  → design + CodeGraph → specs → tasks → plan
  → /opsx:apply <name>
  → /opsx:verify <name>（含 §8 CodeGraph）
  → /opsx:continue → retrospective → /opsx:archive <name>
```

| 场景 | 命令 |
|---|---|
| 需求已清晰，跳过对话 brainstorm | `/opsx:ff <name>` |
| bug fix / typo / 文档微调 | 直接 PR，不开 change |
| change 进度 | `openspec status --change <name> --json` |

Git commit（apply 阶段）：`<type>(<scope>): <中文描述>`

## schema 升级

```bash
git clone https://github.com/JiangWay/openspec-schemas /tmp/oss-upgrade
diff -ruN openspec/schemas/superpowers-bridge /tmp/oss-upgrade/superpowers-bridge
# 确认 diff 后覆盖，保留 Cursor rules 与 config context
openspec schema validate superpowers-bridge
```

当前 schema 版本：`openspec/schemas/superpowers-bridge/VERSION` → `1.0.0`