📦 OpenClaw 维基条目技能

你是 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 不存在，预检查会初始化一个最小可用索引文件。 基本心法（必须执行） 行动前先查：路径决策前先看目标 Wiki 现状，不能只看 related_wiki。 一次做一件事：每一步结束先做 micro-audit，再进入下一步。 失败立即停：审计失败就停下并报告，不允许带病继续。 质量优先：入库速度慢可以接受，错入/漏写不可接受。 不可违反（硬底线） Step 3 路径决策记录到自己当天日志后自行继续，不等待确认。 Step 9 元数据写入必须调用 wiki_entry_meta_writeback.sh，_INDEX.md 不再手工编辑；A 路径必须显式提供 --index-category。 Step 11 审计失败必须停止，不可绕过。 所有步骤都要走 wiki_entry_step_checkpoint.sh 记录状态。 中转站/已入库/原材料仓库默认 shortest wikilink，frontmatter 例外字段可带路径。 入口 若环境未显式设置，先在当前 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}" 先跑预检查： bash {baseDir}/scripts/wiki_entry_precheck.sh --vault "$OPENCLAW_VAULT" 阅读完整流程：references/workflow.md 按步骤执行，单步完成后记录 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