‹ 首页

architecture-decision

@pixel-cellar · 收录于 5 天前 · 上游提交 4 个月前

创建架构决策记录(Architecture Decision Record, ADR),记录重大技术决策及其背景、备选方案和影响后果。每个重大技术选择都应有对应的 ADR。

适合你,如果团队需要系统化记录重大技术决策及其理由。

/ 通过 npx 安装 校验哈希
npx oh-my-skill add pixel-cellar/claude-code-game-studios/architecture-decision
/ 通过 bash 安装
curl -fsSL https://oh-my-skill.com/install.sh | bash -s -- pixel-cellar/claude-code-game-studios/architecture-decision
/ 已经装过?验证本机副本,不用重装
npx oh-my-skill verify pixel-cellar/claude-code-game-studios/architecture-decision
安装目标可用 --agent / --scope 或 --to 明确指定;省略时只会在唯一已存在的 agent 目录上自动选择,零命中或多命中会停止并提示。content_hash 缺失或不一致均拒装。
273GitHub stars
~729上下文体积 · 单文件
索引托管

怎么用

商店整理自技能原文 · 版本 2c016ef · 表述以原文为准
它做什么

当你要求记录技术决策时,Claude会自动生成一份标准格式的架构决策记录(ADR),包含背景、备选方案、影响等,并保存到指定文件夹。

什么时候触发

当你明确要求记录某个架构决策时触发,例如说出“记录我们选择用微服务的决策”,或者直接调用此技能。

装好后可以这样说
Claude将扫描现有ADR并生成新记录
Claude会引导你完成决策细节
自动编号并保存到docs/architecture/
技能原文 SKILL.md作者撰写 · MIT · 2c016ef

当此技能被调用时:

  1. 确定下一个 ADR 编号,通过扫描 docs/architecture/ 目录中已有的 ADR 文件。
  1. 收集上下文,阅读相关代码和已有 ADR。
  1. 引导用户完成决策,如果仅凭标题不足以明确决策内容,则提出澄清问题。
  1. 生成 ADR,遵循以下格式:
# ADR-[NNNN]: [标题]

## 状态
[拟议 | 已采纳 | 已弃用 | 被 ADR-XXXX 取代]

## 日期
[决策日期]

## 背景

### 问题描述
[我们要解决什么问题?为什么现在需要做出这个决策?]

### 约束条件
- [技术约束]
- [时间约束]
- [资源约束]
- [兼容性要求]

### 需求
- [必须支持 X]
- [必须在 Y 预算内执行]
- [必须与 Z 集成]

## 决策

[具体的技术决策内容,描述足够详细以便他人实施。]

### 架构图
[此决策所创建的系统架构的 ASCII 图表或描述]

### 关键接口
[此决策创建的 API 契约或接口定义]

## 备选方案

### 备选方案 1:[名称]
- **描述**:[工作原理]
- **优点**:[优势]
- **缺点**:[劣势]
- **否决原因**:[为何未被采用]

### 备选方案 2:[名称]
- **描述**:[工作原理]
- **优点**:[优势]
- **缺点**:[劣势]
- **否决原因**:[为何未被采用]

## 影响

### 正面影响
- [此决策带来的良好结果]

### 负面影响
- [接受的权衡和代价]

### 风险
- [可能出现的问题]
- [各项风险的应对措施]

## 性能影响
- **CPU**:[预期影响]
- **内存**:[预期影响]
- **加载时间**:[预期影响]
- **网络**:[预期影响(如适用)]

## 迁移计划
[如果此决策涉及现有代码变更,如何从当前状态过渡到目标状态?]

## 验证标准
[如何判断此决策是否正确?采用哪些指标或测试?]

## 相关决策
- [关联 ADR 链接]
- [关联设计文档链接]
  1. 保存 ADRdocs/architecture/adr-[NNNN]-[slug].md
按 MIT 许可原样转载,未经改动 · 在 GitHub 查看 →

评论

登录即可评论;带「已验证安装」的,是发布者名下有本店的安装或持有记录。