SuperAPI AI 工具集

kb-lint

通用与其它

查看项目

更新于 10-16 02:29

技能介绍

用途:在知识库持续增长时检查其是否可信,通过捕捉“漂移”(知识库累积产生的衰减)来保持质量。分两轮:确定性的规格一致性检查(机械、脚本化)与漂移审计(模糊、需判断),两者都要运行并报告发现。

主要能力:

  1. 一致性检查(确定性):使用内置零依赖 Node 脚本(node >=18),script 路径为 <skill-dir>/scripts/conformance.mjs。先做清单盘点:node "<skill-dir>/scripts/conformance.mjs" <bundle-dir> --inventory --json,解析每个概念的前置 YAML 元数据,报告各活动顶层键与状态值计数、精确路径,以及 legacy_citations 和 structured_sources 统计;缺席的观测值表示零;不要用全仓库 grep 分类活动元数据,因为正文与围栏示例可能含非活动字段名。随后运行 node "<skill-dir>/scripts/conformance.mjs" <bundle-dir>,对硬性 SPEC §11 失败报 ERROR,对可选 v0.2 字段的产出画像缺陷、失效链接、非 ISO 日志日期和过期日期报 warn。可选族警告不会使知识包不合规,失效链接被 §6.1 明确容忍。
  2. 漂移审计(判断):检查矛盾(无 conflicts_with 链接的冲突事实)、过期主张(未被标记 superseded_by、概览落后于子项)、孤立概念(零入站交叉链接,索引/日志/概览豁免)、缺失交叉引用、覆盖缺口、溯源缺口、v0.2 元数据漂移(sources 条目缺 resource、脚注标签无匹配 sources[].id、生成/验证者或日期格式错误、生命周期值无效、Attested Computations 缺运行时或计算契约)、仓库漂移(活跃仓库文档中 sources[].resource 缺路径、证据不再支持、自 spec/repository_state.md 记录修订以来的源变更影响某概念但未更新;documented_worktree: true 需与当前工作树比较;无仓库证据或 Git 历史时跳过)、模式漂移(类型未见于 spec/types.md、文档类型不再描述其概念、拼写/大小写变体、一个重载类型隐藏多个不同实体种类)。未使用的文档类型记为 Info。每项检查须覆盖整个知识包而非抽样。

报告:按检查分组,标记 Error(§11 失败,修复前不合规)、Warning(降低信任的漂移)、Info(建议)。将覆盖缺口转化为具体下一步(待调查问题、待摄入来源、待检查仓库证据)。向 bundle 的 log.md 追加带日期摘要(计数 + 重要发现),仅追加。

修复模式:以 fix 调用时,只修复安全且无歧义的问题,再重新报告已修复与需人工处理项。可安全自动修复:过期概览(从子项重新生成)、缺失交叉链接、格式错误的日志日期、有明显目标的失效链接、与文件不同步的索引条目。绝不可自动修复:改变主张含义的任何内容;矛盾或过期主张应由信任模型(supersede/conflict)下的摄入解决,不可原地编辑含义。类型重命名、合并、拆分、弃用与迁移需用户确认,须一并报告拟议模式变更与受影响概念。需要含义更新的活跃仓库行为交由 kb-document 处理。

限制:脚本零依赖但要求 Node 18 及以上;漂移审计依赖人工判断,无法由脚本完成;仓库漂移在缺少仓库证据或 Git 历史时跳过;资料未提供具体价格、平台支持细节或完整命令示例。