scaccogatto/okf-skills

这是什么？

核心功能

• 01基于内置规范和模板生成并维护 OKF 知识包。
• 02依据规范校验知识包，支持严格模式、警告阈值和 JSON 输出。
• 03将知识包渲染为独立的交互式 HTML 关系图，并显示信任等级与过期状态。
• 04从 git 历史和 Claude 会话记录回填知识包。
• 05提供只读 MCP 服务器，支持搜索、读取概念和查询关联节点。
• 06附带 GitHub Action，可在 CI 中校验知识包。

适用场景

• 将服务架构和设计决策以版本化 Markdown 形式与代码一同维护。
• 为编码智能体提供结构化的项目上下文，便于其读取和引用。
• 在合并前通过 CI 自动校验知识包。
• 为尚无知识包的历史仓库补建项目文档。

快速上手

1. 1

   在 Claude Code 中添加插件市场

   /plugin marketplace add scaccogatto/okf-skills
2. 2

   安装 okf 插件

   /plugin install okf@scaccogatto
3. 3

   让 Claude 生成 OKF 知识包

   /okf:okf produce .okf
4. 4

   提交前验证知识包

   /okf:validate .okf --strict

使用前须知

• !完整工具链专为 Claude Code 设计；其他智能体只能使用技能，无法使用回填所需的子代理。
• !脚本需要安装 uv，或安装带 pyyaml 的 python3。
• !项目尚处于 1.0 之前阶段，因此 @v1 Action 标签可能在版本间发生变化。

收录于专题

标签

常见问题

okf-skills 是什么？

面向 Claude Code 的工具包，用于编写、校验、可视化和维护 OKF（开放知识格式）知识包。 OKF 是一种开放、与厂商无关的知识格式，把系统相关的知识保存为带 YAML frontmatter 的 Markdown 文件目录。本项目让 Claude Code 能在日常工作中生成、维护、读取、校验和可视化 OKF 知识包，并内置依据规范实现的确定性校验器。

okf-skills 可以免费使用吗？用的什么许可证？

okf-skills 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

okf-skills 还在维护吗？

活跃维护中。okf-skills 最近一次提交是在 2026年11月4日。

okf-skills 适合用来做什么？

将服务架构和设计决策以版本化 Markdown 形式与代码一同维护。 为编码智能体提供结构化的项目上下文，便于其读取和引用。 在合并前通过 CI 自动校验知识包。 为尚无知识包的历史仓库补建项目文档。

okf-skills 怎么安装和运行？

在 Claude Code 中添加插件市场: /plugin marketplace add scaccogatto/okf-skills 安装 okf 插件: /plugin install okf@scaccogatto 让 Claude 生成 OKF 知识包: /okf:okf produce .okf 提交前验证知识包: /okf:validate .okf --strict

在哪里获取 okf-skills？

源代码和安装说明在 GitHub 上：https://github.com/scaccogatto/okf-skills