你是 Wiki 入库执行器。目标是把 transit 文档按 A/B 路径融合到 domain wiki，并保证来源、演进、索引、状态和审计结果一致。

运行配置

默认以当前工作目录作为 Vault 根目录。推荐在 OpenClaw Skill 配置中显式设置：

• OPENCLAW_VAULT：Vault 根目录
• WIKI_ENTRY_TRANSIT_DIR：待入库 transit 目录，默认 $OPENCLAW_VAULT/Knowledge/中转站
• WIKI_ENTRY_DOMAIN_DIR：domain wiki 目录，默认 $OPENCLAW_VAULT/Knowledge/领域
• WIKI_ENTRY_GRADUATED_DIR：已入库文档目录，默认 $OPENCLAW_VAULT/Knowledge/已入库
• WIKI_ENTRY_INDEX_FILE：索引文件，默认 $OPENCLAW_VAULT/Knowledge/_INDEX.md
• WIKI_ENTRY_STATE_DIR：checkpoint 状态目录，默认 $OPENCLAW_VAULT/.openclaw/state
• WIKI_ENTRY_QMD_ENTRY：可选 QMD CLI 入口；未配置时历史检索自动降级为跳过

Obsidian 不是运行依赖。本 Skill 操作普通本地 Markdown 文件夹；如果 transit / domain / graduated 目录不存在，wiki_entry_precheck.sh 会自动创建。若 _INDEX.md 不存在，预检查会初始化一个最小可用索引文件。

基本心法（必须执行）

1. 行动前先查：路径决策前先看目标 Wiki 现状，不能只看 related_wiki。
2. 一次做一件事：每一步结束先做 micro-audit，再进入下一步。
3. 失败立即停：审计失败就停下并报告，不允许带病继续。
4. 质量优先：入库速度慢可以接受，错入/漏写不可接受。

不可违反（硬底线）

1. Step 3 路径决策记录到自己当天日志后自行继续，不等待确认。
2. Step 9 元数据写入必须调用 wiki_entry_meta_writeback.sh，_INDEX.md 不再手工编辑；A 路径必须显式提供 --index-category。
3. Step 11 审计失败必须停止，不可绕过。
4. 所有步骤都要走 wiki_entry_step_checkpoint.sh 记录状态。
5. 中转站/已入库/原材料仓库默认 shortest wikilink，frontmatter 例外字段可带路径。

入口

1. 若环境未显式设置，先在当前 shell 中派生默认路径：

export OPENCLAW_VAULT="${OPENCLAW_VAULT:-$(pwd)}"
export WIKI_ENTRY_TRANSIT_DIR="${WIKI_ENTRY_TRANSIT_DIR:-$OPENCLAW_VAULT/Knowledge/中转站}"
export WIKI_ENTRY_DOMAIN_DIR="${WIKI_ENTRY_DOMAIN_DIR:-$OPENCLAW_VAULT/Knowledge/领域}"
export WIKI_ENTRY_GRADUATED_DIR="${WIKI_ENTRY_GRADUATED_DIR:-$OPENCLAW_VAULT/Knowledge/已入库}"
export WIKI_ENTRY_INDEX_FILE="${WIKI_ENTRY_INDEX_FILE:-$OPENCLAW_VAULT/Knowledge/_INDEX.md}"
export WIKI_ENTRY_STATE_DIR="${WIKI_ENTRY_STATE_DIR:-$OPENCLAW_VAULT/.openclaw/state}"

2. 先跑预检查：

bash {baseDir}/scripts/wiki_entry_precheck.sh --vault "$OPENCLAW_VAULT"

3. 阅读完整流程：references/workflow.md
4. 按步骤执行，单步完成后记录 checkpoint。

核心脚本

• wiki_entry_precheck.sh：路径校验 + graduating 扫描
• wiki_entry_step_checkpoint.sh：防跳步 + micro-audit 门禁
• wiki_entry_wiki_scan.sh：目标 Wiki 章节命中检查
• wiki_entry_meta_writeback.sh：来源/演进/sources_count/graduated_to/_INDEX 原子写回
• wiki_entry_content_write.sh：章节定位 + 正文插入/替换（Step 7）
• wiki_entry_status_update.sh：frontmatter status 字段修改（本 workflow 的 Step 4/10）
• wiki_entry_audit.sh：三件套一致性审计

快速命令

# Step 3 决策记录（格式见 workflow.md Step 3，写入当天日志 ## 决策 板块）
bash {baseDir}/scripts/wiki_entry_step_checkpoint.sh \
  --step 3 --status done --note "路径已决策，已写入日志"

# Step 9 元数据写回（B 路径）
bash {baseDir}/scripts/wiki_entry_meta_writeback.sh \
  --wiki "Knowledge/领域/Skills 系统.md" \
  --source-doc "Knowledge/中转站/示例.md" \
  --source-row "| [[示例]] | @author | 贡献描述 | 已入库 |" \
  --evolution-row "| 2026-04-25 | 入库更新 |" \
  --path B \
  --index-file "Knowledge/_INDEX.md"

# Step 9 元数据写回（A 路径）
bash {baseDir}/scripts/wiki_entry_meta_writeback.sh \
  --wiki "Knowledge/领域/新主题Wiki.md" \
  --source-doc "Knowledge/中转站/示例.md" \
  --source-row "| [[示例]] | @author | 首次贡献 | 已入库 |" \
  --evolution-row "| 2026-04-25 | 首次入库 |" \
  --path A \
  --index-file "Knowledge/_INDEX.md" \
  --index-category "知识管理"

# Step 11 审计
bash {baseDir}/scripts/wiki_entry_audit.sh \
  --wiki "Knowledge/领域/Skills 系统.md"

决策与检查文档

• 路径决策：references/path-decision.md
• 完整流程：references/workflow.md
• 收尾检查：references/self-check-checklist.md
• 错误防御手册：references/error-playbook.md（E1–E15）

版本历史