30 秒看懂
它能做什么，以及什么时候值得选
Create Architectural Decision Record 是 GitHub Awesome Copilot 用于沉淀架构决策的模板。它以稳定 Markdown 结构记录背景、最终决策、正负影响、被拒方案、实施说明、相关方与参考资料。
按 Agent 安装
选择你的 Agent
路径来自 Agent 官方文档或 skills.sh 同源通用安装器。兼容状态仍以这个 Skill 的资料为准。
项目范围
.agents/skills/create-architectural-decision-record/个人范围
~/.copilot/skills/create-architectural-decision-record/项目范围适合团队共享；个人范围适合跨项目复用。安装器默认项目范围，加 -g 可改为个人范围。
安装命令（项目范围）
npx skills add github/awesome-copilot --skill create-architectural-decision-record --agent github-copilot典型工作流
从任务到结果的典型流程
01
收集必填信息
确认背景、决策、备选方案和相关方。
02
编写标准 ADR
生成带编号的元数据和编码化影响章节。
03
保留被拒方案
记录备选方案未被选择的原因以及未来可能改变的条件。
优点与局限
优点与使用边界
显著优点
- 生成稳定且便于机器读取的决策记录。
- 同时要求收益与代价，而非只记录获选方案。
潜在缺点与局限
- 固定模板不能保证决策证据完整或正确。
- 该流程写入 Proposed 状态 ADR，但不管理审批、替代或治理。
适合人群
适合哪些人
→
记录关键技术选择的架构团队
→
需要可检索决策历史的仓库
使用前须知
使用前需要检查的风险
中
未经审阅的决策被当作定案
生成的 ADR 默认为 Proposed，也可能包含推断的相关方或理由；接受前应由负责人审阅，并在写入前核对下一个编号。
安全说明
如何理解它的权限
- 不要在广泛共享的 ADR 中嵌入凭证、私有架构图或可利用细节。
- 把状态改为 Accepted 前，应遵循仓库评审与所有权规则。
这不是安全认证。 第三方评级仅作为标注来源的参考信息展示；SkillSignal 尚未独立执行或安全审查此 Skill。
软件包内容
已收录文件
SKILL.md上游软件包内容来源可查
标签
ADR架构文档
SkillSignal 原创编辑资料，依据 GitHub Awesome Copilot 固定提交 318066d2 整理，核对日期 2026-08-20；未进行独立运行或安全认证。