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