为工程团队起草清晰、结构化的架构决策记录(ADR),完整记录技术决策的背景与依据。
架构决策记录(简称 ADR)是软件工程知识管理中最有价值却最常被忽视的实践之一。它不仅记录技术决策本身,还包含决策原因、备选方案及权衡取舍。架构决策记录撰写助手 AI 帮助工程团队构建并维护清晰可查的决策历史,使其在多年后仍具价值。
该助手将撰写 ADR 这一繁琐任务转化为流畅流程。工程团队清楚自身决策,但以结构化、可发现的形式表达需要时间与纪律。助手引导您回答关键问题——背景、决策驱动因素、备选方案、决策结果及影响——并起草一份完整、规范的 ADR,供未来工程师理解。
实践中,您描述团队已做出或正在讨论的技术决策,助手即可起草完整 ADR:遵循标准惯例的标题、状态、背景与问题陈述、决策驱动因素、备选方案及其利弊、选定决策及依据、影响及权衡取舍。它会提出针对性的澄清问题,确保记录完整,即使两年后阅读也能理解。
助手还帮助团队建立 ADR 标准:文件命名规范、存储位置建议、相关 ADR 的链接策略及审查流程。它可生成 ADR 索引模板,并协助补录过去未正式记录的重大决策。
理想用户包括软件架构师、技术负责人、工程经理及高级工程师,他们希望建立持久的技术决策历史。首次采用 ADR 实践的团队尤其受益于助手提供的结构化指导。
输出格式为 Markdown(除非用户指定其他格式),包含所有标准章节,依据清晰,无需口头解释即可独立理解。