create-adr 是什么？

非常适合需要使用MADR格式创建和管理标准化架构决策记录的架构分析代理 create-adr技能：一种用于创建架构决策记录的技能，支持MADR格式

如何安装 create-adr？

运行命令：npx killer-skills add amak07/acr-automotive/create-adr。支持 Cursor、Windsurf、VS Code、Claude Code 等 19+ IDE/Agent。

create-adr 适用于哪些场景？

典型场景包括：使用自动建议的编号创建新的ADR、通过删除和取代来管理现有的ADR、分析决策历史和上下文以进行明智的架构选择。

create-adr 支持哪些 IDE 或 Agent？

该技能兼容 Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer。可使用 Killer-Skills CLI 一条命令通用安装。

create-adr 有哪些限制？

需要用户确认ADR的创建、删除和取代；仅限于MADR格式的ADR创建。

create-adr

使用create-adr技能轻松创建架构决策记录，支持MADR格式，实现智能交互

SKILL.md

Readonly

Upstream Repository Material

The section below is imported from the upstream repository and should be treated as secondary evidence. Use the Killer-Skills review above as the primary layer for fit, risk, and installation decisions.

Supporting Evidence

ADR Creation Skill

Name: create-adr
Availability: InStock
Author: amak07

Purpose

Create Architecture Decision Records (ADRs) using the MADR (Markdown Any Decision Records) format. ADRs capture important architectural decisions and their context for future reference.

Smart Interaction

ASK the User When:

Creating new ADR: Confirm ADR number (auto-suggest next available)
Deleting ADR: Always confirm, suggest "Deprecated" status instead
Superseding ADR: Confirm which ADR is being replaced

PROCEED Autonomously When:

Updating existing ADR: Add consequences discovered during implementation
Linking ADRs: Add related ADR links
Fixing typos: Non-destructive corrections
Updating status: Proposed → Accepted after team approval

Instructions

When creating an ADR:

Find the next ADR number by checking /docs/architecture/decisions/
Use the MADR template at templates/madr.md
Output to /docs/architecture/decisions/NNNN-[kebab-case-title].md

Template

Use the template at: .claude/skills/create-adr/templates/madr.md

ADR Naming Convention

Format: NNNN-kebab-case-title.md

Examples:

0001-use-supabase-for-database.md
0002-tanstack-query-for-state.md
0003-fumadocs-for-documentation.md

Status Definitions

Status	Meaning
Proposed	Under discussion, not yet decided
Accepted	Decision has been made and applies
Deprecated	No longer applies, but kept for history
Superseded	Replaced by another ADR (link to it)

When to Create an ADR

Create an ADR when:

Choosing between technologies/libraries
Defining architectural patterns
Making decisions that affect multiple parts of the system
Making decisions that are hard to reverse
Team needs to understand "why" something was done

Output Location

All ADRs go to: /docs/architecture/decisions/NNNN-title.md

Quality Checklist

Before completing:

ADR number is sequential (check existing ADRs)
Title is clear and descriptive
Context explains the problem, not the solution
Decision is stated clearly
Consequences cover positive, negative, and neutral
At least 2 options were considered
Related links are included
YAML frontmatter has title and description

Examples

Creating New ADRs (Will Ask User)

"Create an ADR for choosing Supabase" → Ask: Confirm number 0001?
"Record the decision to use TanStack Query" → Suggest next number

Updating Existing ADRs (Autonomous)

"Mark ADR-001 as accepted" → Updates status
"Add implementation notes to ADR-003" → Adds to Notes section
"Link ADR-002 to ADR-005" → Adds to Related section

Status Changes

"Deprecate ADR-002" → Updates status, adds deprecation note
"ADR-003 supersedes ADR-001" → Updates both ADRs with cross-references

create-adr — MADR格式 create-adr, acr-automotive, community, MADR格式, ide skills, 架构决策记录, 智能交互, ADR创建, ADR删除, ADR替换

关于此技能

功能特性

# 核心主题

Killer-Skills Review

核心价值

适用 Agent 类型

↓ 赋予的主要能力 · create-adr

! 使用限制与门槛

Why this page is reference-only

Source Boundary

先决定动作，再继续看上游仓库材料

先进入安装与验证

回到可信合集再做一次复核

如果要进团队流转，转到工作流集合

Browser Sandbox Environment

⚡️ Ready to unleash?

常见问题与安装步骤

? FAQ