用途:my-wiki 用于构建个人知识库,把碎片化信息编译一次并持续维护,而不是每次查询都从原始文档重新推导。用户提到“知识库”“wiki”“消化素材”“整理到知识库”,或对已初始化知识库做查询、健康检查、统计、lint、去重等操作时适用。
主要能力:包含 init(初始化)、ingest(消化素材)、query(查询)、digest(深度综合分析)、lint(健康检查)、status(状态统计)、graph(知识图谱)等工作流。ingest 按素材长度与概念密度决定处理深度,生成素材摘要页、实体页、主题页,并维护 index.md 与 log.md。query 先读 index 再用 search.py 全文搜索后综合回答。digest 做跨素材综合,输出深度报告。lint 做结构检查与语义检查。graph 生成 Mermaid 图谱,也可输出 HTML。
使用方式:脚本位于 scripts/ 子目录,Python 3.10+,零外部依赖,跨平台。常用命令如 python {SKILL_DIR}/scripts/init.py --wiki-root "<路径>" --topic "<主题>" --name "<名称>";ingest_prepare.py 支持 --url、--file、--text、--force;search.py 支持 --query、--type、--include-raw;lint.py、status.py、graph.py 均以 --wiki-root 指定路径,graph.py 支持 --max-nodes 与 --format html。除 init 外,工作流先检查当前目录 .wiki-schema.md,再读 wiki-config.json 的 wikis[current],最后回退 ~/.my-wiki-path。
适用场景:个人学习笔记、DevOps 实践、阅读整理等主题知识库;需要跨素材交叉验证、观点对比与知识脉络梳理的场景。
限制:index.md 为手动维护,页面增多后可能过时,查询需同时用全文搜索;[[双向链接]] 不代表语义关联,需判断是否同一概念;短素材也可能含高价值概念,不应仅以字数判断。平台安装路径因 WorkBuddy、Claude Code、OpenCode、OpenClaw 而异。其他细节暂未提供。