SuperAPI AI 工具集

loom-maintain

通用与其它

查看项目

更新于 10-15 23:46

技能介绍

用途:对 Loom vault 进行治理,流程为校验→迁移→连接→演进→索引。使用前先阅读 references/schemas.md,以及 <vault-root>/.loom/config.yaml(若存在)。

校验:运行只读健康检查 python3 scripts/scan_vault.py <vault-root> 与 python3 scripts/validate_vault.py <vault-root>,输出含阻塞错误与迁移警告的报告。规则:不写文件;区分阻塞错误与旧版兼容警告,后者视为迁移候选而非失败。

迁移:将旧版 Markdown vault 迁移到 Loom schema。先扫描清点目录、按年份/状态统计笔记数、缺失 frontmatter、状态值、仅链接主题、断链、索引存在性;提出分阶段计划(先初始化索引不改笔记,再为高置信文件补 frontmatter,按需规范化状态值,转换选定仅链接 Topic Notes,最后校验链接与索引一致性)。仅在用户明确要求写入时执行。命令:scan_vault.py、validate_vault.py、build_indexes.py。规则:默认只读,先出报告;保留全部内容与未知 frontmatter;优先增量修改;未经要求不移动资源;写入前汇总将创建/更新/新增字段/保持不变的文件。

Topic Note:将可信研究转为持久主题笔记。输入优先级为 Synthesis Pack、已审阅 Daily Notes、Final/Published Article。流程含结构分解(识别不可约生成器、映射组合、绘制 ASCII 结构图)与深度分层(表层事实→机制→原理→公理,标注确定与不确定处)。输出到 02_Topic_Notes/<Category>/,目录用 Pascal_Case,文件名 YYYY-MM-DD_Title-With-Words.md;更新时递增次版本(1.0.0→1.1.0)。规则:用平静知识库语气;聚焦结构、机制、适用性、边界、相关工作与可复用洞见;不默认使用未审阅草稿;保留仅链接主题;创建或更新后重建索引。

Connect:发现并汇编主题笔记间的结构化连接。默认增量模式,仅比较新增/更新主题,跳过 CONNECTION_INDEX 已有配对;仅在明确要求或无索引时全量扫描。含多视角对照与共享生成器映射。输出到 00_Index/CONNECTION_INDEX.md。连接类型限迁移、混搭、反转;每条洞见须具体可操作;不重复已有配对;最新连接在前。

Evolve:从现有索引生成演进摘要,输入 TIMELINE_INDEX、TOPIC_INDEX、CONNECTION_INDEX。输出月度、季度、年度文件到 03_Content_Output/Longform/。结构含本期新增主题、关键发现、知识演进趋势、跨领域连接发现、附录数据。规则:不重跑连接发现;季度/年度优先复用已有低周期摘要;按周期过滤 CONNECTION_INDEX。

Index Rebuild:重建确定性索引。先试运行 python3 scripts/build_indexes.py <vault-root>,写入加 --write。规则:按精确标题匹配主题并保留行序;索引时不生成新知识洞见;写入前先试运行。

限制:资料未提供具体收费、平台支持范围与效果数据。