Menu
CX 工作流 — 架构决策记录。当用户提到"架构决策"、"技术选型"、 "ADR"、"为什么选择 X"、"架构方案对比"时可能触发（通常由 cx-design 自动调用）。 仅在 L 规模或重大架构取舍出现时记录，保存到本地 开发文档/CX工作流/功能/{feature_title}/架构决策.md。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
CX 工作流 — 配置管理。查看或修改项目级 `开发文档/CX工作流/配置.json` 中公开的少量字段。仅在用户明确调用 `/cx:cx-config` 时执行。
CX 工作流 — Bug 修复。当用户提到"修 bug"、"fix"、"报错"、"debug"、 "修复"时触发。默认走快速修复路径，复杂问题再升级为更深入的调查。
CX 工作流 — 项目初始化。每个项目都单独确认 developer_id、GitHub 同步策略、 agent teams、code review、worktree isolation、auto memory，并建立项目级 `开发文档/CX工作流 + .cx` 运行时真相目录。仅在用户明确调用 `/cx:cx-init` 时执行。
CX 工作流 — 需求收集与规模评估。当用户提到"新功能"、"需求"、"PRD"、 "我想做一个"、"帮我规划"、"收集需求"、"功能规划"时触发。 多轮对话收集需求，自动评估规模，保存到本地 开发文档/CX工作流/功能/{feature_title}/需求.md，并自动判断是否需要 Design。
CX 工作流 — 项目蓝图探讨。当用户提到"蓝图"、"整体规划"、"项目范围"、 "scope"、"项目探讨"、"功能方案"时触发。多轮对话探讨项目或功能方案， 将结果保存到本地 `开发文档/CX工作流/功能/{功能标题}/范围.md`， 可选同步到 GitHub Issue（基于 config.github_sync 模式）。
Codex 侧 CX 架构决策记录。沉淀设计取舍，不改变 lease 与 worktree 持有关系。
| name | cx-adr |
| description | CX 工作流 — 架构决策记录。当用户提到"架构决策"、"技术选型"、 "ADR"、"为什么选择 X"、"架构方案对比"时可能触发（通常由 cx-design 自动调用）。 仅在 L 规模或重大架构取舍出现时记录，保存到本地 开发文档/CX工作流/功能/{feature_title}/架构决策.md。 |
为少数高影响设计决策留一份短而清楚的取舍记录。
/cx:cx-adr {决策标题}
/cx:cx-adr
以下情况才建议写 ADR：
普通实现细节不要滥用 ADR。 Claude Code 侧写 ADR 时仍然只是在共享 core 上补充文档，不改变其他 runner 的 lease。 允许在用户明确确认需要 ADR 后，由工作流自动衔接到本 skill。
PROJECT_ROOT=$(git rev-parse --show-toplevel)
CX_DIR="$PROJECT_ROOT/开发文档/CX工作流"
FEATURE_TITLE="{功能标题}"
FEATURE_DIR="$CX_DIR/功能/$FEATURE_TITLE"
ADR_FILE="$FEATURE_DIR/架构决策.md"
默认关联同目录下已有文档：
需求.md设计.mdADR 只保留这些核心内容：
在 feature 的 状态.json 中补上：
{
"docs": {
"prd": "需求.md",
"design": "设计.md",
"adr": "架构决策.md"
}
}
如果没有明确架构决策，不要为了流程完整而硬写一份 ADR。