SuperAPI AI 工具集

wiki-lint

通用与其它

查看项目

更新于 10-15 16:43

技能介绍

用途:对 Obsidian wiki 执行确定性的只读健康检查,用于 lint、库健康审计、查找孤立页面与死链等。工具只观察库状态,不生成报告、仪表盘、画布、存根,也不做修复。

主要能力:确定性解析 Obsidian wikilinks 与嵌入、Markdown 链接、别名、标题与块片段、转义别名及代码围栏;默认跳过点号开头目录,与 Obsidian 索引器一致;链接解析遵循库内 .gitignore(不调用 git 子进程),歧义时丢弃被忽略的候选文件。可报告死链或歧义链接、孤立页面、必需 frontmatter 缺失(含 title)、空章节、过期索引项,以及来源/主张台账契约违规。仅报告输出中实际存在的检查与计数,不做语义、风格或文本层面矛盾分析。

使用方式:从本技能自身位置解析已安装产品根目录,而非库或当前工作目录:PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian;CORE="$PRODUCT_ROOT/scripts/claude-obsidian.py";test -f "$CORE"。随后运行 python3 "$CORE" lint --vault "$VAULT",可加 --format markdown,或用可重复的 --exclude GLOB(如 --exclude "wiki/scratchpad/*")将某路径排除出页面、链接解析、孤立页面、frontmatter、空章节与过期索引扫描。仅在自动化需要发现项导致非零退出码时使用 --strict,命令始终保持只读。

限制:修复属于独立操作,绝不自动修复 lint 结果;不得将 Markdown 渲染写入库,只在对话或 stdout 返回。若需修复,须先重读目标并记录预期 SHA-256,仅草拟所选改动,未经明确同意不得删除或合并页面,生成带新操作 ID 的修复包,检查并展示确切变更路径,经单独复核后才应用,随后只读重跑 lint 并对比相关发现。lint 自身从不应用该事务,也从不提交 Git。