adr-writer

adr-writer 技能是软件工程师与架构师的结构化助手，旨在维护储存库中的高质量技术文档。通过严格遵守「Design It!」方法论，此工具协助建立架构决策记录 (ADR)，解释关键技术决策背后的动机，确保团队知识得以长期保存，并在代码审查或系统重构期间使决策易于追溯。它提供包含状态跟踪、情境分析、具体决策陈述以及正反面影响评估的标准化模板，协助团队避免架构漂移并提升决策透明度。

• 提供 ADR 的预先配置 Markdown 模板，确保包含所有必要章节（状态、情境、决策、结果）。

• 引导用户完成架构决策生命周期，从草稿 (Draft)、提案 (Proposed) 到已接受 (Accepted)、已取代 (Superseded) 或已弃用 (Deprecated) 的状态。

• 协助根据既定标准判断特定技术变更是否构成架构决策。

• 鼓励落实最佳实践，例如保持 ADR 专注、简短（1-2 页），并与版本控制的源代码共置。

• 提供明确的协议以将决策标记为「已取代」而非直接删除，促进存档流程。

• 用户输入其架构变更的标题与范畴，即可获得格式化的 ADR 草稿。

• 非常适合用于新功能设计阶段、系统迁移，或是当需要共识来应对复杂技术挑战时。

• 最佳实践建议将这些文件储存在特定目录（例如 docs/adr/）中，以确保它们能与相关代码库一起被轻易发现。

• 产出物应被视为代码，这意味着在标记为「已接受」之前，应经过同行评审与 PR 流程。

• 坚持「一个文件一个决策」的原则，以维持不断发展的软件架构中的清晰度与维护便利性。