用途:该技能用于在做出重要架构决策时编写 ADR(Architecture Decision Record),记录决策的背景与后果。适用时机包括选择框架或库、选用数据库或存储方案、定义 API 模式、确立编码规范、做出基础设施决策,以及任何影响多个组件的决策。
主要能力:提供 ADR 的标准结构,包括标题(简短描述决策的短语)、状态(Proposed 讨论中、Accepted 已决定、Rejected 已考虑但未采用、Deprecated 不再有效、Superseded 已被其他 ADR 取代)、背景(当前情况与影响因素)、决策(要做的变更)、理由(为何是最佳选择)、后果(正面与负面的权衡)。
使用方式:在决策当下编写,而非事后补写;记录被考虑的备选方案;按顺序编号,如 ADR-001、ADR-002;决策变更时更新状态,标记为 deprecated 或 superseded。
示例:资料给出以 PostgreSQL 作为主数据库的 ADR,列出需求(ACID 事务、JSON 支持、强生态、团队熟悉度)、决策(采用 PostgreSQL 15+)、理由(成熟可靠、JSONB、扩展生态如 pgvector/PostGIS、团队经验、云厂商支持)与后果(正面:可靠、功能丰富、易招人;负面:纵向扩展受限、需谨慎管理连接、运维开销高于托管 NoSQL)。
限制:保持简短,最多 1-2 页;该页面未提供安装命令、代码、平台或收费信息。