核心用法
该 Skill 提供完整的 Architecture Decision Records（ADR）文档体系，包含五种模板格式（标准版、完整版、轻量版、Y-Statement 单句版、废弃声明版），覆盖技术决策的全生命周期。用户可通过复制模板快速创建结构化决策文档，记录「背景上下文→决策选项→权衡分析→后果评估」的完整链条。配套提供 adr-tools CLI 工具集成指南，支持自动生成编号、维护索引目录、处理废弃与替代关系。
典型使用场景包括：框架/语言选型、数据库技术决策、API 设计模式确定、安全架构设计、集成方案选择等难以逆转或需长期维护理解的关键技术决策。
显著优点
决策透明化：强制要求记录「决策背景」与「未选方案」，避免"历史原因"式的知识黑箱，新成员可通过阅读 ADR 快速理解系统现状。
知识资产化：将分散在邮件、会议、PR 评论中的决策依据固化为可检索文档，形成组织的 institutional memory。
流程标准化：提供从 Proposed→Accepted→Deprecated/Superseded 的状态流转规范，以及创建、评审、实施后的完整检查清单，降低文档质量波动。
工具链友好：与 adr-tools 等开源工具无缝衔接，支持自动生成目录、处理依赖关系，适合集成到 CI/CD 或文档站点。
潜在缺点与局限性
执行成本高：模板要求详尽记录选项对比与后果分析，对于节奏紧张的团队可能产生"文档负担"，轻量模板虽可缓解但信息完整性会牺牲。
时效性挑战：技术上下文持续变化，已接受的 ADR 可能逐渐过时，但规范禁止直接修改，需通过 Superseded 流程维护，可能产生文档冗余。
无原生协作功能：作为纯 Markdown 模板，不内置审批流、评论讨论或变更通知机制，需配合 Git 工作流或外部工具实现团队协作。
适用范围边界：明确不建议用于 Bug 修复、配置变更、代码格式化等可轻易逆转的决策，过度使用会导致文档泛滥。
适合的目标群体
- 技术负责人/架构师：需要为重大技术选型建立权威记录，向上向下解释决策依据
- 中大型工程团队：人员流动频繁，需要降低关键决策的 bus factor 风险
- 开源项目维护者：向社区透明披露技术路线选择，管理贡献者预期
- 合规敏感行业：金融、医疗等领域需审计追踪技术决策的变更历史
使用风险
性能风险：极低。纯静态 Markdown 文档，无运行时性能影响。
依赖风险：adr-tools 为可选外部依赖，Skill 本身零依赖，不会因工具链升级导致功能失效。
数据安全风险：无数据收集、无网络请求、无敏感信息处理，符合 GDPR/CCPA 要求。
维护风险：来源为 T3 级别个人开发者（wpank），虽当前版本安全可信，但长期维护承诺不明。建议关键业务场景 Fork 至组织内部仓库或确认维护者 roadmap。