Agent Skills
返回列表
LangWIKI OKF 知识包转换

LangWIKI OKF 知识包转换

知识管理 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_8faf063b/langwiki。

技能介绍

要解决什么问题

团队手里往往堆着 PDF、Office、Markdown、代码和配置，知识散落在不同路径或远程 API 里。人读起来费劲，Agent 也难稳定引用。OKF（Open Knowledge Format）把知识收成一个目录 + 带 YAML 头的 Markdown，便于人工维护、智能体生成和跨组织交换。本技能封装基于 Google Knowledge Catalog 扩展的 reference-agent，并配套 agent_pipeline.py，把「大模型处理」和「执行流程」拆开，方便在 Agent 会话里按步编排与回退。

技能如何工作

输入与数据源：支持从 16 种常见格式（含 PDF/Word/Excel/PPT/Markdown/代码/HTML/CSV 等）生成 OKF 知识包；可按场景选 localfile、远程 URL、enrich --source api 或本地与远程混合。Unicode 文件名与语言自动匹配面向中文、日文等实际目录。

LLM 与编排：API 路径统一依赖 skill 变量 OKF_API_MODEL、OKF_API_BASE、OKF_API_KEY（可用 --model 覆盖），未配置时需先提示用户完成 export，不再回退会话默认模型或其它环境变量。agent_pipeline.py 提供 cli / api / auto 三种模式，把文档提取、Prompt 构建、模型调用、落盘与 OKF 校验分步执行。

产出与校验：可生成交互式 HTML 知识图谱；用 validate_bundle.py 对照 OKF v0.1 检查 frontmatter、type 字段及 index.md / log.md 等。默认 no-clone 内置 vendor/reference_agent，由 bootstrap_local.sh 准备 Python 3.11+ 与本地 CLI 包装器。

适用边界与注意点

  • Office/PDF 等格式需额外文档解析依赖；完全离线可走 Ollama，需本机 ollama serve。
  • Gemini 等 API 可能 429：可先等待重试，或用 agent_pipeline.py --mode auto 做分片重试；仅在用户明确要求时再引导单独配置 Key。
  • 扫描时会自动跳过 .git、.venv、node_modules、okf-bundle 等目录，避免把已生成的 OKF 再当源文件递归处理。

使用场景

  • 项目目录里混有 PDF、Word、Markdown 与代码，需要一次性打成带 YAML 头的 OKF 包供 Agent 按概念引用。
  • 远程 API 返回文档 URL 或文件列表，需要下载并与本地路径合并进同一个 OKF 知识包。
  • 要把 OKF 包交给其他团队或入库前，需要跑校验确认 frontmatter、`type` 与 index 符合 v0.1。
  • OKF 生成完成后，需要从概念文档生成交互式 HTML 知识图谱，查看交叉链接与主题结构。

适合人员

  • 维护内部 Wiki 与政策 PDF，希望把多格式资料统一成 Agent 可读的 OKF 目录的知识库管理员。
  • 对接企业文档 API、同时处理本地仓库与远程 URL 混合数据源的平台或数据工程师。
  • 在 Agent 会话里用 `agent_pipeline.py` 分步编排抽取、模型调用与落盘，并处理 429 重试的集成开发者。
  • 负责培训或研究资料归档、需将 PPT/Word 讲义批量结构化后跨组织交换 OKF 包的课程或项目负责人。