用途:该技能用于在用户项目中快速搭建一份架构决策记录(ADR),文件写入 docs/adr/NNNN-<slug>.md。ADR 是对跨平台级承诺的不可变记录,覆盖仓库选型、建模约定、PII 处理模式、治理姿态、摄取框架、调度器选择等。它与按干系人需求记录的 DGQ 在范围和生命周期上不同:ADR 面向平台全局,且被后续 ADR 取代而非原地修改。
主要能力:格式为 MADR-lite,包含 Context、Decision Drivers、Considered Options、Decision、Consequences 五个部分。技能自带 ADR 契约(references/adr.md)和结构校验脚本(scripts/lint-adr.sh)。若 docs/adr/ 不存在则创建;扫描 NNNN-*.md 取最大编号加一,零填充四位,无文件则从 0001 开始。
使用方式:按顺序逐项收集标题、五个章节、状态与日期,状态默认 proposed,可询问是否标记为 accepted,日期写 YYYY-MM-DD。标题需主动语态并生成 kebab-case 短名,写入前确认 NNNN-<slug>.md。写完后运行校验脚本,可从项目根目录调用并支持 ADR_ROOT=<dir> 指定目录;脚本缺失时静默跳过。最后打印文件路径、编号和状态。
硬性规则:若 Considered Options 少于两项则拒绝写文件,并明确提示用户(ADR 只有一个选项就构不成决策)。
限制:不写 superseded-by-NNNN(该值日后由取代它的 ADR 设置)。适用于已权衡过决策、需要落盘的场景;若需要追问上游需求,应改用 /gather-requirements。本技能不进行需求访谈。