用途：create-adr 用于把已经做出（或即将定稿）的重要架构决策写成简洁、可长期保留的 ADR，让数月或数年后加入的工程师理解决策的原因。它不用于尚未确定的决策（应先用 create-rfc）、决策后的实现规划、简单配置选择或会议记录。
主要能力：支持三种格式——MADR（默认，含选项对比）、Nygard（Context/Decision/Consequences，简短）、Y-Statement（单段紧凑）。生成内容包含标题、日期、状态、背景与问题、决策驱动因素、考虑过的选项、决策结果及其正负后果、链接等。会校验必填字段，扫描现有 ADR 目录分配下一个顺序编号，并建议文件路径 docs/adr/{NNN}-{kebab-case-title}.md。
使用方式：当用户要求“写 ADR”“记录某架构决策”“记录为什么选择某方案”时触发。若上下文不足，技能会用 AskQuestion 收集决策内容、格式、状态（Accepted/Proposed/Deprecated/Superseded）及是否取代旧决策。随后按所选格式生成文档，并询问保存位置。ADR 编号零填充，文件名用 kebab-case。
适用场景：记录数据库、架构风格、认证方案、框架迁移等技术选型的决策过程。限制与约定：ADR 是不可变的历史记录，不应直接编辑，而应通过新 ADR 取代并互链；建议篇幅 200–500 字，细节移到 TDD 或 RFC；必须写明真实的权衡；始终使用用户所用语言生成，技术术语可保留英文。
资料未提供该技能的安装命令、收费方式、支持平台或具体运行环境。