Agent Skills › harumiWeb/exstruct › adr-suggester

adr-suggester

GitHub

用于判断代码变更是否需要架构决策记录(ADR)。通过审查Issue、PR或Diff，结合治理文档和现有ADR，输出必要性 verdict（必需/建议/无需）、理由及后续行动建议。

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

触发场景

分析 Issue 或 PR 变更审查代码 Diff 评估设计决策影响

安装

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

更多选项

非标准路径

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

不安装直接使用

npx skills use harumiWeb/exstruct@adr-suggester

指定 Agent (Claude Code)

npx skills add harumiWeb/exstruct --skill adr-suggester -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-suggester",
    "description": "Determine whether a change in ExStruct needs an ADR, using repository-specific governance and criteria. Use when reading an issue, PR, review thread, or diff and you need a verdict of required, recommended, or not-needed, plus candidate ADR titles and related existing ADRs."
}

ADR Suggester

Classify the change before drafting anything.

Read

dev-docs/agents/adr-criteria.md
dev-docs/agents/adr-governance.md
Relevant files under dev-docs/adr/

Workflow

Read the issue, PR, diff, or review comment that introduced the change.
Read the relevant specs, implementation path, tests, and existing ADRs needed to justify the verdict.
Map the change to one or more ExStruct design domains.
Assemble an evidence triad:
- specs contract
- src symbol or execution path
- tests that fix the current behavior, or an explicit note that evidence is missing
Return one verdict:
- required
- recommended
- not-needed
If verdict is not not-needed, propose:
- a candidate ADR title
- existing ADRs to inspect or update
- whether the next step is new-adr or update-existing-adr