@zhuan-ai/zhuanspec 2.11.11 → 2.11.12

package/dist/core/templates/slash-command-templates.js

@@ -527,12 +527,18 @@ const archiveSteps = `**前置检查**：
 
 **步骤**
 0. **检查知识库**：运行 \`rg "[关键词]" zhuanspec/knowledge/\` 搜索是否有需要沉淀的知识。阅读 \`zhuanspec/knowledge/index.md\` 了解项目级知识摘要。
-1. **确定变更 ID 并设置 Phase**：
+1. **切换 Phase 到 archive（第一步，必须立即执行）**：
    - 如果此提示已包含特定的变更 ID（例如在由斜杠命令参数填充的 \`<ChangeId>\` 块内），请在修剪空白后使用该值。
    - 如果对话中松散地引用了变更（例如通过标题或摘要），运行 \`zhuanspec list\` 以显示可能的 ID，分享相关候选，并确认用户意图是哪一个。
-   - 否则，审查对话，运行 \`zhuanspec list\`，并询问用户要归档哪个变更；在继续之前等待确认的变更 ID。
-   - 如果您仍然无法识别单个变更 ID，请停止并告诉用户您还无法归档任何内容。
-   - **Phase 设置**：运行 \`zhuanspec progress set-phase <change-id> archive\`
+   - 如果仍然无法识别单个变更 ID，请停止并告诉用户还无法归档任何内容。
+   - **必须立即运行**：\`zhuanspec progress set-phase <change-id> archive\`
+   - 执行后运行 \`zhuanspec progress show <change-id>\` 或 \`cat zhuanspec/changes/<change-id>/metrics/progress.json | jq '.phase'\` 确认 \`phase=archive\`
+   - ✅ 确认成功后才能进入下一步；❗ 未完成 Phase 切换前，禁止执行 \`zhuanspec archive\`
+
+   ⚠️ **CHECKPOINT [PHASE-SWITCHED-TO-ARCHIVE]**：
+   - \`progress.phase\` 必须从 \`review\` 变为 \`archive\`
+   - \`progress.phaseTransitions\` 必须新增一条 \`{from:'review', to:'archive'}\`
+   - \`progress.phaseDurations\` 必须关闭 review 段并开启 archive 段
 2. 通过运行 \`zhuanspec list\`（或 \`zhuanspec show <id>\`）验证变更 ID，如果变更缺失、已归档或尚未准备好归档，则停止。
 3. **验证 Review 门禁**：确认上述四个结果文件存在且全部通过。
 4. 运行 \`zhuanspec archive <id> --yes\`，以便 CLI 移动变更并应用规范更新，无需提示（仅对仅工具类工作使用 \`--skip-specs\`）。
@@ -603,10 +609,17 @@ const reviewGuardrails = `${baseGuardrails}\n- **门禁审查阶段**：review
 - **强制审查**：所有变更在归档前必须通过三轨门禁，确保代码质量、测试覆盖与 Spec-Code 一致性。
 - **Skill 触发要求**：必须触发 \`code-review-expert\`（代码审查轨）与 \`generate-mockito-unit-test\`（单测轨）。`;
 const reviewSteps = `**步骤**
-1. **确定变更 ID 并设置 Phase**：
-   - 如果此提示已包含特定的变更 ID，请使用该值
-   - 否则运行 \`zhuanspec list\` 显示活跃变更，并询问用户要审查哪个
-   - **Phase 设置**：运行 \`zhuanspec progress set-phase <change-id> review\`
+1. **切换 Phase 到 review（第一步，必须立即执行）**：
+   - 如果此提示已包含特定的变更 ID，请使用该值；否则运行 \`zhuanspec list\` 显示活跃变更并询问用户要审查哪个
+   - **必须立即运行**：\`zhuanspec progress set-phase <change-id> review\`
+   - 执行后运行 \`zhuanspec progress show <change-id>\` 或 \`cat zhuanspec/changes/<change-id>/metrics/progress.json | jq '.phase'\` 确认 \`phase=review\`
+   - ✅ 确认成功后才能进入下一步；❗ 未完成 Phase 切换前，禁止触发任何 skill 或运行 \`zhuanspec review\`
+
+   ⚠️ **CHECKPOINT [PHASE-SWITCHED-TO-REVIEW]**：
+   - \`progress.phase\` 必须从 \`apply\` 变为 \`review\`
+   - \`progress.phaseTransitions\` 必须新增一条 \`{from:'apply', to:'review'}\`
+   - \`progress.phaseDurations\` 必须关闭 apply 段并开启 review 段
+   - 三者任一缺失，说明 set-phase 未生效，必须排查后重试，禁止继续
 2. **执行三轨并行校验（强制）**：
    - **轨道 A：Code Review 轨**
      - 使用 Skill 工具调用 \`code-review-expert\` skill

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuan-ai/zhuanspec",
-  "version": "2.11.11",
+  "version": "2.11.12",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "zhuanspec",