Agent Skills › harumiWeb/exstruct › adr-reconciler

adr-reconciler

GitHub

用于审计架构决策记录（ADR）与当前规范、测试及源码的一致性，检测策略漂移、缺失更新或陈旧引用等偏差。在合并后、定期审计或怀疑实现偏离时使用，生成包含证据矩阵和推荐行动的审计报告。

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

触发场景

代码合并后验证 ADR 一致性执行定期 ADR 合规性审计怀疑实现与 ADR 存在分歧时

安装

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

更多选项

非标准路径

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

不安装直接使用

npx skills use harumiWeb/exstruct@adr-reconciler

指定 Agent (Claude Code)

npx skills add harumiWeb/exstruct --skill adr-reconciler -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-reconciler",
    "description": "Audit ExStruct ADRs against current specs, tests, and source code to detect policy drift, missing ADR updates, stale references, and evidence gaps. Use after merges, during periodic ADR audits, or when a review suspects that implementation and ADRs have diverged."
}

ADR Reconciler

Audit the current decision records before proposing new text.

Read

dev-docs/agents/adr-governance.md
dev-docs/agents/adr-workflow.md
dev-docs/specs/adr-index.md
Target ADRs under dev-docs/adr/
Related files under dev-docs/specs/, tests/, and src/

Workflow

Select the target ADRs from changed domains, explicit ADR IDs, or related index entries.
Read each ADR claim and the linked specs, tests, and implementation paths.
Build an evidence matrix for every finding:
- adr
- specs
- src
- tests
Classify findings as one of:
- policy-drift
- missing-adr-update
- missing-evidence
- stale-reference
Recommend the next action:
- update-adr
- new-adr
- update-specs
- add-tests
- no-action