SuperAPI AI 工具集

vault

通用与其它

查看项目

更新于 10-16 09:57

技能介绍

用途:该技能把 joelclaw vault 作为 Vault 读取与 ADR 治理检查的统一接口,适用于按编号或引用读取 ADR、搜索 Vault 中的 markdown、列出项目/决策/收件箱/资源等分区,以及做 ADR 卫生检查(状态漂移、编号冲突、索引漂移)和决策盘点、整理工作流。

主要能力:命令树包含 read、search、ls、tree 四个基础命令,以及 adr 下的 list、collisions、audit、locate、refs、prompt、rank。read 可按引用读取 ADR 或笔记;search 支持 --semantic 语义搜索和 --limit 限制条数;adr list 支持按 --status 和 --limit 过滤;collisions 检查编号冲突;audit 是 ADR 整理前的标准预检,会报告规范状态计数、缺失或非规范状态、重复编号冲突、失效的 superseded-by 目标、ADR 正文中失效或歧义的 wiki 链接、以及 ADR README 索引漂移。locate 可按 ADR 编号、slug、标题或标题文本定位 ADR 文件与章节;refs 查找指向某 ADR 文件或章节的反向链接;prompt 会把 [[ADR refs]] 展开为规范 id 并附加适合智能体使用的 <adr-context> 块;rank 是每日优先级排序,执行 NRC 评分并引入 novelty/cool-factor 维度(priority-novelty,别名 priority-interest),缺失时默认中性值 3。

使用方式:示例命令包括 joelclaw vault read "ADR-0168"、joelclaw vault search "talon watchdog"、joelclaw vault search "content lifecycle" --semantic --limit 5、joelclaw vault adr list --status proposed --limit 50、joelclaw vault adr audit、joelclaw vault adr rank --band do-now 等。规则要求 CLI 优先,不要在有 joelclaw vault 可用时去 grep 随机 Vault 文件;做 ADR 修改前先跑 audit;状态只使用 proposed、accepted、shipped、superseded、deprecated、rejected;ADR 重命名或新增后同步更新 ~/Vault/docs/decisions/README.md;把重复编号视为需要解决的治理缺陷。

限制:资料未提供安装方式、依赖与平台要求,暂未提供;CLI 文档位置为 ~/Code/joelhooks/joelclaw/docs/cli.md,相关 ADR 为 ADR-0081、ADR-0173、ADR-0174。