specops 0.2.4 → 0.3.0

package/.opencode/workflows/complete-milestone.md

@@ -0,0 +1,763 @@
+<purpose>
+
+标记已发布的版本（v1.0、v1.1、v2.0）为完成。在 MILESTONES.md 中创建历史记录，执行完整的 PROJECT.md 演进审查，使用里程碑分组重组 ROADMAP.md，并在 git 中标记发布。
+
+</purpose>
+
+<required_reading>
+
+1. templates/milestone.md
+2. templates/milestone-archive.md
+3. `.planning/ROADMAP.md`
+4. `.planning/REQUIREMENTS.md`
+5. `.planning/PROJECT.md`
+
+</required_reading>
+
+<archival_behavior>
+
+里程碑完成时：
+
+1. 将完整里程碑详情提取到 `.planning/milestones/v[X.Y]-ROADMAP.md`
+2. 将需求归档到 `.planning/milestones/v[X.Y]-REQUIREMENTS.md`
+3. 更新 ROADMAP.md——用一行摘要替换里程碑详情
+4. 删除 REQUIREMENTS.md（下一个里程碑全新开始）
+5. 执行完整的 PROJECT.md 演进审查
+6. 提供内联创建下一个里程碑的选项
+
+**上下文效率：** 归档使 ROADMAP.md 保持恒定大小，REQUIREMENTS.md 保持里程碑范围。
+
+**ROADMAP 归档**使用 `templates/milestone-archive.md`——包含里程碑头部（状态、阶段、日期）、完整阶段详情、里程碑摘要（决策、问题、技术债务）。
+
+**REQUIREMENTS 归档**包含所有标记为完成的需求及结果、含最终状态的可追溯表、变更需求说明。
+
+</archival_behavior>
+
+<process>
+
+<step name="verify_readiness">
+
+**使用 `roadmap analyze` 进行全面就绪检查：**
+
+```bash
+ROADMAP=$(node .opencode/bin/specops-tools.cjs roadmap analyze)
+```
+
+这会返回所有阶段的计划/摘要计数和磁盘状态。用它来验证：
+- 哪些阶段属于此里程碑？
+- 所有阶段是否完成（所有计划都有摘要）？检查每个阶段的 `disk_status === 'complete'`。
+- `progress_percent` 应为 100%。
+
+**需求完成检查（展示前必须执行）：**
+
+解析 REQUIREMENTS.md 可追溯表：
+- 统计 v1 总需求数与已勾选（`[x]`）需求数
+- 识别可追溯表中所有非完成行
+
+展示：
+
+```
+Milestone: [Name, e.g., "v1.0 MVP"]
+
+Includes:
+- Phase 1: Foundation (2/2 plans complete)
+- Phase 2: Authentication (2/2 plans complete)
+- Phase 3: Core Features (3/3 plans complete)
+- Phase 4: Polish (1/1 plan complete)
+
+Total: {phase_count} phases, {total_plans} plans, all complete
+Requirements: {N}/{M} v1 requirements checked off
+```
+
+**如果需求不完整**（N < M）：
+
+```
+⚠ Unchecked Requirements:
+
+- [ ] {REQ-ID}: {description} (Phase {X})
+- [ ] {REQ-ID}: {description} (Phase {Y})
+```
+
+必须展示 3 个选项：
+1. **继续** — 标记里程碑完成，记录已知差距
+2. **先运行审计** — `/specops:audit-milestone` 评估差距严重程度
+3. **中止** — 返回开发
+
+如果用户选择「继续」：在 MILESTONES.md 的 `### Known Gaps` 下记录不完整的需求，包含 REQ-ID 和描述。
+
+<config-check>
+
+```bash
+cat .planning/config.json 2>/dev/null
+```
+
+</config-check>
+
+<if mode="yolo">
+
+```
+⚡ 自动批准：里程碑范围验证
+[显示分解摘要，无需提示]
+继续收集统计数据...
+```
+
+继续到 gather_stats。
+
+</if>
+
+<if mode="interactive" OR="custom with gates.confirm_milestone_scope true">
+
+```
+准备好标记此里程碑为已发布了吗？
+(yes / wait / adjust scope)
+```
+
+等待确认。
+- "adjust scope"：询问要包含哪些阶段。
+- "wait"：停止，用户准备好后返回。
+
+</if>
+
+</step>
+
+<step name="gather_stats">
+
+计算里程碑统计数据：
+
+```bash
+git log --oneline --grep="feat(" | head -20
+git diff --stat FIRST_COMMIT..LAST_COMMIT | tail -1
+find . -name "*.swift" -o -name "*.ts" -o -name "*.py" | xargs wc -l 2>/dev/null
+git log --format="%ai" FIRST_COMMIT | tail -1
+git log --format="%ai" LAST_COMMIT | head -1
+```
+
+展示：
+
+```
+里程碑统计：
+- 阶段：[X-Y]
+- 计划：[Z] 总计
+- 任务：[N] 总计（来自阶段摘要）
+- 修改文件：[M]
+- 代码行数：[LOC] [language]
+- 时间线：[Days] 天（[Start] → [End]）
+- Git 范围：feat(XX-XX) → feat(YY-YY)
+```
+
+</step>
+
+<step name="extract_accomplishments">
+
+使用 summary-extract 从 SUMMARY.md 文件提取一句话摘要：
+
+```bash
+# For each phase in milestone, extract one-liner
+for summary in .planning/phases/*-*/*-SUMMARY.md; do
+  node .opencode/bin/specops-tools.cjs summary-extract "$summary" --fields one_liner | jq -r '.one_liner'
+done
+```
+
+提取 4-6 个关键成就。展示：
+
+```
+此里程碑的关键成就：
+1. [阶段 1 的成就]
+2. [阶段 2 的成就]
+3. [阶段 3 的成就]
+4. [阶段 4 的成就]
+5. [阶段 5 的成就]
+```
+
+</step>
+
+<step name="create_milestone_entry">
+
+**注意：** MILESTONES.md 条目现在由 `specops-tools milestone complete` 在 archive_milestone 步骤中自动创建。该条目包含版本、日期、阶段/计划/任务计数，以及从 SUMMARY.md 文件提取的成就。
+
+如果需要额外详情（如用户提供的「Delivered」摘要、git 范围、LOC 统计），在 CLI 创建基础条目后手动添加。
+
+</step>
+
+<step name="evolve_project_full_review">
+
+里程碑完成时的完整 PROJECT.md 演进审查。
+
+阅读所有阶段摘要：
+
+```bash
+cat .planning/phases/*-*/*-SUMMARY.md
+```
+
+**完整审查清单：**
+
+1. **「What This Is」准确性：**
+   - 将当前描述与实际构建的内容进行比较
+   - 如果产品有实质性变化则更新
+
+2. **核心价值检查：**
+   - 优先级仍然正确吗？发布是否揭示了不同的核心价值？
+   - 如果核心事项已转移则更新
+
+3. **需求审计：**
+
+   **已验证部分：**
+   - 此里程碑发布的所有活跃需求 → 移至已验证
+   - 格式：`- ✓ [Requirement] — v[X.Y]`
+
+   **活跃部分：**
+   - 移除已移至已验证的需求
+   - 为下一个里程碑添加新需求
+   - 保留未处理的需求
+
+   **不在范围内审计：**
+   - 审查每个项目——理由是否仍然有效？
+   - 移除不相关的项目
+   - 添加在里程碑期间被否决的需求
+
+4. **上下文更新：**
+   - 当前代码库状态（LOC、技术栈）
+   - 用户反馈主题（如有）
+   - 已知问题或技术债务
+
+5. **关键决策审计：**
+   - 从里程碑阶段摘要提取所有决策
+   - 添加到关键决策表，含结果
+   - 标记 ✓ 良好、⚠️ 待复审 或 — 待定
+
+6. **约束检查：**
+   - 开发过程中是否有约束变更？按需更新
+
+内联更新 PROJECT.md。更新「Last updated」页脚：
+
+```markdown
+---
+*Last updated: [date] after v[X.Y] milestone*
+```
+
+**完整演进示例（v1.0 → v1.1 准备）：**
+
+之前：
+
+```markdown
+## What This Is
+
+A real-time collaborative whiteboard for remote teams.
+
+## Core Value
+
+Real-time sync that feels instant.
+
+## Requirements
+
+### Validated
+
+(None yet — ship to validate)
+
+### Active
+
+- [ ] Canvas drawing tools
+- [ ] Real-time sync < 500ms
+- [ ] User authentication
+- [ ] Export to PNG
+
+### Out of Scope
+
+- Mobile app — web-first approach
+- Video chat — use external tools
+```
+
+v1.0 之后：
+
+```markdown
+## What This Is
+
+A real-time collaborative whiteboard for remote teams with instant sync and drawing tools.
+
+## Core Value
+
+Real-time sync that feels instant.
+
+## Requirements
+
+### Validated
+
+- ✓ Canvas drawing tools — v1.0
+- ✓ Real-time sync < 500ms — v1.0 (achieved 200ms avg)
+- ✓ User authentication — v1.0
+
+### Active
+
+- [ ] Export to PNG
+- [ ] Undo/redo history
+- [ ] Shape tools (rectangles, circles)
+
+### Out of Scope
+
+- Mobile app — web-first approach, PWA works well
+- Video chat — use external tools
+- Offline mode — real-time is core value
+
+## Context
+
+Shipped v1.0 with 2,400 LOC TypeScript.
+Tech stack: Next.js, Supabase, Canvas API.
+Initial user testing showed demand for shape tools.
+```
+
+**步骤完成条件：**
+
+- [ ] 审查并按需更新「What This Is」
+- [ ] 验证核心价值仍然正确
+- [ ] 所有已发布需求移至已验证
+- [ ] 为下一个里程碑添加新需求到活跃
+- [ ] 审计不在范围内的理由
+- [ ] 用当前状态更新上下文
+- [ ] 所有里程碑决策添加到关键决策
+- [ ] 「Last updated」页脚反映里程碑完成
+
+</step>
+
+<step name="reorganize_roadmap">
+
+更新 `.planning/ROADMAP.md` — 对已完成的里程碑阶段进行分组：
+
+```markdown
+# Roadmap: [Project Name]
+
+## Milestones
+
+- ✅ **v1.0 MVP** — Phases 1-4 (shipped YYYY-MM-DD)
+- 🚧 **v1.1 Security** — Phases 5-6 (in progress)
+- 📋 **v2.0 Redesign** — Phases 7-10 (planned)
+
+## Phases
+
+<details>
+<summary>✅ v1.0 MVP (Phases 1-4) — SHIPPED YYYY-MM-DD</summary>
+
+- [x] Phase 1: Foundation (2/2 plans) — completed YYYY-MM-DD
+- [x] Phase 2: Authentication (2/2 plans) — completed YYYY-MM-DD
+- [x] Phase 3: Core Features (3/3 plans) — completed YYYY-MM-DD
+- [x] Phase 4: Polish (1/1 plan) — completed YYYY-MM-DD
+
+</details>
+
+### 🚧 v[Next] [Name] (In Progress / Planned)
+
+- [ ] Phase 5: [Name] ([N] plans)
+- [ ] Phase 6: [Name] ([N] plans)
+
+## Progress
+
+| Phase             | Milestone | Plans Complete | Status      | Completed  |
+| ----------------- | --------- | -------------- | ----------- | ---------- |
+| 1. Foundation     | v1.0      | 2/2            | Complete    | YYYY-MM-DD |
+| 2. Authentication | v1.0      | 2/2            | Complete    | YYYY-MM-DD |
+| 3. Core Features  | v1.0      | 3/3            | Complete    | YYYY-MM-DD |
+| 4. Polish         | v1.0      | 1/1            | Complete    | YYYY-MM-DD |
+| 5. Security Audit | v1.1      | 0/1            | Not started | -          |
+| 6. Hardening      | v1.1      | 0/2            | Not started | -          |
+```
+
+</step>
+
+<step name="archive_milestone">
+
+**将归档委托给 specops-tools：**
+
+```bash
+ARCHIVE=$(node .opencode/bin/specops-tools.cjs milestone complete "v[X.Y]" --name "[Milestone Name]")
+```
+
+CLI 处理：
+- 创建 `.planning/milestones/` 目录
+- 将 ROADMAP.md 归档到 `milestones/v[X.Y]-ROADMAP.md`
+- 将 REQUIREMENTS.md 归档到 `milestones/v[X.Y]-REQUIREMENTS.md`，含归档头部
+- 如果存在审计文件则移动到 milestones
+- 创建/追加 MILESTONES.md 条目，含从 SUMMARY.md 文件提取的成就
+- 更新 STATE.md（状态、最后活动）
+
+从结果中提取：`version`、`date`、`phases`、`plans`、`tasks`、`accomplishments`、`archived`。
+
+验证：`✅ 里程碑已归档到 .planning/milestones/`
+
+**阶段归档（可选）：** 归档完成后，询问用户：
+
+AskUserQuestion(header="Archive Phases", question="将阶段目录归档到 milestones/?", options: "Yes — move to milestones/v[X.Y]-phases/" | "Skip — keep phases in place")
+
+如果「Yes」：将阶段目录移到里程碑归档：
+```bash
+mkdir -p .planning/milestones/v[X.Y]-phases
+# For each phase directory in .planning/phases/:
+mv .planning/phases/{phase-dir} .planning/milestones/v[X.Y]-phases/
+```
+验证：`✅ 阶段目录已归档到 .planning/milestones/v[X.Y]-phases/`
+
+如果「Skip」：阶段目录保留在 `.planning/phases/` 作为原始执行历史。稍后使用 `/specops:cleanup` 回溯归档。
+
+归档后，AI 仍需处理：
+- 使用里程碑分组重组 ROADMAP.md（需要判断力）
+- 完整的 PROJECT.md 演进审查（需要理解力）
+- 删除原始 ROADMAP.md 和 REQUIREMENTS.md
+- 这些没有完全委托，因为它们需要 AI 对内容的解读
+
+</step>
+
+<step name="reorganize_roadmap_and_delete_originals">
+
+在 `milestone complete` 完成归档后，使用里程碑分组重组 ROADMAP.md，然后删除原件：
+
+**重组 ROADMAP.md** — 对已完成的里程碑阶段进行分组：
+
+```markdown
+# Roadmap: [Project Name]
+
+## Milestones
+
+- ✅ **v1.0 MVP** — Phases 1-4 (shipped YYYY-MM-DD)
+- 🚧 **v1.1 Security** — Phases 5-6 (in progress)
+
+## Phases
+
+<details>
+<summary>✅ v1.0 MVP (Phases 1-4) — SHIPPED YYYY-MM-DD</summary>
+
+- [x] Phase 1: Foundation (2/2 plans) — completed YYYY-MM-DD
+- [x] Phase 2: Authentication (2/2 plans) — completed YYYY-MM-DD
+
+</details>
+```
+
+**然后删除原件：**
+
+```bash
+rm .planning/ROADMAP.md
+rm .planning/REQUIREMENTS.md
+```
+
+</step>
+
+<step name="write_retrospective">
+
+**追加到持续更新的回顾：**
+
+检查是否存在回顾文件：
+```bash
+ls .planning/RETROSPECTIVE.md 2>/dev/null
+```
+
+**如果存在：** 读取文件，在「## Cross-Milestone Trends」部分之前追加新里程碑部分。
+
+**如果不存在：** 使用 `.opencode/templates/retrospective.md` 模板创建。
+
+**收集回顾数据：**
+
+1. 从 SUMMARY.md 文件：提取关键交付物、一句话摘要、技术决策
+2. 从 VERIFICATION.md 文件：提取验证分数、发现的差距
+3. 从 UAT.md 文件：提取测试结果、发现的问题
+4. 从 git log：统计提交数、计算时间线
+5. 从里程碑工作中：反思什么有效、什么无效
+
+**编写里程碑部分：**
+
+```markdown
+## Milestone: v{version} — {name}
+
+**Shipped:** {date}
+**Phases:** {phase_count} | **Plans:** {plan_count}
+
+### 构建了什么
+{从 SUMMARY.md 一句话摘要提取}
+
+### 什么有效
+{导致顺利执行的模式}
+
+### 什么低效
+{错过的机会、返工、瓶颈}
+
+### 建立的模式
+{此里程碑期间发现的新约定}
+
+### 关键教训
+{具体、可操作的收获}
+
+### 成本观察
+- 模型混合：{X}% opus，{Y}% sonnet，{Z}% haiku
+- 会话数：{count}
+- 值得注意的：{效率观察}
+```
+
+**更新跨里程碑趋势：**
+
+如果「## Cross-Milestone Trends」部分存在，用此里程碑的新数据更新表格。
+
+**提交：**
+```bash
+node .opencode/bin/specops-tools.cjs commit "docs: update retrospective for v${VERSION}" --files .planning/RETROSPECTIVE.md
+```
+
+</step>
+
+<step name="update_state">
+
+大部分 STATE.md 更新已由 `milestone complete` 处理，但验证并更新剩余字段：
+
+**项目引用：**
+
+```markdown
+## Project Reference
+
+See: .planning/PROJECT.md (updated [today])
+
+**Core value:** [Current core value from PROJECT.md]
+**Current focus:** [Next milestone or "Planning next milestone"]
+```
+
+**累积上下文：**
+- 清除决策摘要（完整日志在 PROJECT.md 中）
+- 清除已解决的阻塞项
+- 保留下一个里程碑的未解决阻塞项
+
+</step>
+
+<step name="handle_branches">
+
+检查分支策略并提供合并选项。
+
+使用 `init milestone-op` 获取上下文，或直接加载配置：
+
+```bash
+INIT=$(node .opencode/bin/specops-tools.cjs init execute-phase "1")
+```
+
+从 init JSON 中提取 `branching_strategy`、`phase_branch_template`、`milestone_branch_template` 和 `commit_docs`。
+
+**如果 "none"：** 跳到 git_tag。
+
+**对于 "phase" 策略：**
+
+```bash
+BRANCH_PREFIX=$(echo "$PHASE_BRANCH_TEMPLATE" | sed 's/{.*//')
+PHASE_BRANCHES=$(git branch --list "${BRANCH_PREFIX}*" 2>/dev/null | sed 's/^\*//' | tr -d ' ')
+```
+
+**对于 "milestone" 策略：**
+
+```bash
+BRANCH_PREFIX=$(echo "$MILESTONE_BRANCH_TEMPLATE" | sed 's/{.*//')
+MILESTONE_BRANCH=$(git branch --list "${BRANCH_PREFIX}*" 2>/dev/null | sed 's/^\*//' | tr -d ' ' | head -1)
+```
+
+**如果没有找到分支：** 跳到 git_tag。
+
+**如果存在分支：**
+
+```
+## 检测到 Git 分支
+
+分支策略：{phase/milestone}
+分支：{list}
+
+选项：
+1. **合并到 main** — 将分支合并到 main
+2. **不合并直接删除** — 已合并或不需要
+3. **保留分支** — 留待手动处理
+```
+
+AskUserQuestion，选项：Squash 合并（推荐）、保留历史合并、不合并直接删除、保留分支。
+
+**Squash 合并：**
+
+```bash
+CURRENT_BRANCH=$(git branch --show-current)
+git checkout main
+
+if [ "$BRANCHING_STRATEGY" = "phase" ]; then
+  for branch in $PHASE_BRANCHES; do
+    git merge --squash "$branch"
+    # Strip .planning/ from staging if commit_docs is false
+    if [ "$COMMIT_DOCS" = "false" ]; then
+      git reset HEAD .planning/ 2>/dev/null || true
+    fi
+    git commit -m "feat: $branch for v[X.Y]"
+  done
+fi
+
+if [ "$BRANCHING_STRATEGY" = "milestone" ]; then
+  git merge --squash "$MILESTONE_BRANCH"
+  # Strip .planning/ from staging if commit_docs is false
+  if [ "$COMMIT_DOCS" = "false" ]; then
+    git reset HEAD .planning/ 2>/dev/null || true
+  fi
+  git commit -m "feat: $MILESTONE_BRANCH for v[X.Y]"
+fi
+
+git checkout "$CURRENT_BRANCH"
+```
+
+**保留历史合并：**
+
+```bash
+CURRENT_BRANCH=$(git branch --show-current)
+git checkout main
+
+if [ "$BRANCHING_STRATEGY" = "phase" ]; then
+  for branch in $PHASE_BRANCHES; do
+    git merge --no-ff --no-commit "$branch"
+    # Strip .planning/ from staging if commit_docs is false
+    if [ "$COMMIT_DOCS" = "false" ]; then
+      git reset HEAD .planning/ 2>/dev/null || true
+    fi
+    git commit -m "Merge branch '$branch' for v[X.Y]"
+  done
+fi
+
+if [ "$BRANCHING_STRATEGY" = "milestone" ]; then
+  git merge --no-ff --no-commit "$MILESTONE_BRANCH"
+  # Strip .planning/ from staging if commit_docs is false
+  if [ "$COMMIT_DOCS" = "false" ]; then
+    git reset HEAD .planning/ 2>/dev/null || true
+  fi
+  git commit -m "Merge branch '$MILESTONE_BRANCH' for v[X.Y]"
+fi
+
+git checkout "$CURRENT_BRANCH"
+```
+
+**不合并直接删除：**
+
+```bash
+if [ "$BRANCHING_STRATEGY" = "phase" ]; then
+  for branch in $PHASE_BRANCHES; do
+    git branch -d "$branch" 2>/dev/null || git branch -D "$branch"
+  done
+fi
+
+if [ "$BRANCHING_STRATEGY" = "milestone" ]; then
+  git branch -d "$MILESTONE_BRANCH" 2>/dev/null || git branch -D "$MILESTONE_BRANCH"
+fi
+```
+
+**保留分支：** 报告「分支已保留，待手动处理」
+
+</step>
+
+<step name="git_tag">
+
+创建 git tag：
+
+```bash
+git tag -a v[X.Y] -m "v[X.Y] [Name]
+
+Delivered: [One sentence]
+
+Key accomplishments:
+- [Item 1]
+- [Item 2]
+- [Item 3]
+
+See .planning/MILESTONES.md for full details."
+```
+
+确认："Tagged: v[X.Y]"
+
+询问："推送 tag 到远程？(y/n)"
+
+如果 yes：
+```bash
+git push origin v[X.Y]
+```
+
+</step>
+
+<step name="git_commit_milestone">
+
+提交里程碑完成。
+
+```bash
+node .opencode/bin/specops-tools.cjs commit "chore: complete v[X.Y] milestone" --files .planning/milestones/v[X.Y]-ROADMAP.md .planning/milestones/v[X.Y]-REQUIREMENTS.md .planning/milestones/v[X.Y]-MILESTONE-AUDIT.md .planning/MILESTONES.md .planning/PROJECT.md .planning/STATE.md
+```
+```
+
+确认："Committed: chore: complete v[X.Y] milestone"
+
+</step>
+
+<step name="offer_next">
+
+```
+✅ 里程碑 v[X.Y] [Name] 完成
+
+已发布：
+- [N] 个阶段（[M] 个计划，[P] 个任务）
+- [一句话描述发布内容]
+
+已归档：
+- milestones/v[X.Y]-ROADMAP.md
+- milestones/v[X.Y]-REQUIREMENTS.md
+
+摘要：.planning/MILESTONES.md
+Tag：v[X.Y]
+
+---
+
+## ▶ 下一步
+
+**开始下一个里程碑** — 提问 → 研究 → 需求 → 路线图
+
+`/specops:new-milestone`
+
+<sub>`/clear` 先清理 → 全新上下文窗口</sub>
+
+---
+```
+
+</step>
+
+</process>
+
+<milestone_naming>
+
+**版本约定：**
+- **v1.0** — 初始 MVP
+- **v1.1、v1.2** — 小更新、新功能、修复
+- **v2.0、v3.0** — 大重写、破坏性变更、新方向
+
+**名称：** 简短 1-2 个词（v1.0 MVP、v1.1 Security、v1.2 Performance、v2.0 Redesign）。
+
+</milestone_naming>
+
+<what_qualifies>
+
+**创建里程碑的场景：** 初始发布、公开发布、主要功能集发布、归档规划前。
+
+**不创建里程碑的场景：** 每个阶段完成时（太细粒度）、进行中的工作、内部开发迭代（除非真正发布）。
+
+启发式：「这是否已部署/可用/已发布？」如果是 → 里程碑。如果不是 → 继续工作。
+
+</what_qualifies>
+
+<success_criteria>
+
+里程碑完成成功的条件：
+
+- [ ] MILESTONES.md 条目已创建，含统计和成就
+- [ ] PROJECT.md 完整演进审查已完成
+- [ ] 所有已发布需求在 PROJECT.md 中移至已验证
+- [ ] 关键决策已更新，含结果
+- [ ] ROADMAP.md 已使用里程碑分组重组
+- [ ] 路线图归档已创建（milestones/v[X.Y]-ROADMAP.md）
+- [ ] 需求归档已创建（milestones/v[X.Y]-REQUIREMENTS.md）
+- [ ] REQUIREMENTS.md 已删除（下一个里程碑全新开始）
+- [ ] STATE.md 已更新，含全新的项目引用
+- [ ] Git tag 已创建（v[X.Y]）
+- [ ] 里程碑提交已完成（含归档文件和删除）
+- [ ] 已对照 REQUIREMENTS.md 可追溯表检查需求完成情况
+- [ ] 不完整需求已展示，含继续/审计/中止选项
+- [ ] 如果用户在需求不完整时选择继续，已知差距已记录在 MILESTONES.md 中
+- [ ] RETROSPECTIVE.md 已更新，含里程碑部分
+- [ ] 跨里程碑趋势已更新
+- [ ] 用户知道下一步（/specops:new-milestone）
+
+</success_criteria>