用途:cx-fix 是 CX 工作流的 Bug 修复入口,用于处理报错、调试与修复类任务。默认采用快速修复路径,只有问题明显复杂时才升级为更重的调查。
主要能力与默认路径:调查复现、定位根因、最小修复、运行最相关验证、记录修复结论、提交代码。修复记录保存到“开发文档/CX工作流/修复/{问题标题}/修复记录.md”;若被阻塞,需在记录中写明已尝试内容、当前卡点、是否需要用户决策或外部信息。
使用方式:命令为 /cx:cx-fix {问题描述} 或 /cx:cx-fix。优先调用共享 runner:bash ${CLAUDE_PLUGIN_ROOT}/scripts/cx-workflow-fix.sh --title "<问题标题>" --runner cc --session-id <session-id>。执行前可检测 worktree:check_output=$(bash ${CLAUDE_PLUGIN_ROOT}/scripts/cx-worktree.sh check --inline --project-root "$(git rev-parse --show-toplevel)" 2>&1) || true。默认 inline 模式,不强制 worktree;小修复允许在当前分支直接修复,大修复(涉及多文件重构)建议创建 worktree 隔离。
强制规则:所有文件读写必须使用绝对路径,禁止使用 ../ 相对路径,先用 git rev-parse --show-toplevel 获取绝对路径。
升级条件:根因不明确需多假设并行调查、涉及多个模块或高风险兼容性、修复失败后出现连锁回归、需要结构化记录阻塞原因。
提交规范:fix(scope): description [cx-fix:<fix-slug>],例如 fix(liuyao): repair divine transaction path [cx-fix:liuyao-divine-500]。
限制与关系:这是 Claude Code 侧的 cc adapter 修复入口;若问题归属的 feature 已由 codex 持有,先提示 handoff 再决定是否继续。GitHub 只承担同步记录,不是修复主控,本地“开发文档/CX工作流/修复/”才是运行时真相。