Agent Skills › harumiWeb/exstruct › adr-linter

adr-linter

GitHub

用于审查架构决策记录(ADR)草稿的合规性，检查状态、必需字段、证据质量及影响平衡性。在合并前提供分级发现报告，确保文档规范与逻辑严谨。

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

Trigger Scenarios

收到 ADR 草稿需进行合并前审查需要验证 ADR 是否符合治理规范与模板要求

Install

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

More Options

Non-standard path

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

Use without installing

npx skills use harumiWeb/exstruct@adr-linter

指定 Agent (Claude Code)

npx skills add harumiWeb/exstruct --skill adr-linter -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-linter",
    "description": "Review an ExStruct ADR draft for required sections, status values, evidence quality, supersede links, and balanced consequences. Use when an ADR already exists in draft form and you need findings before review or merge."
}

ADR Linter

Review the ADR as a decision record, not as prose polish.

Read

dev-docs/agents/adr-governance.md
dev-docs/agents/adr-workflow.md
dev-docs/adr/template.md
Related ADRs if the draft mentions supersede or overlap

Workflow

Validate the status value.
Check that the ADR has 状態, 背景, 決定, 影響, 根拠, Supersedes, and Superseded by.
Verify that 根拠 contains concrete Tests, Code, or Related specs.
Check that consequences include tradeoffs, not only benefits.
If supersede or replacement is claimed, verify the referenced ADR links are present and consistent.

Output Contract

Return findings first, ordered by severity.

high: contract hole, missing decision, invalid status, missing supersede linkage
medium: weak context, weak evidence, one-sided consequences
low: clarity or consistency issues

If no findings exist, say that explicitly and mention any residual review risk.