SuperAPI AI 工具集

blueprint-adr-list

通用与其它

查看项目

更新于 10-15 23:49

技能介绍

用途:从文件系统动态列出架构决策记录(ADR),生成 Markdown 表格,便于生成 ADR 索引、审计 ADR 状态或快速查看全部架构决策。

主要能力:扫描 docs/adrs 目录下的 ADR 文件,提取标题、状态、日期,可选提取领域(domain),输出为 Markdown 表格,并附带总数、Accepted、Superseded、Deprecated 等统计摘要。兼容两种 ADR 格式:Markdown 标题(## Status、## Date)与 YAML frontmatter(status:、date:)。

使用方式:先检查是否存在 ADR,命令为 ls docs/adrs/.md 2>/dev/null | head -1;若无则提示运行 /blueprint:derive-plans 生成。随后用 fd 与 awk 组合命令生成表格,例如 fd '^[0-9]{4}-..md$' docs/adrs -x awk '...',并可用 sort 排序。若使用领域标签,可生成含 Domain 列的扩展表格。最后输出统计摘要。

适用场景:为 README 生成 ADR 索引、审计 ADR 状态、快速浏览所有架构决策。

限制:仅针对 ADR 输出;若需要跨 ADR、PRD、PRP 的合并索引,应改用 blueprint-docs-list;若需关系或冲突检查,应改用 blueprint-adr-validate。ADR 文件需位于 docs/adrs 目录且文件名以四位数字开头。其他细节暂未提供。