adr-drafting 是撰写新架构决策记录的 Skill。ADR 记录为什么作出一个重要技术选择,包含背景、决定、状态和后果,方便以后理解取舍。
写“改用某数据库”还不够,要说明原问题、约束与为什么选它,也留成本、维护或迁移方面的新负担。没有依据的收益和理由不能由模板补出来。
它先查仓库已有位置、编号和语言;默认目录只在没有惯例时使用。未定方案保持提议状态,文件存在不代表决定获准,更不代表系统已迁移。
适合已经有方向、需要保存理由的单项决定。这份技能只写新记录,旧状态和替代链另需流程;详细模板引用未展开,本文未创建真实 ADR,也不从目标审批阶段给这次文章增加确认步骤。