用途:cx-design 是 CX 工作流中的技术设计环节,当用户提到技术设计、Design Doc、API 设计、接口设计、架构设计、系统设计时触发。它读取 PRD 生成设计文档,把中大 feature 的关键决策、接口契约和测试重点先锁住,再进入任务规划。该步骤只服务中大 feature,S 规模默认跳过。
主要能力:设计文档作为执行契约而非长篇论文,最少包含架构边界与模块拆分、API 接口契约、状态枚举对照表、VO/DTO 字段映射、风险点与测试重点等章节。生成前会读取需求.md,扫描相邻模块、接口约定、DTO/VO、状态枚举,找出可复用代码与必须变更的边界。
使用方式:命令为 /cx:cx-design {功能名} 或 /cx:cx-design。执行前需先阅读 core/workflow/README.md 与 core/workflow/protocols/design.md。所有文件读写必须使用绝对路径,禁止使用 ../ 相对路径,先用 git rev-parse --show-toplevel 获取绝对路径。执行前强制检测 worktree,若返回 on_main=true,需提示用户先运行 /cx:cx-prd 创建 worktree 或手动进入已有 worktree,并用 AskUserQuestion 列出可用 worktree 供选择,不继续执行设计阶段。写入时优先调用共享 runner:bash ${CLAUDE_PLUGIN_ROOT}/scripts/cx-workflow-design.sh --feature <feature-slug> --runner cc --session-id <session-id>,写入开发文档/CX工作流/功能/{功能标题}/设计.md,并把 feature 状态推进到可规划阶段。
适用场景与限制:适用于中大 feature 的技术设计阶段,内部关联始终使用 slug,目录展示使用中文标题。高风险内容如接口路径与响应结构、数据库或状态模型变更、兼容性和迁移风险需用勾选问答确认,普通实现细节不需频繁打断。Claude Code 是共享 cx core 上的 cc adapter,不能绕过租约直接覆盖其他 runner 的 feature。仅在明显引入新技术、存储或通信方案存在实质性取舍、重大架构调整、可逆成本或回退成本很高时,才建议进入 /cx:cx-adr。其他收费、平台与效果信息暂未提供。