AgentSkillsCN

adr-creation

按照项目模板与编号规范生成架构决策记录。适用于记录架构决策、技术选型，或当用户提出创建 ADR 时使用。

SKILL.md
--- frontmatter
name: adr-creation
description: "Generate Architecture Decision Records following the project template and numbering convention. Use when documenting architecture decisions, technical choices, or when the user asks to create an ADR."
event: architecture-decision
auto_trigger: false
version: "2.0.0"
last_updated: "2026-01-26"

# Inputs/Outputs
inputs:
  - decision_title
  - context
  - options
  - decision
  - rationale
output: adr_document
output_format: "Markdown ADR (02-ADR-TEMPLATE.md)"
output_path: "docs/technical/architecture/adr/"

# Auto-Trigger Rules
auto_invoke:
  events:
    - "architecture-decision"
    - "design-review"
  conditions:
    - "major technical decision made"
    - "user requests ADR"

# Validation
validation_rules:
  - "ADR number must be sequential"
  - "status must be valid (proposed, accepted, rejected, deprecated, superseded)"
  - "at least 2 options considered"

# Chaining
chain_after: []
chain_before: [doc-index-update]

# Agent Association
called_by: ["@Architect", "@Scribe"]
mcp_tools:
  - mcp_payment-syste_search_full_text
  - read_file
  - list_dir

ADR Creation Skill

Purpose: Generate Architecture Decision Records (ADRs) following the project template and numbering convention.

Trigger

When: User requests architecture documentation OR major technical decision made Context Needed: Decision context, options considered, final decision MCP Tools: mcp_payment-syste_search_full_text, read_file

ADR Numbering

Format: NNN-SHORT-TITLE.md

code
001-AUTH-STRATEGY.md
002-OFFLINE-STRATEGY.md
003-[NEXT-DECISION].md

Required Sections

markdown
# ADR-NNN: [Title]

## Status

[proposed | accepted | rejected | deprecated | superseded]

## Context

[What is the issue that we're seeing that motivates this decision?]

## Decision

[What is the change that we're proposing and/or doing?]

## Options Considered

### Option 1: [Name]

**Pros:** ...
**Cons:** ...

### Option 2: [Name]

**Pros:** ...
**Cons:** ...

## Rationale

[Why was this option chosen?]

## Consequences

[What becomes easier or more difficult?]

## Related ADRs

[Links to related decisions]

Frontmatter Template

yaml
---
document_type: "adr"
module: "architecture"
status: "accepted"
version: "1.0.0"
last_updated: "YYYY-MM-DD"
author: "@username"

keywords:
  - "adr"
  - "[topic]"
  - "[technology]"

related_docs:
  database_schema: ""
  api_design: ""

adr_metadata:
  adr_number: NNN
  decision_date: "YYYY-MM-DD"
  stakeholders: ["@Architect", "@Backend"]
---

ADR Categories

CategoryKeywordsExample
Architecturepattern, structureMonolith vs Microservices
Technologyframework, libraryAngular vs React
Datadatabase, storagePostgreSQL vs MongoDB
Securityauth, encryptionJWT vs Sessions
Integrationapi, protocolREST vs GraphQL

Workflow

  1. •Get next number - Check existing ADRs in docs/technical/architecture/adr/
  2. •Load template - Read 02-ADR-TEMPLATE.md
  3. •Gather context - Document the problem
  4. •List options - At least 2 alternatives
  5. •Document decision - Clear statement
  6. •Explain rationale - Why this choice?
  7. •Create file - docs/technical/architecture/adr/NNN-TITLE.md

Reference