cx-summary: 闭环与汇总

只负责收尾，不参与执行态主控。

先阅读：

• ${CLAUDE_PLUGIN_ROOT}/core/workflow/README.md
• ${CLAUDE_PLUGIN_ROOT}/core/workflow/protocols/summary.md

使用方法

/cx:cx-summary
/cx:cx-summary {功能名}

强制规则

所有文件读写必须使用绝对路径。 禁止使用 ../ 相对路径。先用 git rev-parse --show-toplevel 获取绝对路径。

运行原则

• feature 完成后再进入 summary
• cx:summary 不负责补救执行问题
• GitHub 为同步镜像，项目级 开发文档/CX工作流 + .cx 才是真相
• 这是 Claude Code 侧的 cc adapter 收尾动作，不会擅自改写其他 runner 的 lease
• 允许在用户明确确认“开始收尾”后，由工作流自动衔接到本 skill

核心步骤

Step 0: 读取闭环输入

• 当前 feature 的 状态.json
• 需求.md / 设计.md / 架构决策.md / 总结.md
• 本轮相关 git commits

Step 1: 可选代码审查

如果 code_review=true，必须（MUST） 使用 AskUserQuestion 工具询问：

{
  "questions": [
    {
      "question": "闭环前做代码审查吗？",
      "header": "Code Review",
      "multiSelect": false,
      "options": [
        {
          "label": "全面审查 (Recommended)",
          "description": "完整检查代码质量、契约一致性和测试覆盖"
        },
        {
          "label": "快速审查",
          "description": "只检查关键路径和明显问题"
        },
        {
          "label": "跳过",
          "description": "直接进入总结阶段"
        }
      ]
    }
  ]
}

这一步是闭环前检查，不是执行期主控。

Step 2: 生成总结文档

优先调用共享 runner：

bash ${CLAUDE_PLUGIN_ROOT}/scripts/cx-workflow-summary.sh \
  --feature <feature-slug> \
  --runner cc \
  --session-id <session-id>

输出到：

开发文档/CX工作流/功能/{功能标题}/总结.md

总结只回答这些问题：

• 做了什么
• 关键契约或设计有没有调整
• 最终交付和验证结果是什么

Step 3: 同步 GitHub 镜像

根据 github_sync 决定是否同步：

• off：只保留本地
• local：轻量同步结果
• collab / full：同步关键文档和闭环结果

但无论哪种模式，GitHub 都不是执行真相源。

Step 4: 分支合并与工作区清理

检查 feature 的 状态.json 中的 worktree.isolation_mode：

如果 isolation_mode = "worktree"（独立工作区）：

必须（MUST） 使用 AskUserQuestion 工具询问合并方式：

{
  "questions": [
    {
      "question": "功能「{feature_title}」已完成，如何合并回主分支？",
      "header": "合并方式",
      "multiSelect": false,
      "options": [
        {
          "label": "创建 Pull Request (Recommended)",
          "description": "推送分支并创建 PR，适合需要 review 的场景"
        },
        {
          "label": "直接合并到主分支",
          "description": "将 worktree 分支合并回主分支并清理"
        },
        {
          "label": "暂不合并",
          "description": "保留工作区和分支，稍后手动处理"
        }
      ]
    }
  ]
}

选项 1（创建 PR）：

git push -u origin worktree-{feature-slug}
gh pr create --title "feat: {feature_title}" --body "..."

选项 2（直接合并）：

# 先退出 worktree 回到主目录
ExitWorktree(save: true)
# 在主分支合并
git merge worktree-{feature-slug}
# 清理 worktree 分支
git branch -d worktree-{feature-slug}

选项 3（暂不合并）：

• 保留 worktree 和分支
• 提示用户后续可以通过 git worktree list 查看

如果 isolation_mode = "inline"（当前分支直接开发）：

• 跳过合并步骤，代码已在当前分支上

Step 4.5: 分支整合（Worktree 模式）

如果当前在 feature worktree 中（非 inline 模式），summary 完成后提供整合选项：

使用 AskUserQuestion：

{
  "questions": [{
    "question": "所有任务已完成，如何处理这个 feature 分支？",
    "header": "分支整合",
    "multiSelect": false,
    "options": [
      { "label": "Merge 回主分支", "description": "合并后删除分支和 worktree" },
      { "label": "Push + 创建 Pull Request", "description": "推送到远程，创建 PR 供审查" },
      { "label": "保留分支（稍后处理）", "description": "保持 worktree 和分支不变" },
      { "label": "丢弃（需确认）", "description": "删除分支和 worktree，放弃所有改动" }
    ]
  }]
}

选项 1 — Merge：

git checkout main && git pull && git merge {feature-branch}
# 验证测试通过后
bash ${CLAUDE_PLUGIN_ROOT}/scripts/cx-worktree.sh cleanup --feature {slug}
git branch -d {feature-branch}

选项 2 — PR：

git push -u origin {feature-branch}
gh pr create --title "{feature-title}" --body "..."

选项 3 — 保留： 不执行任何操作。

选项 4 — 丢弃： 使用 AskUserQuestion 二次确认后：

bash ${CLAUDE_PLUGIN_ROOT}/scripts/cx-worktree.sh cleanup --feature {slug} --force
git branch -D {feature-branch}

Step 5: 收尾状态

闭环完成后：

• feature 状态更新为 summarized
• 配置.json.current_feature 清空
• 历史 feature 文档完整保留
• 如果使用了独立工作区且已合并，worktree 信息标记为 merged