菜单
把一个 GitHub 仓库(远程或本地)转换并富化为符合 OKF v0.1 的知识包(bundle), 让仓库的文档与代码成为 AI 智能体可检索的知识. 适用场景包括为开源项目生成知识库, 把代码仓库变成 agent 可问答的上下文, 建立仓库的架构与 API 知识图谱. 当用户提到 github to okf, 把仓库转 OKF, 为某个 repo 生成知识库, 或导入某个 GitHub 项目为知识时触发.
用 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 可检索的知识时触发.
把任意输入(代码库, 文档, 数据表结构, 笔记)梳理成符合开放知识格式(OKF v0.1)的知识包(bundle), 强调正文质量而不只是结构合规. 适用场景包括从零创建 OKF 知识库, 为代码库生成知识文档, 把零散资料整理为可被 AI 智能体消费的 Markdown 概念库, 校验和修复 bundle 的符合性. 当用户提到 OKF, 开放知识格式, 知识包, knowledge bundle, 或需要把资料整理成 agent 可读的结构化知识时触发.
把符合 OKF v0.1 的知识包打包成单个自包含且经过压缩(minify)的 HTML 文件, 内嵌导航, Markdown 阅读器与概念关系图谱, 数据不出页面, 无需后端. 适用场景包括把 OKF bundle 变成一个可分享的单文件网页, 离线浏览知识库, 生成对标官方 viz.html 的可视化. 当用户提到 okf to web, OKF 转单文件网页, 可视化 OKF, minify 知识库, 或要一个自包含 HTML 时触发.
| name | github-to-okf |
| description | 把一个 GitHub 仓库(远程或本地)转换并富化为符合 OKF v0.1 的知识包(bundle), 让仓库的文档与代码成为 AI 智能体可检索的知识. 适用场景包括为开源项目生成知识库, 把代码仓库变成 agent 可问答的上下文, 建立仓库的架构与 API 知识图谱. 当用户提到 github to okf, 把仓库转 OKF, 为某个 repo 生成知识库, 或导入某个 GitHub 项目为知识时触发. |
| type | Skill |
| title | GitHub to OKF |
| lang | zh |
| tags | ["okf","github","code","skill"] |
| license | MIT |
把一个 GitHub 仓库转成 OKF 知识包,并富化成 agent 真正用得上的项目知识。
owner/repo 或本地路径),想要可检索/可问答的项目知识库;导入(机械):用 github-to-okf 生成基础 bundle。
github-to-okf <owner/repo 或 本地路径> -o ./out [--deep]
产出仓库总览 + 代码概念(带 language、符号、blob 行级 resource)+ 文档概念。
富化(AI,关键) —— 按 code-to-okf 约定 提升正文:
Repository 总览补架构图景:核心模块、数据流、关键设计决策;Module/Function 补 # Behavior(参数/返回/副作用/复杂度)、# Examples;calls: / depends-on: / implements:,形成调用/依赖图谱。取舍:别每个文件都精修;优先公共 API、核心算法、易踩坑处。
校验:../okf-creator/scripts/validate_okf.py ./out。
发布:okf-to-web(单文件可视化)或 okf-to-book(文档站)。
--deep 会触发很多请求,先设 GITHUB_TOKEN;或先 git clone 再用本地模式(更快、能拿 blob 行级 resource);resource 行号锚点用提交 SHA,代码变动后仍有效;