SuperAPI AI 工具集

wiki-connect

通用与其它

查看项目

更新于 10-15 20:11

技能介绍

用途:在 wiki 图谱中查找并补全隐藏连接,提升条目间关联密度与图谱健康度,可仅输出建议或在确认后应用链接更新。\n\n主要能力:\n- 加载 wiki 状态:并行执行 maestro wiki list --json、health、orphans、hubs --top 10,记录类型分布与基线健康分。\n- 候选识别:孤儿救援(按标题 BM25、标签重叠、同分类/同父级)、双向缺失(A→B 存在但 B→A 缺失)、传递闭包(A→B、B→C 但无 A→C 且共享标签/分类)、类型桥接(不同类型引用同一概念但未链接)、父级聚类(共享父级互不链接)。\n- 评分排序:Score = 0.4 x tag_overlap + 0.3 x title_bm25 + 0.2 x same_category + 0.1 x type_bridge,按 --min-similarity 过滤并降序取 --max 条。\n- 展示与应用:展示评分、原因与预计健康增量;--fix 时通过 request_user_input 让用户确认后,逐条走 get entry → append target to related → maestro wiki update,随后重跑 health 对比变化。\n- 输出:报告写入 .workflow/knowhow/KNW-wiki-connections-{date}.md,图谱洞察追加到 .workflow/specs/learnings.md。\n\n参数:--scope <type> 限定 wiki 类型(spec、knowhow、note、issue,默认全部);--min-similarity N 阈值 0.0-1.0(默认 0.3);--fix 自动应用建议;--max N 最大建议数(默认 20)。\n\n限制:所有文件写入必须限定在 .workflow/knowhow/(连接报告)与 .workflow/specs/learnings.md(图谱洞察);wiki 条目相关字段更新仅能通过 maestro wiki update 完成;禁止改动源码或这些路径之外的任何文件;未使用 -y 时应用前必须人工确认。错误码:E001 未找到 wiki 条目,需初始化内容;W001 无高于阈值的候选,可降低 --min-similarity;W002 --fix 期间部分更新失败,需手动重试;W003 修复后健康分未变化,连接可能不影响特定指标。后续可接 $wiki-digest <topic>、$manage-wiki health、$learn-follow <wiki-id>、maestro wiki graph。