scaccogatto/okf-skills
The OKF toolkit for Claude Code — author, maintain, validate & visualize Open Knowledge Format bundles. Plugin, agent skills, and a GitHub Action.
解决的问题
本项目为 Open Knowledge Format (OKF) 提供了一套工具链，这是一种与供应商无关的存储系统知识的方法，将知识存储为带有 YAML frontmatter 的 Markdown 文件目录。它允许人类和 AI 代理维护一个可移植、版本控制的知识库，其中包含用于信任、来源和过时状态的元数据，防止代理依赖过时或未经验证的信息。
运作方式
该工具包实现了 OKF v0.2 规范。它提供了生成、验证和可视化知识包的工具。它使用确定性的合规性检查器来确保知识包符合规范。对于现有项目，它可以透过使用具有专门子代理的 map-reduce 流程分析 git 历史记录和会话记录来“回填”知识包。
目标对象
使用 AI 编码代理（如 Claude Code、Cursor 或 Codex）的开发人员和团队，他们希望以一种结构化、机器可读的方式记录其系统，以便代理能够实际使用和维护。
特色亮点
- 多渠道发布：可作为 Claude Code 插件、透过 skills.sh 的代理技能、用于 CI 验证的 GitHub Action 以及唯读的 MCP server 使用。
- 确定性验证：包含一个独立的合规性检查器，可以将 v0.1 知识包迁移至 v0.2。
- 知识回填：使用事件分析器和 bundle-weaver 代理架构，自动从存储库历史记录中重建知识包。
- 互动式可视化：生成一个自包含的知识包 HTML 图表，并在渲染时计算信任层级和过时状态。
- 强制维护：一个可选的“停止钩子”(Stop hook)，如果追踪的文件已变更但对应的 OKF 文档未更新，则会阻止代理完成任务。
相关
- 项目
- 项目
- 项目
- 项目
- 项目