用途:为重要技术决策产出结构化 Architecture Decision Record(ADR),记录背景、方案、取舍与理由,避免团队日后反复争论已定事项。适用场景包括技术/框架/平台选型、自建与采购(build vs buy)评估、架构模式选择(单体与微服务、事件驱动与请求响应等)、基础设施决策(云厂商、数据库、消息系统),以及任何跨团队、难以回退或日后易被质疑的技术决策。
主要能力与流程:技能按步骤引导。先明确决策的一句话描述、重要性、约束(时间线、预算、团队技能、合规、既有系统)、干系人,以及至少两个、理想三到四个备选方案。再依据 references/adr-template.md 模板组织 ADR。分析原则包括:先列决策驱动因素再评估方案;平等呈现每个方案的优缺点,包括推荐方案;量化取舍(美元成本、毫秒延迟、周为单位的迁移工作量),避免无指标的“更好/更差”;承认不确定性;明确决策是可逆还是单向门。推荐部分需包含决定、理由、接受的取舍、重新审视的条件。后果部分需列出正负影响、后续行动,以及涉及监管或安全时的合规说明。最终以 Markdown 文档输出,篇幅约 2–5 页,要求自包含、技术语言精确,使半年后新加入的高级工程师无需额外背景即可理解。
限制:资料未提供安装命令、独立运行方式或收费信息;具体执行依赖模板文件 references/adr-template.md,需用户提供决策相关信息以完成第 1 步的输入收集。