Agent Skills › harumiWeb/exstruct › adr-drafter

adr-drafter

GitHub

根据Issue、PR或规范起草新的ADR或更新现有ADR。提取策略上下文、决策及证据，生成结构化草案或说明无需ADR的理由，确保区分‘为什么’与‘怎么做’，并遵循治理准则。

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

Trigger Scenarios

需要记录架构决策时提出架构决策更新提案时分析Issue或PR以确定是否需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