菜单
把任意输入(代码库, 文档, 数据表结构, 笔记)梳理成符合开放知识格式(OKF v0.1)的知识包(bundle), 强调正文质量而不只是结构合规. 适用场景包括从零创建 OKF 知识库, 为代码库生成知识文档, 把零散资料整理为可被 AI 智能体消费的 Markdown 概念库, 校验和修复 bundle 的符合性. 当用户提到 OKF, 开放知识格式, 知识包, knowledge bundle, 或需要把资料整理成 agent 可读的结构化知识时触发.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
把 GitHub 上的 awesome-xx 精选列表转换并富化为符合 OKF v0.1 的知识包(bundle), 让社区海量教程和资源列表成为 AI 智能体可检索的知识. 适用场景包括把某个 awesome 列表导入为 OKF, 为列表里的条目补充结构化正文, 校验产物符合性. 当用户提到 awesome 列表, GitHub 精选列表转 OKF, 或想把某个 awesome-xx 变成知识库时触发.
把符合 OKF v0.1 的知识包或项目发布为可视化的文档站(VitePress, Vue 系, 亮色主题), 带侧边栏导航与概念互链. 适用场景包括把一个 OKF bundle 变成可浏览的网站或电子书, 为知识库生成文档门户, 把任意 OKF 项目发布为静态站点. 当用户提到把 OKF 发布成文档站, OKF 转网站或电子书, 可视化知识库, 或为 bundle 生成 docs 站时触发.
把长文, 书稿, 讲义或系列文章拆解为符合 OKF v0.1 的知识包(bundle), 按章节, 概念, 人物, 术语建立互链的概念页. 适用场景包括把一本书或长文档转成结构化知识库, 为写作素材建立可检索的概念网络, 把教程系列整理为 OKF. 当用户提到把书或长文转成 OKF, 拆书, 建立读书知识库, 或为书稿建概念库时触发.
把源代码仓库转换为符合 OKF v0.1 的知识包(bundle), 用一套代码表示约定(类型词表, language/symbol/signature 字段, 行号锚点, 有类型链接)弥补 OKF 对代码的薄弱支持. 适用场景包括为代码库生成 agent 可读的知识文档, 把仓库的模块函数类整理为概念库, 建立代码知识图谱. 当用户提到 code to okf, 代码库转 OKF, 为代码生成知识, 或把仓库变成 agent 可检索的知识时触发.
把一个 GitHub 仓库(远程或本地)转换并富化为符合 OKF v0.1 的知识包(bundle), 让仓库的文档与代码成为 AI 智能体可检索的知识. 适用场景包括为开源项目生成知识库, 把代码仓库变成 agent 可问答的上下文, 建立仓库的架构与 API 知识图谱. 当用户提到 github to okf, 把仓库转 OKF, 为某个 repo 生成知识库, 或导入某个 GitHub 项目为知识时触发.
把符合 OKF v0.1 的知识包打包成单个自包含且经过压缩(minify)的 HTML 文件, 内嵌导航, Markdown 阅读器与概念关系图谱, 数据不出页面, 无需后端. 适用场景包括把 OKF bundle 变成一个可分享的单文件网页, 离线浏览知识库, 生成对标官方 viz.html 的可视化. 当用户提到 okf to web, OKF 转单文件网页, 可视化 OKF, minify 知识库, 或要一个自包含 HTML 时触发.
| name | okf-creator |
| description | 把任意输入(代码库, 文档, 数据表结构, 笔记)梳理成符合开放知识格式(OKF v0.1)的知识包(bundle), 强调正文质量而不只是结构合规. 适用场景包括从零创建 OKF 知识库, 为代码库生成知识文档, 把零散资料整理为可被 AI 智能体消费的 Markdown 概念库, 校验和修复 bundle 的符合性. 当用户提到 OKF, 开放知识格式, 知识包, knowledge bundle, 或需要把资料整理成 agent 可读的结构化知识时触发. |
| type | Skill |
| title | OKF Creator |
| lang | zh |
| tags | ["okf","skill","知识库","代码"] |
| license | MIT |
把任意输入整理成符合 OKF v0.1 且正文质量过关的知识包。OKF 的硬要求极低(任何带 type 的 Markdown 就合规),所以本 Skill 的真正价值不在"产出合规文件",而在"产出读了就懂、agent 检索得动的知识"。
# Schema、# Examples、# Citations 三个标题——适用就用。/path/to/x.md。scripts/scaffold_okf.py 生成骨架(根 index.md + log.md + 目录)。type 必填)+ 结构化正文 + 交叉链接 + 必要的 # Citations。index.md(渐进式展开)与根 log.md。scripts/validate_okf.py <bundle> 校验,修到 0 错误。---
type: <必填,概念种类> # 唯一硬要求
title: <显示名>
description: <一句话摘要> # 强烈建议:索引/搜索靠它
resource: <底层资产 URI> # 抽象概念可省略
tags: [<标签>, ...]
timestamp: <ISO 8601>
lang: zh # 本仓库 i18n 约定(可选扩展)
---
详细字段、保留文件名、链接规则见 references/okf-spec-cheatsheet.md。
type 用 Repository|Package|Module|Class|Function|Interface|Config|Script|Notebook;加扩展字段 language、symbol、signature;resource 用 GitHub permalink 带行号锚点 #L10-L40;关系链接用 calls: / depends-on: / deprecated-by: 前缀。正文必写 # Signature 和行为说明,别只贴代码。assets/,正文承载抽取出的文本/表格,# Source 注明页码。assets/,正文写图说 / OCR 文本(用多模态模型生成),否则图里的知识 agent 读不到。 嵌入就完事,不写图说;validate_okf.py。scripts/scaffold_okf.py — 生成空 bundle 骨架。scripts/validate_okf.py — OKF v0.1 符合性校验(可独立使用)。awesome-to-okf — 专门把 GitHub awesome 列表转成 OKF。book-to-okf — 把长文 / 书稿拆成 OKF 概念库。okf-to-book — 把 OKF bundle 发布为可视化文档站。