用途:cx-summary 是 CX 工作流的闭环与汇总环节,在功能完成后手动触发或由工作流衔接进入,负责生成总结文档、同步 GitHub 镜像、处理分支合并与清理当前 feature 指针。它只做收尾,不参与执行态主控,也不负责补救执行问题。
主要能力:读取当前 feature 的状态.json、需求.md、设计.md、架构决策.md、总结.md 及本轮 git commits;可选代码审查;生成总结文档;按 github_sync 配置同步 GitHub 镜像;根据 worktree.isolation_mode 处理分支合并与工作区清理;将 feature 状态更新为 summarized 并清空配置.json.current_feature。
使用方式:命令为 /cx:cx-summary 或 /cx:cx-summary {功能名}。使用前需阅读 ${CLAUDE_PLUGIN_ROOT}/core/workflow/README.md 与 ${CLAUDE_PLUGIN_ROOT}/core/workflow/protocols/summary.md。生成总结优先调用共享 runner:bash ${CLAUDE_PLUGIN_ROOT}/scripts/cx-workflow-summary.sh --feature <feature-slug> --runner cc --session-id <session-id>,输出到 开发文档/CX工作流/功能/{功能标题}/总结.md。
限制:所有文件读写必须使用绝对路径,禁止 ../ 相对路径,先用 git rev-parse --show-toplevel 获取绝对路径。feature 完成后才能进入 summary。GitHub 为同步镜像,项目级 开发文档/CX工作流 + .cx 才是真相源。这是 Claude Code 侧 cc adapter 的收尾动作,不会擅自改写其他 runner 的 lease。worktree 模式下合并方式需通过 AskUserQuestion 确认,丢弃分支需二次确认。