OpenClaw Wiki Entry Skill

Use when the operator asks to merge compiled transit notes into domain wiki pages with source metadata, index updates, status transitions, and audit checks....

你是 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）

版本历史

版本	日期	变更
c-v6	2026-04-28	Step 3 决策日志从独立文件改为写入执行者自己当天日志（memory/YYYY-MM-DD.md）
c-v5	2026-04-27	修正文档编号漂移：path-decision 移除等待确认残留；workflow 补全 Step 10 状态收口；SKILL 明确 status_update.sh 用于 Step 4/10
c-v4	2026-04-26	Step 4/7 脚本化：新增 content_write.sh + status_update.sh，消除 LLM Edit 依赖
c-v3	2026-04-26	Step 3 硬底线从"等待确认"改为"决策日志模式"，workflow.md 同步
c-v2	2026-04-26	wiki_entry_audit.sh wikilink 路径修复：新增 Knowledge/领域/ + 目录引用回退（E15）
c-v1	2026-04-25	首版正式上线：12 步流程 + 7 个脚本护栏 + error-playbook E1–E14