openspec-proposal-creation-cn

# 规范提案创建

遵循规范驱动开发方法，生成完整的变更提案。

## 快速开始

创建规范提案包含三类输出：
1. **proposal.md** - 为什么、做什么、影响摘要
2. **tasks.json** - 编号的实施清单
3. **spec-delta.md** - 正式的需求变更（ADDED/MODIFIED/REMOVED）

**基本流程**：生成变更 ID → 脚手架目录 → 起草提案 → 编写规范差异 → 验证结构

## 工作流

复制此清单并跟踪进度：

```
规划进度:
- [ ] 第 1 步：审阅现有规范
- [ ] 第 2 步：生成唯一的变更 ID
- [ ] 第 3 步：生成目录结构
- [ ] 第 4 步：起草 proposal.md（为什么、做什么、影响摘要）
- [ ] 第 5 步：创建 tasks.json 实施清单
- [ ] 第 6 步：编写 spec-delta.md 规范差异（ADDED/MODIFIED/REMOVED）
- [ ] 第 7 步：验证提案结构
- [ ] 第 8 步：向用户展示并请求审批
```

### 第 1 步：审阅现有规范

在创建提案前，了解当前状态：

```bash
# 列出所有现有规范
find spec/specs -name "spec.md" -type f

# 列出进行中的变更以避免冲突
find spec/changes -maxdepth 1 -type d -not -path "*/archive"

# 搜索相关需求
grep -r "### Requirement:" spec/specs/
```

### 第 2 步：生成唯一的变更 ID

选择具描述性、URL 安全的标识符：

**格式**：`add-<feature>`、`fix-<issue>`、`update-<component>`、`remove-<feature>`

**示例**：
- `add-user-authentication`
- `fix-payment-validation`
- `update-api-rate-limits`
- `remove-legacy-endpoints`

**校验**：检查是否冲突：
```bash
ls spec/changes/ | grep -i "<proposed-id>"
```

### 第 3 步：生成目录结构

按标准结构创建变更目录：

```bash
# 将 {change-id} 替换为实际 ID
mkdir -p spec/changes/{change-id}/specs/{capability-name}
```

**示例**：
```bash
mkdir -p spec/changes/add-user-auth/specs/authentication
```

### 第 4 步：起草 proposal.md

以 [templates/proposal.md](templates/proposal.md) 为起点。

**必需章节**：
- **Why**：驱动变更的问题或机会
- **What Changes**：修改项清单
- **Impact**：受影响的规范、代码、API、用户

**语气**：清晰、简洁、面向决策。避免不必要背景。

### 第 5 步：创建 tasks.json 实施清单

将实现拆分为具体、可测试的任务。使用 [templates/tasks.json](templates/tasks.json)。

**格式**：
```markdown
# 实施任务
```json
[
  {
    "number": 1,
    "category": "阶段 1：基础设施",
    "task": "环境搭建任务 - 数据库架构、依赖等",
    "steps": [
      { "step": "初始化 Git 仓库并配置 .gitignore", "completed": false },
      { "step": "创建并激活 Python 虚拟环境", "completed": false },
      { "step": "创建 requirements.txt 或 pyproject.toml 并安装依赖 (FastAPI, SQLAlchemy, Pydantic, Alembic 等)", "completed": false },
      { "step": "设计初始数据库 ER 图", "completed": false },
      { "step": "配置数据库连接字符串和环境变量