文档与数据 · 深度资料

Create Architectural Decision Record Skill

Create Architectural Decision Record 是 GitHub Awesome Copilot 用于沉淀架构决策的模板。

最适合

记录关键技术选择的架构团队

可以得到

收集必填信息、编写标准 ADR

主要局限

固定模板不能保证决策证据完整或正确。

首要风险

未经审阅的决策被当作定案: 生成的 ADR 默认为 Proposed,也可能包含推断的相关方或理由;接受前应由负责人审阅,并在写入前核对下一个编号。

证据新鲜度

三类检查,分别说明

近期核对过来源,不等于已经运行测试或完成安全审计。

上游来源核对于 2026-09-24

已固定提交 · 1f564408

打开固定提交 ↗
SkillSignal 资料编辑元数据

更新于 2026-09-24

运行与安全尚未独立验证

来源审阅不能证明实际行为或安全性。

用人话说明

它能做什么,以及什么时候值得选

Create Architectural Decision Record 是 GitHub Awesome Copilot 用于沉淀架构决策的模板。它以稳定 Markdown 结构记录背景、最终决策、正负影响、被拒方案、实施说明、相关方与参考资料。

这款 Skill 主要面向记录关键技术选择的架构团队。请对照下方的典型用法判断它是否适合当前任务,并在安装前核对限制、权限和风险。

你会得到什么
  • 收集必填信息确认背景、决策、备选方案和相关方。
  • 编写标准 ADR生成带编号的元数据和编码化影响章节。
  • 保留被拒方案记录备选方案未被选择的原因以及未来可能改变的条件。
它的特点
  • 生成稳定且便于机器读取的决策记录。
  • 同时要求收益与代价,而非只记录获选方案。
社区信号暂无已标注的第三方评价

当前数据中没有可验证的评论文字;最新讨论请查看下方来源。

查看来源说明 ↗

按 Agent 安装

选择你的 Agent

路径来自 Agent 官方文档或 skills.sh 同源通用安装器。兼容状态仍以这个 Skill 的资料为准。

原生支持

该 Skill 的当前资料明确列出了此 Agent。仍应先检查脚本、权限与外部依赖。

项目安装(推荐)
npx skills add github/awesome-copilot --skill create-architectural-decision-record --agent github-copilot
个人安装
npx 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/
Agent 官方文档

Copilot 在项目中也接受 .github/skills 与 .claude/skills;启用脚本前应先预览不可信 Skill。

查看路径依据 ↗

典型工作流

从任务到结果的典型流程

01

收集必填信息

确认背景、决策、备选方案和相关方。

02

编写标准 ADR

生成带编号的元数据和编码化影响章节。

03

保留被拒方案

记录备选方案未被选择的原因以及未来可能改变的条件。

优点与局限

优点与使用边界

显著优点

  1. 生成稳定且便于机器读取的决策记录。
  2. 同时要求收益与代价,而非只记录获选方案。

潜在缺点与局限

  1. 固定模板不能保证决策证据完整或正确。
  2. 该流程写入 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 核对来源,但这不等于运行测试或安全认证。首先检查“未经审阅的决策被当作定案”风险,并按最小权限试用。

软件包内容

已收录文件

SKILL.md上游软件包内容来源可查

标签

ADR架构文档

SkillSignal 原创编辑资料,依据 GitHub Awesome Copilot 固定提交 d7e4ad98 整理,核对日期 2026-09-23;未进行独立运行或安全认证。