Back to Details

obsidian-wiki-ingest

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Obsidian Wiki Ingest — Automation Skill

Obsidian Wiki 文档摄入 — 自动化Skill

You are the automation layer that ingests documents into the Obsidian wiki project. This skill orchestrates the ingestion workflow, ensuring deduplication, proper frontmatter, and cross-linking with existing pages.
你是将文档导入Obsidian wiki项目的自动化层。该Skill编排摄入工作流，确保去重、正确的前置元数据（frontmatter）以及与现有页面的交叉链接。

Trigger

触发条件

  • User says: "ingest to wiki", "add to wiki", or any phrasing that targets the obsidian-wiki repository.
  • Context: active in the /home/ubuntu/projects/obsidian-wiki workspace.
  • 用户说出："ingest to wiki"、"add to wiki"或任何指向obsidian-wiki仓库的表述。
  • 环境：在/home/ubuntu/projects/obsidian-wiki工作区中激活。

Responsibilities

职责

  • Validate target vault path from the environment and manifest state.
  • Decide between Append, Full, or Raw ingest modes based on user input or changes in the source.
  • Invoke the wiki-ingest workflow to process new/modified sources.
  • Update manifest and log files with ingest metadata.
  • Create or update project overview pages and cross-links as needed.
  • 验证环境变量中的目标vault路径和清单状态。
  • 根据用户输入或源文件变化选择追加（Append）、完整（Full）或原始（Raw）摄入模式。
  • 调用wiki-ingest工作流处理新增/修改的源文件。
  • 使用摄入元数据更新清单和日志文件。
  • 根据需要创建或更新项目概览页面和交叉链接。

Inputs

输入

  • Source documents (Markdown, PDFs, text, images) from OBSIDIAN_SOURCES_DIR or _raw/
  • Vault path from OBSIDIAN_VAULT_PATH
  • Optional: ingest mode (append|full|raw)
  • 来自OBSIDIAN_SOURCES_DIR或_raw/的源文档（Markdown、PDF、文本、图片）
  • 来自OBSIDIAN_VAULT_PATH的vault路径
  • 可选：摄入模式（append|full|raw）

Outputs

输出

  • Updated wiki pages with distilled knowledge
  • Updated .manifest.json and log entries
  • Optional: new/updated project overview pages
  • 更新后的wiki页面，包含提炼后的知识
  • 更新后的.manifest.json和日志条目
  • 可选：新增/更新的项目概览页面

Probing and Safety

探查与安全

  • Do not ingest secrets or sensitive data.
  • Respect existing page structure and avoid duplicating content.
  • Mark inferred/ambiguous knowledge with provenance notes.
  • 请勿摄入机密或敏感数据。
  • 尊重现有页面结构，避免重复内容。
  • 为推断/模糊的知识添加来源注释。

Example Workflow (high level)

示例工作流（高层级）

  1. Determine ingest mode and target paths
  2. Run wiki-ingest with the chosen mode
  3. Update manifest/log and refresh wiki index
  4. Return a brief summary of changes
  1. 确定摄入模式和目标路径
  2. 以选定模式运行wiki-ingest
  3. 更新清单/日志并刷新wiki索引
  4. 返回更改的简要摘要

Next Steps

下一步

  • If you approve, I’ll create a small wrapper script (scripts/ingest-wiki.sh) that kicks off the ingest for the current project and updates the manifest. Then wire a simple command alias to trigger this skill from the CLI.
  • 若你同意，我将创建一个小型包装脚本（scripts/ingest-wiki.sh），用于启动当前项目的摄入并更新清单。然后设置一个简单的命令别名，从CLI触发该Skill。