mcpField
W
wiki-fold

wiki-fold

github.com/agricidaniel生产力15.9k400 次安装6 天前更新
代码仓库

关于 wiki-fold

用于将 wiki/log.md 中一批原始日志条目整理为增量汇总的技能。它保留子条目不变，要求逐项溯源，并默认只生成草稿供审阅。

主要功能

  1. 01按指定范围选择日志条目
  2. 02从来源摘录汇总并标注依据
  3. 03检查条目映射与数字可追溯性
  4. 04预览草稿并可事务式应用

适用场景

  1. 01汇总一批 wiki 日志条目
  2. 02整理多条日志共同呈现的主题
  3. 03在应用前审阅带来源引用的汇总

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/agricidaniel/claude-obsidian --skill wiki-fold

安装后在 Claude Code 中输入/wiki-fold确认已加载。

附带文件references/fold-template.md

详细介绍

提取式日志汇总

对原始 wiki/log.md 条目创建增量汇总。绝不修改、移动或删除子条目或其页面。不要进行汇总的汇总，也不要自动触发汇总。

从此技能的安装位置解析便携核心。按显式 --vault、CLAUDE_OBSIDIAN_VAULT、工作区配置，然后当前目录发现的顺序解析用户知识库。绝不将插件／产品根目录视为知识库。

PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian
CORE="$PRODUCT_ROOT/scripts/claude-obsidian.py"
test -f "$CORE"

此文件中的每个 ../wiki/references/ 链接都以相同方式解析：相对于 $PRODUCT_ROOT 下此技能自身的目录，而不是相对于所选知识库的 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 已存在，则返回无操作结果。替换它需要明确的强制请求，以及单独审核过的 replace 提案。

以提取方式起草

遵循 fold-template.md。每个子日志条目都必须在 frontmatter 中具有一个确定性的 child_key，并且在 Child Entries 表中恰好有一行与之对应。不要按页面去重子条目，但最终的 Child Pages 链接列表可以去重。

每项结果都必须注明其来源条目。每个数字都必须能在所选条目中核实。跨条目主题必须至少注明两个贡献条目。与其臆造，不如使用 ambiguous in source 或 source missing。当子页面与日志条目不一致时，同时保留两者并指出不匹配之处；日志条目是汇总的主要来源。

在提议任何写入之前运行以下检查：

  • ID 确定且条目数准确；
  • frontmatter／表格双射；
  • 数字可追溯；
  • 每项结果和主题均有来源引用；
  • 子条目、来源、来源台账或声明台账均未改变。

汇总不会新增事实证据，因此不会提升声明评估等级，也不会创建来源记录。发现的矛盾应报告以供后续审核，而不是编辑规范声明。

默认预览

返回完整的汇总草稿、ID、子条目范围、读取预算和拟变更路径，不修改知识库。并行 Agent 可以检查子条目并返回摘录，但只能由协调者组装汇总；工作 Agent 绝不写入。

当用户明确要求应用或提交汇总时，构建一个 claude-obsidian.transaction.v1 捆绑包，并设置 operation_type: fold。阅读事务契约。将以下内容一并纳入：

  • wiki/folds/{FOLD_ID}.md，默认使用 create 模式；
  • wiki/index.md 中的汇总目录条目；
  • wiki/log.md 文件顶部新增的一条汇总条目。

不要更新 wiki/hot.md。为全部三个目标记录 SHA-256 前置条件。不要使用主机 Write/Edit、Obsidian 传输写入、已弃用的锁、自动提交，也不要逐个文件应用。

在单次应用前检查：

python3 "$CORE" transaction inspect /path/to/fold-bundle.json --vault /path/to/vault
# Set APPROVAL_SHA256 to the inspect result's approval_sha256 after review.
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

检查所有选定条目，核实可追溯性和数量，然后仅依据子条目实际所述内容扩展汇总。

评论

支持 Markdown