SuperAPI AI 工具集

secondbrain-adr

通用与其它

查看项目

更新于 10-16 03:04

技能介绍

用途:当用户要求创建 ADR、记录决策或架构决策时,使用该技能生成带编号、分类和状态工作流的架构决策记录。

主要能力:按类别分配编号范围——infrastructure(0001-0999)、feature(2000-2999)、process(3000-3999);生成 ADR 文档并写入 frontmatter(id、status、date_created、date_updated、author、category);更新月度分片记录与 meta.yaml 中的 last_number;支持状态流转:draft → proposed → admitted → applied → implemented → tested,另有 rejected 与 canceled。

使用方式:先确认 secondbrain 项目已启用 ADR 实体,检查 .claude/data/adrs/meta.yaml(分片)或 records.yaml(旧版)是否存在,若不存在则建议运行 secondbrain-init 并启用 ADR。随后收集类别、标题、上下文,读取 meta.yaml 的 last_number 并确定下一个编号,使用模板生成 docs/adrs/ADR-XXXX-<title-slug>.md,向当月分片 .claude/data/adrs/YYYY-MM.yaml 添加条目并更新 meta.yaml。

限制:不要手动将 ADR 添加到左侧边栏或 VitePress 导航,ADR 由 docs/adrs/index.md 上的 EntityTable 组件自动列出,读取 .claude/data/adrs/ 分片文件。状态更新可使用 /secondbrain-adr-status。完整模板见 references/adr-template.md。其他细节暂未提供。