Agent Skills › harumiWeb/exstruct › adr-drafter

adr-drafter

GitHub

用于根据 Issue、PR、代码差异及测试规范，起草新的架构决策记录（ADR）或更新现有 ADR。该技能强调区分政策背景与实现细节，提取上下文、决策及其后果，并引用具体证据，确保产出结构化的政策记录而非实施备忘录。

.agents/skills/adr-drafter/SKILL.md harumiWeb/exstruct

Trigger Scenarios

需要为新决策创建 ADR 需要对现有 ADR 进行更新或修订

Install

npx skills add harumiWeb/exstruct --skill adr-drafter -g -y

More Options

Non-standard path

npx skills add https://github.com/harumiWeb/exstruct/tree/main/.agents/skills/adr-drafter -g -y

Use without installing

npx skills use harumiWeb/exstruct@adr-drafter

指定 Agent (Claude Code)

npx skills add harumiWeb/exstruct --skill adr-drafter -a claude-code -g -y

安装 repo 全部 skill

npx skills add harumiWeb/exstruct --all -g -y

预览 repo 内 skill

npx skills add harumiWeb/exstruct --list

SKILL.md

Frontmatter

{
    "name": "adr-drafter",
    "description": "Draft a new ExStruct ADR or propose an update to an existing ADR from an issue, PR, diff, tests, and specs. Use when an ADR is required or recommended and you need a structured draft with context, decision, consequences, and evidence."
}

ADR Drafter

Draft a policy record, not an implementation memo.

Read

dev-docs/agents/adr-governance.md
dev-docs/agents/adr-criteria.md
dev-docs/agents/adr-workflow.md
dev-docs/adr/template.md
Related ADRs under dev-docs/adr/

Workflow

Confirm whether the target is a new ADR or an update to an existing ADR.
Read the issue, diff, relevant specs, tests, and implementation files.
Extract:
- policy-level context
- chosen decision
- positive and negative consequences
- concrete evidence from tests, code, and related specs
Produce one of these outputs:
- a new ADR draft
- an update proposal for an existing ADR
- ADR not needed with rationale