Obsidian Wiki 健康检查
自动发现知识库中的链接、结构和内容问题。
技能明确主要读取并要求先展示报告、询问后再自动修复,且语义 tiling 默认仅访问本机 Ollama,远程访问需显式覆盖并说明页面正文会被 POST;但“写入单个报告”与后续无明确确认即创建或更新 dashboard/canvas 不一致,自动修复边界、失败回滚、依赖信任和敏感数据处理仍不完整,因此扣分。
检查顺序、报告格式、退出码和异常分支说明较具体,仓库 CI 及相关脚本测试提供间接支持;但选定技能本身没有专门测试,且 Dataview、Obsidian CLI、MCP、Ollama 和多个引用路径可能不可用,部分依赖失败后的统一诊断与可复现性证据不足,静态审查不超过 10 分。
触发词、主要场景和检查范围清晰,也包含 filesystem、CLI、MCP 与本地 Ollama 的路径;但输入前提、输出边界、非适用场景及不同 Obsidian/运输配置的兼容性未充分声明,中文内容虽有相关测试线索,中文用户体验和大陆网络可达性没有直接证据,因此扣分。
技能具备 frontmatter、分层章节、报告模板、配置示例、退出码、已知安全假设和 MIT 许可证;但版本/变更记录、维护责任人和更新路径主要依赖仓库 README,安装与依赖说明分散在其他文件,且 dashboard/canvas 的写入要求与 transport 描述存在文档不一致,故未给高分。
八类基础检查、地址校验、语义 tiling、报告模板和自动修复确认流程覆盖了核心 wiki 维护目标,预期报告可直接使用;但静态材料未证明该技能关键路径实际运行,结果质量、陈旧声明识别、缺失页面判断和 Dataview/canvas 产物的可用性仍需人工复核,按静态上限给 7 分。
仓库提供 CI、相关脚本测试、明确的报告结构和错误码,支持有限审计;但没有 wiki-lint 专属测试或该技能关键路径的真实执行结果,README 的性能与基准声明也不能替代本技能复现,因此接近静态上限但未给满分。
- 技能声明主要写入单个 lint 报告,但还要求创建或更新 dashboard.md 和 overview.canvas;执行前应确认这些额外写入范围,并保留可恢复备份。
- 语义 tiling 会处理页面正文;即使默认连接本机 Ollama,也应确认本地服务、模型和页面敏感信息策略。
- Dataview、Obsidian CLI、MCP、Python、Ollama 及引用脚本缺失时,不能假定检查完成;应逐项报告跳过、失败或未验证状态。
- 未见 wiki-lint 专属执行证据,报告结果应视为建议并由用户复核,尤其是陈旧声明、缺失页面和重复页面判断。
这个 Skill 能做什么,适合哪些场景?
wiki-lint 是 claude-obsidian 中用于维护 Obsidian Markdown 知识库的健康检查技能。它扫描孤立页面、失效双链、过时主张、缺失交叉引用、前置元数据缺口和空章节,并生成 Markdown lint 报告。它还可以创建或更新 Dataview 仪表盘和 Canvas 地图;DragonScale 功能启用时,还支持地址校验和语义重复检测。该技能适合希望定期维护大型本地知识库的 Obsidian 用户,但自动修复前必须先征求确认。
读取 .vault-meta/transport.json 以选择 CLI、MCP 或文件系统传输方式;按顺序检查孤立页面、失效双链、过时主张、缺失页面、缺少交叉引用、前置元数据缺口、空章节、过时索引项、命名规范和写作风格问题。它将报告写入 wiki/meta/lint-report-YYYY-MM-DD.md,并创建或更新 wiki/meta/dashboard.md 和 wiki/meta/overview.canvas。启用 DragonScale 时,它还可运行 allocate-address.sh --peek 和 tiling-check.py,检查地址格式、唯一性、计数器一致性、地址映射及语义相似页面。
- 使用 Obsidian 保存研究资料,并希望每周发现孤立页面和失效双链的研究者。
- 持续导入文章、书籍或其他来源,想定期检查新旧页面之间交叉引用是否完整的知识管理用户。
- 维护包含大量带 frontmatter 的 Markdown 页面,需要批量发现字段缺失和空章节的个人用户。
- 启用 DragonScale 的大型 vault,需要检查页面地址冲突、计数器漂移或潜在重复页面的用户。
这个 Skill 有哪些优点和局限?
- 覆盖孤立页面、死链、过时主张、元数据缺口和空章节等多类维护问题。
- 报告输出位置和 Markdown 格式明确,便于在 vault 中持续追踪。
- 支持 CLI、MCP 和文件系统传输路径。
- DragonScale 启用时可增加地址一致性和语义重复检查。
- 它主要是诊断和生成报告的技能,不会自动解决所有问题。
- 删除孤立页面、解决矛盾和合并重复页面前必须人工审核。
- 语义检测依赖 Python、ollama 和本地嵌入模型;超过 5000 个页面时会硬失败。
- 来源没有提供除 Claude Code 和 Codex 基线外的平台验证证据。
如何安装这个 Skill?
该仓库是包含 15 个技能的合集,来源未提供 wiki-lint 的独立安装命令。可按仓库 README 安装整个公开版本:git clone https://github.com/AgriciDaniel/claude-obsidian,然后运行 cd claude-obsidian 和 bash bin/setup-vault.sh;也可运行 claude plugin marketplace add AgriciDaniel/claude-obsidian,再运行 claude plugin install claude-obsidian@agricidaniel-claude-obsidian。
如何使用这个 Skill?
在已配置的 vault 中输入或请求:lint the wiki、health check、clean up wiki、check the wiki、wiki maintenance、find orphans 或 wiki audit。技能建议每 10–15 次导入后或每周运行一次,并将报告写入 wiki/meta/lint-report-YYYY-MM-DD.md。查看报告后,再回答“Should I fix these automatically, or do you want to review each one?”;来源未说明独立调用 wiki-lint 所需的额外步骤。
这个 Skill 与同类方案有什么区别?
README 将 claude-obsidian 的整体能力与 Smart Connections 和 Copilot 对比;其中 wiki-lint 对应的是其强调的 vault maintenance 能力,而非这些产品的全部功能。与 Dataview 的关系是兼容和互补:技能可更新 Dataview 仪表盘,同时仓库也将 Bases 作为主要仪表盘方案。