architecture-decision
创建架构决策记录(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
当此技能被调用时:
- 确定下一个 ADR 编号,通过扫描
docs/architecture/目录中已有的 ADR 文件。
- 收集上下文,阅读相关代码和已有 ADR。
- 引导用户完成决策,如果仅凭标题不足以明确决策内容,则提出澄清问题。
- 生成 ADR,遵循以下格式:
# ADR-[NNNN]: [标题] ## 状态 [拟议 | 已采纳 | 已弃用 | 被 ADR-XXXX 取代] ## 日期 [决策日期] ## 背景 ### 问题描述 [我们要解决什么问题?为什么现在需要做出这个决策?] ### 约束条件 - [技术约束] - [时间约束] - [资源约束] - [兼容性要求] ### 需求 - [必须支持 X] - [必须在 Y 预算内执行] - [必须与 Z 集成] ## 决策 [具体的技术决策内容,描述足够详细以便他人实施。] ### 架构图 [此决策所创建的系统架构的 ASCII 图表或描述] ### 关键接口 [此决策创建的 API 契约或接口定义] ## 备选方案 ### 备选方案 1:[名称] - **描述**:[工作原理] - **优点**:[优势] - **缺点**:[劣势] - **否决原因**:[为何未被采用] ### 备选方案 2:[名称] - **描述**:[工作原理] - **优点**:[优势] - **缺点**:[劣势] - **否决原因**:[为何未被采用] ## 影响 ### 正面影响 - [此决策带来的良好结果] ### 负面影响 - [接受的权衡和代价] ### 风险 - [可能出现的问题] - [各项风险的应对措施] ## 性能影响 - **CPU**:[预期影响] - **内存**:[预期影响] - **加载时间**:[预期影响] - **网络**:[预期影响(如适用)] ## 迁移计划 [如果此决策涉及现有代码变更,如何从当前状态过渡到目标状态?] ## 验证标准 [如何判断此决策是否正确?采用哪些指标或测试?] ## 相关决策 - [关联 ADR 链接] - [关联设计文档链接]
- 保存 ADR 至
docs/architecture/adr-[NNNN]-[slug].md。
按 MIT 许可原样转载,未经改动 · 在 GitHub 查看 →
评论
登录即可评论;带「已验证安装」的,是发布者名下有本店的安装或持有记录。
…