m19803261706 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 侧的
ccadapter 收尾动作，不会擅自改写其他 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