Agent Skills › harumiWeb/exstruct › adr-indexer

adr-indexer

GitHub

扫描架构决策记录(ADR)文件，同步更新README、索引和决策映射等元数据文档，确保人工与AI代理获取最新的ADR状态与关系。

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

触发场景

新增或修改ADR文件需要刷新ADR索引或地图

安装

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

更多选项

非标准路径

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

不安装直接使用

npx skills use harumiWeb/exstruct@adr-indexer

指定 Agent (Claude Code)

npx skills add harumiWeb/exstruct --skill adr-indexer -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-indexer",
    "description": "Maintain ExStruct ADR index artifacts by scanning ADR files and synchronizing README, index.yaml, and decision-map.md metadata. Use when ADRs are added, updated, superseded, or reclassified and the repository needs a refreshed ADR map for humans and AI agents."
}

ADR Indexer

Refresh the derived ADR map after the source ADRs change.

Read

dev-docs/agents/adr-governance.md
dev-docs/agents/adr-workflow.md
dev-docs/specs/adr-index.md
All ADR files under dev-docs/adr/
Existing dev-docs/adr/README.md, dev-docs/adr/index.yaml, dev-docs/adr/decision-map.md

Workflow

Scan the ADR files and collect normalized metadata:
- id
- title
- status
- primary_domain
- domains
- supersedes
- superseded_by
- related_specs
Compare the normalized metadata with README.md, index.yaml, and decision-map.md.
Update the derived artifacts so that status, primary domain, domain grouping, and supersede relationships match the ADR source files.
Report any ambiguity that cannot be derived from the ADR text alone.