SuperAPI AI 工具集

wiki-fold

办公与效率

查看项目

更新于 10-15 16:43

技能介绍

用途:对 wiki/log.md 的原始条目生成增量汇总(fold),不修改、移动或删除子条目及其页面,不执行 fold 的 fold,也不自动触发 fold。

定位仓库:按显式 --vault、CLAUDE_OBSIDIAN_VAULT、工作区配置、当前目录发现的顺序解析用户仓库;插件/产品根目录不能当作仓库。核心脚本路径示例:PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian,CORE="$PRODUCT_ROOT/scripts/claude-obsidian.py",需先用 test -f "$CORE" 确认存在。文件内 ../wiki/references/ 链接相对本技能目录解析,不相对所选仓库的 wiki/ 目录。无需联网,不调用外部服务。

选择范围:以批次指数 k 确定大小 2^k,默认 k=4,也可用显式条目范围覆盖。可用条目不足时报告缺口并停止,不做部分批次。完整读取所选日志条目;仅当日志上下文不足时读取被引用的子页面,目标 0–10 次、上限 15 次;缺失页面保留为 page_missing 记录。结构 ID 仅由输入推导:fold-k{K}-from-{EARLIEST-DATE}-to-{LATEST-DATE}-n{COUNT}。若 wiki/folds/{FOLD_ID}.md 已存在则返回空操作,替换需显式 force 请求和单独审核的替换提案。

草稿:遵循 fold-template.md,每个子日志条目在 frontmatter 中有确定 child_key,并在 Child Entries 表中有且仅有一行对应;不按页面去重子条目,最终 Child Pages 链接列表可去重。每个结果须注明来源条目,每个数字须可在所选条目中验证,跨条目主题须至少指明两个贡献条目。歧义或来源缺失优先标注而非编造。子页面与日志冲突时两者都保留并标明不一致,日志条目为 fold 的主要来源。写入前检查:确定性 ID 与确切条目数、frontmatter/表格双射、数字可追溯、每个结果与主题均有来源引用、不得改动子条目、来源、来源台账或主张台账。fold 不新增事实证据,不升级主张评估,不创建来源记录;发现的矛盾应报告以供后续审查。

默认预览:返回完整 fold 草稿、ID、子范围、读取预算和拟变更路径,不修改仓库。并行代理可检查子条目并返回摘录,但只有编排者组装 fold,worker 永不写入。

应用(仅用户明确要求时):构建一个 claude-obsidian.transaction.v1 包,operation_type: fold,并耦合 wiki/folds/{FOLD_ID}.md(默认 create 模式)、wiki/index.md 中的 fold 目录条目、wiki/log.md 顶部一条新 fold 条目。不要更新 wiki/hot.md;记录三个目标的 SHA-256 前置条件。不要使用宿主 Write/Edit、Obsidian 传输写入、已弃用的锁、自动提交或每文件一次 apply。

检查与应用示例:python3 "$CORE" transaction inspect /path/to/fold-bundle.json --vault /path/to/vault,然后在审核后设置 APPROVAL_SHA256 为 inspect 结果的 approval_sha256,再执行 python3 "$CORE" transaction apply /path/to/fold-bundle.json --vault /path/to/vault --approved-plan-sha256 "$APPROVAL_SHA256"。报告操作 ID 和确切变更路径。相同包与 ID 幂等;退出码 75 时重新读取重建;中断后用 transaction recover。Git 历史为单独可选操作:python3 "$CORE" checkpoint OPERATION_ID --vault /path/to/vault。限制:未提供额外平台、收费、价格或效果信息。