Architecture Skill：让 AI 帮你做架构决策、写 ADR 的标准化框架

Skill超级捕获手 技术创作者 2026-09-07 15 阅读

Architecture Skill：让 AI 帮你做架构决策、写 ADR 的标准化框架

当你需要做技术选型时，有没有过这种感觉——翻开文档看了半天，最后还是凭直觉拍板？Architecture Skill 就是来解决这个问题的。这是一个专为 AI 编码助手设计的架构决策框架，能引导需求分析、系统评估，并自动生成符合规范的 ADR（Architecture Decision Record，架构决策记录），把「大家开会讨论」的结果变成可追溯、可复用的文档。

功能与原则

Architecture Skill 的核心能力是把架构决策过程结构化。输入一个技术选型问题或系统设计方案，它会通过一系列引导性问题厘清上下文，列出所有可选方案，从复杂度、成本、可扩展性、团队熟悉度等多个维度做对比评估，最终输出标准格式的 ADR 文档。

设计原则高度聚焦一个词：简洁（Simplicity is the ultimate sophistication）。Skill 明确要求在加入任何架构复杂度之前，必须先证明其必要性——因为你永远可以之后再加复杂性，但移除它代价极高。

认可度

  • GitHub Star：主仓库 davila7/claude-code-templates 约 30.5k stars（截至 2026-09-07），全球排名约 #1147
  • 子模块 Star：架构决策框架子模块约 23.8k stars（eliteai.tools 统计）
  • Smithery 安装量：540 次安装
  • agentskills.in：2,230 forks
  • 近期动态：2026 年 7-8 月多次登上 GitHub Trending，获得 CSDN、头条等中文技术社区报道

链接

GitHub（主仓库）：
https://github.com/davila7/claude-code-templates

架构 Skill 路径：
https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/development/architecture

原作者

davila7（GitHub username），专注于 Claude Code 配置生态的独立开发者。维护的 claude-code-templates 仓库是 Claude Code 领域最大的开源模板集合之一，涵盖 Agents、Commands、Settings、Hooks、MCP 集成等 400+ 组件，持续活跃更新。

介绍

davila7/claude-code-templates 是一个面向 Claude Code 的 CLI 工具与配置集合，把 AI 代理、斜杠命令、MCP 外部集成、Settings、Hooks 和完整项目模板打包成可浏览、可一键安装的组件库。其中的 architecture Skill 是专门解决架构决策问题的子模块，从 2026 年初上线至今保持高频更新。

这个 Skill 的设计哲学是「选择性读取」——它不要求 AI 一次性读完所有文件，而是根据任务类型只读取最相关的部分。Skill 由 5 个文件组成：context-discovery.md 负责需求分类，trade-off-analysis.md 提供 ADR 模板和权衡分析框架，pattern-selection.md 包含决策树和反模式清单，examples.md 覆盖 MVP/SaaS/Enterprise 三种场景的参考实现，patterns-reference.md 是快速查阅的模式对照表。

输出物是标准化的 Markdown ADR，包含状态、日期、决策者、上下文、候选方案（各维度评分 + 优缺点）、权衡分析、执行后果等完整字段，可直接存入代码仓库的 /docs/adr/ 目录。

特点

  • 结构化决策输出：ADR 格式规范，团队可直接引用，无需人工整理会议纪要
  • 选择性读取策略：Skill 内置「只读相关文件」规则，避免 token 浪费，提升响应速度
  • 多维度评估矩阵：每个候选方案从复杂度、成本、可扩展性、团队熟悉度四个维度打分
  • 反模式清单内置：提前标注常见架构陷阱（如，过早优化、微服务洁癖、NIH 综合征）
  • 全平台兼容：支持 Claude Code、Cursor、Copilot、Codex、Antigravity 等主流 AI 编码助手
  • 可连接外部工具：若接入了知识库或项目跟踪工具，可自动搜索历史 ADR 并关联任务卡片

使用方法

安装（任选一种）：

# 通过 Smithery CLI
npx skills add https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/development/architecture

# 通过 agent-skills-cli
npx agent-skills-cli install @davila7/architecture

基本调用：

在支持 Skill 的 AI 编码助手中，直接输入：

/architecture Should we use Kafka or SQS for our event bus?

或：

/architecture Review this microservices proposal

Skill 会根据问题类型自动选择对应文件，引导你完成完整决策流程。

最小示例（创建 ADR）：

输入：/architecture Should we use PostgreSQL or MongoDB for our new SaaS product?

Skill 输出：

## ADR-001: 选择主数据库技术栈

**Status:** Proposed
**Date:** 2026-09-07
**Deciders:** [Team leads]

**Context**
新 SaaS 产品需要选型数据库，需支持结构化数据、水平扩展、团队熟悉度高。

**Decision**
我们选择 PostgreSQL 作为主数据库。

**Options Considered**

| 维度 | PostgreSQL | MongoDB |
|------|-----------|---------|
| 复杂度 | Medium | Low |
| 成本 | Low (self-hosted) | Medium |
| 可扩展性 | High | High |
| 团队熟悉度 | High | Medium |

**Pros (PostgreSQL)**
- 强类型schema，减少运行时错误
- JSONB 支持半结构化数据
- 团队已有运维经验

**Cons (PostgreSQL)**
- 水平扩展需借助 Citus/Partitioning

**Trade-off Analysis**
...（完整权衡分析）

**Consequences**
- 需要定期 VACUUM 维护
- 需要配置读写分离

使用场景与人群

  • 适用场景：新项目技术选型、微服务架构评审、中台改造评估、技术债务清理时的架构重设计
  • 目标用户：Tech Lead、架构师、后端工程师，以及需要 AI 辅助做系统设计的全栈开发者
  • 典型时机：项目启动前的技术评审、季度技术规划会议、代码审查中涉及架构变动的讨论

输入与输出案例

案例 1：消息队列选型

  • 输入：/architecture Should we use Kafka or SQS for our event bus? We need to handle 10K events/sec and our team is small.
  • 输出：完整 ADR，候选人包括 Kafka（高吞吐量，运维复杂）vs SQS（托管免运维，延迟高），含四维度评分、团队约束条件下的推荐结论，以及后续行动项（如「配置 MSK」或「设置 SQS FIFO」）

案例 2：微服务方案评审

  • 输入：/architecture Review this microservices proposal for our e-commerce platform
  • 输出：ADR 格式的评审意见，指出过度拆分风险，给出「先单体后拆分为服务」的建议，并列出重构触发条件（如单模块 team > 8 人、部署频率成为瓶颈等）

Skill 安装与使用需要 Claude Code / Cursor / Codex 等支持 Skill 格式的 AI 编码助手。

GitHub: https://github.com/davila7/claude-code-templates

评论区

0 条评论

登录后可评论。

Skill超级捕获手 15 阅读