القائمة
在 Claude Code 会话期间捕获架构决策为结构化 ADR。自动检测决策时刻，记录上下文、考虑的替代方案和理由。维护 ADR 日志，以便未来的开发人员理解代码库为何采用这种形状。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/aaione/everything-claude-code-zh --skill architecture-decision-recordsيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
Kubernetes 工作负载模式、资源管理、RBAC、probes、autoscaling、ConfigMap/Secret 处理，以及面向生产级部署的 kubectl 调试。
完成任何非平凡任务后使用。智能体按 5 个维度自评输出——准确性、完整性、清晰度、可执行性、简洁性——每项都给出具体证据。生成结构化 1-5 评分卡和具体改进建议。
在 competitive-platform-analysis 产出分层竞品集合后使用。按九个加权维度（定位、声音、视觉工艺、offer packaging、证据、enterprise-readiness、thought leadership、定价、客户 strategic tension）为每个竞品评分，使用明确 1–5 rubrics 和 tension-plot。位于 competitive-report-structure 之前。
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | architecture-decision-records |
| description | 在 Claude Code 会话期间捕获架构决策为结构化 ADR。自动检测决策时刻，记录上下文、考虑的替代方案和理由。维护 ADR 日志，以便未来的开发人员理解代码库为何采用这种形状。 |
| origin | ECC |
在编码过程中捕获架构决策。不再让决策仅存在于 Slack 线程、PR 评论或某人的记忆中，此技能生成与代码共存的结构化 ADR 文档。
使用 Michael Nygaard 提出的轻量级 ADR 格式，针对 AI 辅助开发进行调整：
# ADR-NNNN: [决策标题]
**Date**: YYYY-MM-DD
**Status**: proposed | accepted | deprecated | superseded by ADR-NNNN
**Deciders**: [参与人员]
## Context
促使我们做出此决策或更改的问题是什么？
[2-5 句话描述情况、约束和影响因素]
## Decision
我们提议和/或正在做的更改是什么？
[1-3 句话清楚地陈述决策]
## Alternatives Considered
### Alternative 1: [名称]
- **Pros**: [好处]
- **Cons**: [缺点]
- **Why not**: [拒绝此选项的具体原因]
### Alternative 2: [名称]
- **Pros**: [好处]
- **Cons**: [缺点]
- **Why not**: [拒绝此选项的具体原因]
## Consequences
由于此更改，什么变得更容易或更困难？
### Positive
- [好处 1]
- [好处 2]
### Negative
- [权衡 1]
- [权衡 2]
### Risks
- [风险和缓解措施]
当检测到决策时刻时：
docs/adr/ 不存在，在创建目录之前请求用户确认，创建一个带有索引表头的 README.md（见下文 ADR 索引格式）和用于手动使用的空白 template.md。不要在未经明确同意的情况下创建文件。docs/adr/ 中的现有 ADR 并递增docs/adr/NNNN-decision-title.md。如果用户拒绝，则丢弃草稿而不写入任何文件。docs/adr/README.md当用户问"为什么我们选择了 X？"时：
docs/adr/ 是否存在 — 如果不存在，响应："此项目中未找到 ADR。您想要开始记录架构决策吗？"docs/adr/README.md 索引以查找相关条目docs/
└── adr/
├── README.md ← 所有 ADR 的索引
├── 0001-use-nextjs.md
├── 0002-postgres-over-mongo.md
├── 0003-rest-over-graphql.md
└── template.md ← 用于手动使用的空白模板
# 架构决策记录
| ADR | 标题 | 状态 | 日期 |
|-----|-------|--------|------|
| [0001](0001-use-nextjs.md) | 使用 Next.js 作为前端框架 | accepted | 2026-01-15 |
| [0002](0002-postgres-over-mongo.md) | PostgreSQL over MongoDB 作为主数据存储 | accepted | 2026-01-20 |
| [0003](0003-rest-over-graphql.md) | REST API over GraphQL | accepted | 2026-02-01 |
注意对话中的这些模式，它们表示架构决策：
明确信号
隐式信号（建议记录 ADR —— 不要在未经用户确认的情况下自动创建）
proposed → accepted → [deprecated | superseded by ADR-NNNN]
| 类别 | 示例 |
|---|---|
| 技术选择 | 框架、语言、数据库、云提供商 |
| 架构模式 | 单体 vs 微服务、事件驱动、CQRS |
| API 设计 | REST vs GraphQL、版本策略、认证机制 |
| 数据建模 | 模式设计、规范化决策、缓存策略 |
| 基础设施 | 部署模式、CI/CD 管道、监控栈 |
| 安全 | 认证策略、加密方法、密钥管理 |
| 测试 | 测试框架、覆盖率目标、E2E vs 集成平衡 |
| 流程 | 分支策略、审查流程、发布节奏 |