code-copilot 1.0.0

package/AGENTS.md

@@ -0,0 +1,60 @@
+# Code Copilot — 渐进式 Spec 编码框架
+
+> 跨平台 AI 编码协作框架。适用于 Claude Code、Cursor、Cline、Windsurf、OpenClaw、opencode、Aider 等主流 AI 编码工具。
+
+---
+
+## 身份
+
+你是一个 Spec 驱动的编码协作助手。在写代码之前，先用结构化文档把"做什么、怎么做、有什么约束"说清楚，然后围绕文档编码。
+
+**完整行为准则和命令定义，请读取 `core/agents/copilot-prompt.md`。**
+
+---
+
+## 核心法则（必须遵守）
+
+1. **No Spec, No Code** — 没有文档，不准写代码（小改动如修字段、加日志除外）
+2. **Spec is Truth** — 文档和代码冲突时，错的一定是代码
+3. **Reverse Sync** — 发现偏差，先修文档再修代码
+4. **代码现状必须有出处** — 每个结论标注文件路径和类名/方法名
+5. **Verification 铁律** — 完成任务后必须展示可验证证据，禁止"应该没问题"
+6. **零偏差原则** — Plan 是合同，AI 是打印机
+7. **HARD-GATE** — spec 全部确认后才能开始编码
+
+---
+
+## 意图识别（自然语言触发）
+
+收到用户指令时，先识别意图并映射到对应的工作流步骤：
+
+| 用户可能说的话 | 工作流步骤 |
+|---|---|
+| "修复 xxx" / "改一下 xxx" / "fix xxx" | `/fix` 流程 |
+| "我要做 xxx 需求" / "新增 xxx 功能" / "开发 xxx" | `/propose` 流程 |
+| "开始写代码" / "继续执行" / "开始实现" | `/apply` 流程 |
+| "帮我看看代码" / "review 一下" / "审查" | `/review` 流程 |
+| "写测试" / "补单测" / "写单元测试" | `/test` 流程 |
+| "归档 xxx" / "结束这个需求" | `/archive` 流程 |
+| "初始化项目" / "设置项目上下文" | `/init` 流程 |
+
+触发工作流后，**读取 `core/agents/copilot-prompt.md` 中对应命令的详细执行逻辑。**
+
+纯技术讨论不需要走工作流，直接回答。
+
+---
+
+## 渐进式复杂度
+
+- 🟢 **小改动**（改字段、修 bug、加日志）→ 直接改，Rules 始终生效
+- 🟡 **中等需求**（新增接口、改业务逻辑）→ Rules + Spec + Tasks
+- 🔴 **大需求**（跨模块重构、涉及 5+ 模块）→ 全流程
+
+---
+
+## 项目规则
+
+读取 `core/rules/` 下标记 `alwaysApply: true` 的文件：
+- `core/rules/project-context.md` — 工程结构和技术栈
+- `core/rules/coding-style.md` — 编码规范
+- `core/rules/security.md` — 安全红线

package/README.md

@@ -0,0 +1,268 @@
+# Code Copilot — Progressive Spec Coding Framework
+
+[中文](#中文) | [English](#english)
+
+---
+
+## 中文
+
+> 跨平台 AI 编码协作框架，基于 Spec 驱动的渐进式编码方法论。
+> 支持 Claude Code、Cursor、Cline、Windsurf、OpenClaw、CoPaw、OpenCode、Aider 等工具。
+
+### 一键安装
+
+在你的项目根目录执行一条命令即可：
+
+```bash
+# Node.js 用户（推荐）
+npx code-copilot init              # 默认安装 Claude Code 适配
+npx code-copilot init cursor       # 安装 Cursor 适配
+npx code-copilot init openclaw     # 安装 OpenClaw 适配
+npx code-copilot init all          # 安装所有平台适配
+```
+
+```bash
+# Mac / Linux 用户（无需 Node.js）
+curl -fsSL https://raw.githubusercontent.com/lawushanshan/code-copilot/main/install.sh | bash -s -- claude
+```
+
+可选平台：`claude`、`openclaw`、`copaw`、`cursor`、`cline`、`windsurf`、`opencode`、`aider`、`all`
+
+### 核心理念
+
+在让 AI 写代码之前，先用结构化文档（Spec）把"要做什么、怎么做、有什么约束"说清楚，然后 AI 围绕这份文档编码。
+
+**三条铁律**：
+1. **No Spec, No Code** — 没有文档，不准写代码
+2. **Spec is Truth** — 文档和代码冲突时，错的一定是代码
+3. **Reverse Sync** — 发现偏差，先修文档再修代码
+
+**渐进式复杂度**：不同复杂度的需求暴露不同深度的流程 — 小改动直接改，中等需求走 Spec+Tasks，大需求走全流程。
+
+### 目录结构
+
+```
+.
+├── AGENTS.md                          # 通用适配入口（所有平台自动识别）
+├── README.md                          # 本文件
+├── core/                              # 核心（平台无关）
+│   ├── rules/                         #   项目约束（始终加载）
+│   │   ├── project-context.md         #     工程结构和技术栈（/init 填充）
+│   │   ├── coding-style.md            #     编码规范
+│   │   ├── security.md                #     安全红线
+│   │   └── domain-rules.md            #     业务领域约束
+│   ├── knowledge/                     #   领域知识（按需加载）
+│   │   └── index.md                   #     知识索引（知识飞轮输出）
+│   ├── agents/                        #   Prompt 模板（核心资产）
+│   │   ├── copilot-prompt.md          #     主 Agent 完整指令
+│   │   ├── spec-reviewer.md           #     Spec 合规审查
+│   │   └── code-quality-reviewer.md   #     代码质量审查
+│   ├── templates/                     #   文件模板
+│   │   ├── spec.md                    #     Spec 文档模板
+│   │   ├── tasks.md                   #     任务拆分模板
+│   │   ├── test-spec.md               #     单测 Spec 模板
+│   │   └── log.md                     #     变更日志模板
+│   └── changes/                       #   变更目录（运行时创建）
+└── adapters/                          # 平台适配层（薄壳）
+    ├── claude-code/                   #   Claude Code（斜杠命令）
+    ├── openclaw/                      #   OpenClaw（AGENTS.md + SOUL.md + IDENTITY.md）
+    ├── copaw/                         #   CoPaw（Skills + config.yaml）
+    ├── cursor/                        #   Cursor（.cursorrules）
+    ├── cline/                         #   Cline（.clinerules）
+    ├── windsurf/                      #   Windsurf（.windsurfrules）
+    ├── opencode/                      #   OpenCode（opencode.json）
+    └── aider/                         #   Aider（.aider.conf.yml）
+```
+
+### 快速开始
+
+推荐使用一键安装（见上方），也可以手动复制：
+
+```bash
+git clone https://github.com/lawushanshan/code-copilot.git
+# 然后将 AGENTS.md、core/ 和对应平台的适配文件复制到你的项目中
+```
+
+### 初始化
+
+安装完成后，让 AI 分析你的项目并填充工程上下文：
+
+```
+/init
+```
+
+或非 Claude Code 平台：
+
+```
+请初始化项目上下文，分析工程结构并填充 project-context.md
+```
+
+### 工作流概览
+
+```
+/init → /propose → /apply → /review → /fix（如需） → /archive
+                 ↗              ↓
+               直接改（小改动）  /test（可选）
+```
+
+| 阶段 | 角色分工 | 产出 |
+|------|---------|------|
+| `/init` | AI 全自动 | `rules/project-context.md` |
+| `/propose` | 人主导，AI 辅助 | `changes/<名>/spec.md` + `tasks.md` + `log.md` |
+| `/apply` | AI 主导，人审查 | 代码 + git commits |
+| `/review` | AI 审查 | 合规报告 + 质量报告 |
+| `/fix` | AI 执行，人审查 | 增量代码修正 |
+| `/archive` | 人决定，AI 执行 | 知识沉淀到 `knowledge/` |
+
+### 自定义指南
+
+| 想改什么 | 编辑哪个文件 |
+|---------|------------|
+| 编码规范 | `core/rules/coding-style.md` |
+| 业务规则 | `core/rules/domain-rules.md` |
+| 安全规则 | `core/rules/security.md` |
+| 核心工作流 | `core/agents/copilot-prompt.md` |
+| 文档模板 | `core/templates/` 下对应文件 |
+
+### 设计原则
+
+- **核心逻辑在 `core/`，适配器只是薄壳** — 更新框架只需改 core
+- **纯 Markdown，零依赖** — 复制即用，无需安装
+- **双触发模式** — 斜杠命令（Claude Code）+ 自然语言意图映射（所有平台）
+- **知识飞轮** — 每次变更的经验自动沉淀，持续提升 AI 理解力
+
+---
+
+## English
+
+> A cross-platform AI coding collaboration framework based on Spec-driven progressive coding methodology.
+> Supports Claude Code, Cursor, Cline, Windsurf, OpenClaw, CoPaw, OpenCode, Aider, and more.
+
+### Core Philosophy
+
+Before letting AI write code, use structured documentation (Spec) to clarify *what to do, how to do it, and what constraints exist*. Then AI codes around that document.
+
+**Three Iron Laws**:
+1. **No Spec, No Code** — No documentation, no coding allowed
+2. **Spec is Truth** — When code conflicts with docs, code is wrong
+3. **Reverse Sync** — When deviations are found, fix docs first, then code
+
+**Progressive Complexity**: Different requirement complexities expose different workflow depths — small changes go direct, medium needs go through Spec+Tasks, large needs use the full workflow.
+
+### Directory Structure
+
+```
+.
+├── AGENTS.md                          # Universal adapter entry (auto-detected by all platforms)
+├── README.md                          # This file
+├── core/                              # Core (platform-agnostic)
+│   ├── rules/                         #   Project constraints (always loaded)
+│   │   ├── project-context.md         #     Project structure & tech stack (filled by /init)
+│   │   ├── coding-style.md            #     Coding conventions
+│   │   ├── security.md                #     Security red lines
+│   │   └── domain-rules.md            #     Business domain constraints
+│   ├── knowledge/                     #   Domain knowledge (loaded on demand)
+│   │   └── index.md                   #     Knowledge index (knowledge flywheel output)
+│   ├── agents/                        #   Prompt templates (core asset)
+│   │   ├── copilot-prompt.md          #     Main Agent full instructions
+│   │   ├── spec-reviewer.md           #     Spec compliance review
+│   │   └── code-quality-reviewer.md   #     Code quality review
+│   ├── templates/                     #   Document templates
+│   │   ├── spec.md                    #     Spec document template
+│   │   ├── tasks.md                   #     Task breakdown template
+│   │   ├── test-spec.md               #     Unit test spec template
+│   │   └── log.md                     #     Change log template
+│   └── changes/                       #   Changes directory (created at runtime)
+└── adapters/                          # Platform adapters (thin shells)
+    ├── claude-code/                   #   Claude Code (slash commands)
+    ├── openclaw/                      #   OpenClaw (AGENTS.md + SOUL.md + IDENTITY.md)
+    ├── copaw/                         #   CoPaw (Skills + config.yaml)
+    ├── cursor/                        #   Cursor (.cursorrules)
+    ├── cline/                         #   Cline (.clinerules)
+    ├── windsurf/                      #   Windsurf (.windsurfrules)
+    ├── opencode/                      #   OpenCode (opencode.json)
+    └── aider/                         #   Aider (.aider.conf.yml)
+```
+
+### One-Line Install
+
+Run one command in your project root:
+
+```bash
+# Node.js users (recommended)
+npx code-copilot init              # Claude Code (default)
+npx code-copilot init cursor       # Cursor
+npx code-copilot init openclaw     # OpenClaw
+npx code-copilot init all          # All adapters
+```
+
+```bash
+# Mac / Linux users (no Node.js required)
+curl -fsSL https://raw.githubusercontent.com/lawushanshan/code-copilot/main/install.sh | bash -s -- claude
+```
+
+Available platforms: `claude`, `openclaw`, `copaw`, `cursor`, `cline`, `windsurf`, `opencode`, `aider`, `all`
+
+### Quick Start
+
+One-line install is recommended (see above). You can also install manually:
+
+```bash
+git clone https://github.com/lawushanshan/code-copilot.git
+# Then copy AGENTS.md, core/, and your platform's adapter files into your project
+```
+
+### Initialize
+
+After installation, let AI analyze your project and fill the engineering context:
+
+```
+/init
+```
+
+Or for non-Claude Code platforms:
+
+```
+Please initialize the project context, analyze the project structure and fill project-context.md
+```
+
+### Workflow Overview
+
+```
+/init → /propose → /apply → /review → /fix (if needed) → /archive
+                 ↗              ↓
+               Direct fix        /test (optional)
+               (small changes)
+```
+
+| Phase | Role | Output |
+|-------|------|--------|
+| `/init` | AI fully automatic | `rules/project-context.md` |
+| `/propose` | Human-led, AI-assisted | `changes/<name>/spec.md` + `tasks.md` + `log.md` |
+| `/apply` | AI-led, human reviews | Code + git commits |
+| `/review` | AI reviews | Compliance report + quality report |
+| `/fix` | AI executes, human reviews | Incremental code fixes |
+| `/archive` | Human decides, AI executes | Knowledge captured in `knowledge/` |
+
+### Customization Guide
+
+| What to customize | Which file to edit |
+|-------------------|-------------------|
+| Coding conventions | `core/rules/coding-style.md` |
+| Business rules | `core/rules/domain-rules.md` |
+| Security rules | `core/rules/security.md` |
+| Core workflow | `core/agents/copilot-prompt.md` |
+| Document templates | Corresponding file in `core/templates/` |
+
+### Design Principles
+
+- **Core logic in `core/`, adapters are thin shells** — Update the framework by changing only `core/`
+- **Pure Markdown, zero dependencies** — Copy and use, no installation needed
+- **Dual trigger mode** — Slash commands (Claude Code) + natural language intent mapping (all platforms)
+- **Knowledge flywheel** — Experience from each change is automatically captured, continuously improving AI understanding
+
+---
+
+## License
+
+MIT

package/adapters/aider/.aider.conf.yml

@@ -0,0 +1,18 @@
+# Aider 适配 — Code Copilot
+
+# 让 Aider 加载通用配置
+read: AGENTS.md
+
+# 编码规范提示
+map_prompt: |
+  你是一个 Spec 驱动的编码协作助手。
+  完整行为准则在 core/agents/copilot-prompt.md 中。
+  核心法则：No Spec No Code、Spec is Truth、Reverse Sync、HARD-GATE。
+
+# 告诉 Aider 框架文件的位置
+map_tokens: 8192
+
+# 日志设置
+watch_files:
+  - core/rules/
+  - core/changes/

package/adapters/claude-code/.claude/commands/apply.md

@@ -0,0 +1,20 @@
+请执行 `/apply` 命令：执行编码。
+
+**执行步骤**：
+1. 读取 `core/agents/copilot-prompt.md` 中 `/apply` 章节的完整定义
+2. 读取 `core/changes/<变更名>/spec.md` 和 `tasks.md`
+3. 执行前置检查：spec 已确认 + tasks 存在 + 非 master 分支
+4. 逐 task 执行，每个 task 完成后：
+   - 展示修改文件列表（NEW/MOD/DEL）
+   - 展示关键代码变更摘要
+   - **展示验证证据**（编译输出/测试输出）
+   - 更新 `log.md`（决策、踩坑、知识发现）
+   - 自动 git commit（格式：`[<变更名>] <中文简述>`）
+   - 等待用户确认后继续下一个 task
+
+**铁律**：
+- 零偏差原则：Plan 是合同，AI 是打印机
+- 遇到逻辑冲突或 spec 缺失 → 紧急停车，执行 Reverse Sync
+- 禁止自动 push
+
+变更名：$ARGUMENTS

package/adapters/claude-code/.claude/commands/archive.md

@@ -0,0 +1,15 @@
+请执行 `/archive` 命令：归档 + 知识沉淀。
+
+**执行步骤**：
+1. 读取 `core/agents/copilot-prompt.md` 中 `/archive` 章节的完整定义
+2. 确认所有 task 已完成且 review 通过
+3. 读取 `core/changes/<变更名>/log.md`
+4. 逐条展示 log.md 中的知识发现和踩坑记录
+5. 询问用户哪些需要沉淀：
+   - 确认的更新到 `core/knowledge/index.md`（按触发关键词索引）
+   - 如果发现新的业务规则，更新 `core/rules/domain-rules.md`
+   - 如果发现新的编码约定，更新 `core/rules/coding-style.md`
+6. 将 spec.md 状态更新为 `done`
+7. 展示归档摘要
+
+变更名：$ARGUMENTS

package/adapters/claude-code/.claude/commands/fix.md

@@ -0,0 +1,13 @@
+请执行 `/fix` 命令：增量修正。
+
+**执行步骤**：
+1. 读取 `core/agents/copilot-prompt.md` 中 `/fix` 章节的完整定义
+2. 读取 `core/changes/<变更名>/spec.md`、`tasks.md`、`log.md`
+3. 分析需要修正的问题列表
+4. 逐个修正，每个修正展示 diff
+5. **文档同步铁律**：每次修正必须同步更新 spec.md、tasks.md、log.md
+6. 自动 git commit
+
+**注意**：`/fix` 与 `/apply` 的区别 — `/apply` 按任务顺序初始编码，`/fix` 在已完成基础上增量修正。
+
+变更名和修正描述：$ARGUMENTS

package/adapters/claude-code/.claude/commands/init.md

@@ -0,0 +1,13 @@
+请执行 `/init` 命令：初始化项目上下文。
+
+**执行步骤**：
+1. 读取 `core/agents/copilot-prompt.md` 中 `/init` 章节的完整定义
+2. 读取 `core/rules/project-context.md` 了解需要填充的模板
+3. 分析当前工程结构（扫描源码目录、构建文件、依赖声明）
+4. 识别技术栈、分层架构、关键依赖
+5. 填充 `core/rules/project-context.md` 的所有占位符
+6. 展示填充结果，请用户确认
+
+**约束**：每个结论必须有代码出处（文件路径 + 类名/方法名），不允许凭空推断。
+
+需求描述：$ARGUMENTS

package/adapters/claude-code/.claude/commands/propose.md

@@ -0,0 +1,18 @@
+请执行 `/propose` 命令：创建变更提案。
+
+**执行步骤**：
+1. 读取 `core/agents/copilot-prompt.md` 中 `/propose` 章节的完整定义
+2. 读取 `core/rules/` 下所有 `alwaysApply: true` 的规则文件
+3. 按以下流程执行：
+   - **Phase 1: Research** — 分析代码现状，每个结论必须有出处
+   - **Phase 2: 逐个提问** — 一次只问一个问题，给选项 + 推荐，YAGNI 裁剪
+   - **Phase 3: 分段生成 Spec** — 参照 `core/templates/spec.md` 模板，按段输出每段等确认
+   - **Phase 4: 生成 Tasks** — 参照 `core/templates/tasks.md` 模板
+   - **Phase 5: HARD-GATE** — 等用户显式确认，确认前禁止编码
+4. 在 `core/changes/<change-name>/` 下创建 spec.md + tasks.md + log.md
+
+**铁律**：
+- 不允许凭空设计，所有结论必须来自实际代码
+- 待澄清全部解决前不允许进入 `/apply`
+
+需求描述：$ARGUMENTS

package/adapters/claude-code/.claude/commands/review.md

@@ -0,0 +1,22 @@
+请执行 `/review` 命令：两阶段审查。
+
+**执行步骤**：
+1. 读取 `core/agents/copilot-prompt.md` 中 `/review` 章节的完整定义
+2. 执行两阶段审查：
+
+**阶段一：Spec Compliance**
+- 读取 `core/agents/spec-reviewer.md` 作为审查 prompt
+- **优先使用 Sub Agent 执行**（上下文与实现者隔离）
+- 读取 `core/changes/<变更名>/spec.md` 和 `tasks.md`
+- 逐条比对 spec 功能点与实际代码
+- 核心原则："不信报告只信代码"
+- 输出每个功能点的 ✅/❌/⚠️ + 最终 PASS/FAIL
+
+**阶段二：Code Quality**（阶段一 PASS 后才启动）
+- 读取 `core/agents/code-quality-reviewer.md` 作为审查 prompt
+- 基于 `core/rules/` 检查编码规范、安全红线
+- 按 Critical / Important / Minor 分级
+
+**结论**：任一 FAIL → 建议执行 `/fix`；两阶段均 PASS → 建议执行 `/archive`
+
+变更名：$ARGUMENTS

package/adapters/claude-code/.claude/commands/test.md

@@ -0,0 +1,14 @@
+请执行 `/test` 命令：生成单测并执行。
+
+**执行步骤**：
+1. 读取 `core/agents/copilot-prompt.md` 中 `/test` 章节的完整定义
+2. 读取 `core/templates/test-spec.md` 作为模板
+3. 读取 `core/changes/<变更名>/spec.md` 了解变更内容
+4. 按 Red/Green TDD 流程执行：
+   - 运行已有测试套件，了解基线
+   - 生成测试 spec
+   - **先确认 Red**（测试必须失败）
+   - 实现代码使测试 Green
+   - **展示实际测试输出**，禁止"测试通过"等无证据声明
+
+变更名：$ARGUMENTS

package/adapters/cline/.clinerules

@@ -0,0 +1,38 @@
+# Code Copilot — Cline 适配
+
+你是一个 Spec 驱动的编码协作助手。
+
+## 完整行为准则
+
+当用户触发工作流时，**必须先读取 `core/agents/copilot-prompt.md` 获取完整指令**。
+
+## 核心法则
+
+1. No Spec, No Code — 没有文档，不准写代码（小改动除外）
+2. Spec is Truth — 文档和代码冲突时，错的一定是代码
+3. Reverse Sync — 发现偏差，先修文档再修代码
+4. 代码现状必须有出处 — 标注文件路径和类名/方法名
+5. Verification 铁律 — 完成后展示可验证证据
+6. 零偏差原则 — Plan 是合同，AI 是打印机
+7. HARD-GATE — spec 全部确认后才能开始编码
+
+## 意图识别
+
+| 用户说 | 执行 |
+|---|---|
+| "修复" / "fix" | `/fix` 流程（读取 copilot-prompt.md） |
+| "需求" / "新增" / "开发" | `/propose` 流程 |
+| "开始执行" / "继续" | `/apply` 流程 |
+| "review" / "审查" | `/review` 流程 |
+| "测试" / "单测" | `/test` 流程 |
+| "归档" | `/archive` 流程 |
+
+## 渐进式复杂度
+
+- 小改动 → 直接改
+- 中等需求 → Spec + Tasks
+- 大需求 → 全流程（Spec + Tasks + Review + Knowledge）
+
+## 项目规则
+
+读取 `core/rules/` 下的规则文件：project-context.md、coding-style.md、security.md。

package/adapters/copaw/config.yaml

@@ -0,0 +1,22 @@
+# CoPaw 适配 — Code Copilot 配置
+
+# 自动加载的工作区文件
+workspace_files:
+  - AGENTS.md
+
+# 自定义 Skills 路径
+skills:
+  - skills/code-copilot/
+
+# 上下文文件（始终加载）
+context_files:
+  - core/rules/project-context.md
+  - core/rules/coding-style.md
+  - core/rules/security.md
+  - core/rules/domain-rules.md
+
+# 监听变更的文件
+watch_files:
+  - core/rules/
+  - core/changes/
+  - core/knowledge/

package/adapters/copaw/skills/code-copilot/SKILL.md

@@ -0,0 +1,69 @@
+# Skill: Code Copilot — Spec 驱动编码协作
+
+> 渐进式 Spec Coding 框架，基于 Spec 驱动的结构化编码方法论。
+
+---
+
+## 触发关键词
+
+当用户消息包含以下意图时，自动触发对应工作流：
+
+| 意图 | 触发词 | 执行动作 |
+|------|--------|---------|
+| 初始化 | 初始化、项目分析、/init | 读取 `core/agents/copilot-prompt.md` 执行 `/init` 流程 |
+| 提案 | 需求、新增、提案、/propose | 读取 `core/agents/copilot-prompt.md` 执行 `/propose` 流程 |
+| 编码 | 执行、继续、开始写、/apply | 读取 `core/agents/copilot-prompt.md` 执行 `/apply` 流程 |
+| 修正 | 修复、修正、fix、/fix | 读取 `core/agents/copilot-prompt.md` 执行 `/fix` 流程 |
+| 审查 | review、审查、检查、/review | 读取 `core/agents/copilot-prompt.md` 执行 `/review` 流程 |
+| 测试 | 测试、单测、test、/test | 读取 `core/agents/copilot-prompt.md` 执行 `/test` 流程 |
+| 归档 | 归档、完成、archive、/archive | 读取 `core/agents/copilot-prompt.md` 执行 `/archive` 流程 |
+
+## 行为准则
+
+### Spec Coding 三条铁律
+
+1. **No Spec, No Code** — 没有文档，不准写代码（小改动除外）
+2. **Spec is Truth** — 文档和代码冲突时，错的一定是代码
+3. **Reverse Sync** — 发现偏差，先修文档再修代码
+
+### 五条执行铁律
+
+4. **代码现状必须有出处** — 标注文件路径和类名/方法名
+5. **变更即记录** — 代码变更后同步更新变更文档
+6. **Verification 铁律** — 展示可验证证据，禁止"应该没问题"
+7. **零偏差原则** — Plan 是合同，AI 是打印机
+8. **HARD-GATE** — spec 全部确认后才能开始编码
+
+## 执行流程
+
+当匹配到上述意图时：
+
+1. **读取核心指令** — 加载 `core/agents/copilot-prompt.md` 获取完整工作流定义
+2. **加载项目约束** — 加载 `core/rules/` 下所有规则文件
+3. **按命令定义执行** — 严格按照 copilot-prompt.md 中的命令步骤执行
+4. **使用对应模板** — 参考 `core/templates/` 中的模板生成文档
+
+## 自由度曲线
+
+| 阶段 | 自由度 |
+|------|--------|
+| 调研 | 中（自由探索但必须给证据） |
+| 方案设计 | 高（唯一鼓励充分想象的阶段） |
+| 规划 | 低（精确到文件路径和函数签名） |
+| 执行 | 零（严格按计划施工） |
+| 验收 | 中（自由检查但结论要有依据） |
+
+## 渐进式复杂度
+
+| 需求复杂度 | 流程 | 示例 |
+|-----------|------|------|
+| 小改动（1-2 文件） | 直接改 | 修 typo、加 log、调样式 |
+| 中等需求（3-10 文件） | Spec + Tasks | 加字段、改接口、加缓存 |
+| 大需求（10+ 文件） | 全流程 | 新模块、重构、跨服务变更 |
+
+## 知识来源
+
+- `core/agents/copilot-prompt.md` — 完整工作流定义（核心）
+- `core/rules/` — 项目约束（始终加载）
+- `core/knowledge/index.md` — 领域知识（按需查阅）
+- `core/templates/` — 文档模板（生成文档时参考）

package/adapters/cursor/.cursorrules

@@ -0,0 +1,47 @@
+# Code Copilot — Cursor 适配
+
+你是一个 Spec 驱动的编码协作助手。在写代码之前，先用结构化文档把"做什么、怎么做、有什么约束"说清楚。
+
+## 重要：完整行为准则
+
+当用户触发以下工作流时，**必须先读取 `core/agents/copilot-prompt.md` 获取完整指令**：
+- 提案/需求/开发 → 读取 copilot-prompt.md 的 `/propose` 章节
+- 开始执行/继续 → 读取 `/apply` 章节
+- 修复/修正 → 读取 `/fix` 章节
+- 审查/review → 读取 `/review` 章节
+- 写测试 → 读取 `/test` 章节
+- 归档 → 读取 `/archive` 章节
+
+## 核心法则
+
+1. **No Spec, No Code** — 没有文档，不准写代码（小改动除外）
+2. **Spec is Truth** — 文档和代码冲突时，错的一定是代码
+3. **Reverse Sync** — 发现偏差，先修文档再修代码
+4. **代码现状必须有出处** — 每个结论标注文件路径和类名/方法名
+5. **Verification 铁律** — 完成后必须展示可验证证据
+6. **零偏差原则** — Plan 是合同，AI 是打印机
+7. **HARD-GATE** — spec 全部确认后才能开始编码
+
+## 意图识别
+
+| 用户说 | 执行 |
+|---|---|
+| "修复 xxx" / "fix xxx" | `/fix` 流程 |
+| "我要做 xxx" / "新增 xxx" / "开发 xxx" | `/propose` 流程 |
+| "开始写代码" / "继续执行" | `/apply` 流程 |
+| "review 一下" / "审查" | `/review` 流程 |
+| "写测试" / "补单测" | `/test` 流程 |
+| "归档 xxx" | `/archive` 流程 |
+
+## 渐进式复杂度
+
+- 🟢 小改动（改字段、修 bug）→ 直接改
+- 🟡 中等需求（新增接口、改逻辑）→ Spec + Tasks
+- 🔴 大需求（跨模块重构）→ 全流程
+
+## 项目规则
+
+读取 `core/rules/` 下的规则文件：
+- `core/rules/project-context.md` — 工程结构
+- `core/rules/coding-style.md` — 编码规范
+- `core/rules/security.md` — 安全红线