用途:cx-adr 为少数高影响设计决策留一份短而清楚的取舍记录,通常由 cx-design 自动调用,也可在用户确认需要 ADR 后由工作流衔接。
触发边界:仅在 L 规模 feature、引入新技术或基础设施、存储/通信/缓存/同步方案存在明显 trade-off、回退成本高且影响面大的架构决定时建议写 ADR;普通实现细节不应滥用。若没有明确架构决策,不要为流程完整而硬写。
使用方式:命令为 /cx:cx-adr {决策标题} 或 /cx:cx-adr。
核心步骤:先定位文档目录,使用 PROJECT_ROOT=$(git rev-parse --show-toplevel),CX_DIR="$PROJECT_ROOT/开发文档/CX工作流",FEATURE_DIR="$CX_DIR/功能/$FEATURE_TITLE",ADR_FILE="$FEATURE_DIR/架构决策.md";再收集决策上下文,包括要解决的问题、候选方案及各自收益、成本、风险和回退难度;随后关联同目录下已有的需求.md 与设计.md;生成只含背景、候选方案、选择结果、影响范围、回退策略的短决策记录;最后在 feature 的 状态.json 中补充 docs 字段,关联 prd、design、adr。
限制:Claude Code 侧写 ADR 只是在共享 core 上补充文档,不改变其他 runner 的 lease。其他平台、收费与效果信息暂未提供。