obsidian-agent

name	obsidian-agent
description	Obsidian Wiki Q&A + Lint/健康检查 Agent。按需或 Cron 触发，检查 Wiki 完整性、链接健康、格式规范，用 LLM 生成验证问题。
trigger	["帮我检查知识库","健康检查","wiki qa"]

Obsidian Agent — Wiki Q&A + Lint 健康检查

概述

实现 Karpathy 工作流的第三步：LLM Agent 做 Q&A / Lint / 健康检查 → 输出回流 Wiki

两个独立脚本：

脚本	功能	触发方式
health_check.py	检查 broken links、frontmatter、孤立页面、重复标题	按需或 cron
qa_agent.py	用 LLM 生成验证问题，检测知识盲点	按需或 cron

---

health_check.py — Wiki 健康检查

检查项：

1. Broken Links：[[wiki links]] 指向不存在的文件
2. Frontmatter 完整：必需字段 title、created、source、tags
3. 孤立页面：没有任何页面引用它（无反向链接）
4. 重复标题：title 字段重复

运行：

python3 skills/obsidian-agent/scripts/health_check.py

输出：

• 控制台实时打印结果
• 报告保存到 wiki/health-report.md

---

qa_agent.py — Q&A 验证

流程：

1. 读取 Wiki 所有 wiki/concepts/ 页面
2. 随机抽取 3 篇，用 LLM 生成 2-3 个验证问题
3. 问题保存到 wiki/qa-report.md
4. （可配置 Cron 每日自动运行）

运行：

python3 skills/obsidian-agent/scripts/qa_agent.py

注意： 需要配置 MiniMax API Key（见 minimax-understand-image skill）

---

Cron 配置建议

# 每周日凌晨 2 点健康检查
openclaw cron add --name "Wiki健康检查" \
  --task "python3 ~/.openclaw/workspace/skills/obsidian-agent/scripts/health_check.py" \
  --when "0 2 * * 0"

# 每周三/六晚 8 点 Q&A 验证
openclaw cron add --name "Wiki Q&A验证" \
  --task "python3 ~/.openclaw/workspace/skills/obsidian-agent/scripts/qa_agent.py" \
  --when "0 20 * * 3,6"

---

与知识库摄入的配合

原始数据 → LLM ingest → Wiki
                         ↓
              health_check.py (Lint)
              qa_agent.py (Q&A)
                         ↓
              发现问题 → 修复 → 回流 Wiki
                         ↓
                    知识库迭代完善

---

当前检查结果（2026-04-12）

• ✅ Broken Links: 0
• ✅ Frontmatter: 全部完整
• ✅ 孤立页面: 0
• ✅ 重复标题: 0
• 📊 共 5 篇概念文章