SuperAPI AI 工具集

lint

通用与其它

查看项目

更新于 10-15 22:10

技能介绍

用途:对 llmwiki/wiki 做周期性健康检查,覆盖孤立页面、缺失链接、矛盾、过期内容(wiki→wiki 与 code→wiki 漂移)和索引缺口。触发时机为每 10 次 ingest 后、wiki 过期或不一致时,或 session_start 报告代码已变更 N 个 commit。

主要能力:先运行确定性 no-op 门控 python3 harness/scripts/wiki-sync.py --check(下游无 harness/ 时用全局版 python3 ~/.claude/harness/harness/scripts/wiki-sync.py --check --root .),退出码 0/3/2 决定入口。自动修复缺失链接与索引缺口;对矛盾、孤立、空页面只标记不裁决。过期页面按 4 类漂移(contradiction、superseding、progression、equivalence)分类,superseding 需在 frontmatter 加 invalid_at 与 invalidated_by。还包含多项只报告不阻塞的 pulse:unknown-ledger、skill-health、skill-usage、tidy、claim-receipts、decision-liveness、provenance-log。

使用方式:按 W01–W07 工作流执行,最后向 llmwiki/wiki/log.md 追加日志并运行 wiki-sync.py --mark-synced 锚定同步。输出报告草稿写入 llmwiki/wiki/sources/draft/DDMMYY-<ten>.md,并更新 index.md 与 log.md。

限制:矛盾不自行选边;无法追溯到具体代码变更的疑似过期页面不动;代码变更少于 5 个文件时最多改 1–2 个 wiki 页面,需改超过 3 页应先停下自问;禁止纯格式编辑;no-op 是合法成功结果。部分脚本或路径缺失时跳过对应步骤。