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 グラフを生成し、レンダリング時に信頼度と陳腐化を計算します。
- 強制的な維持: 追跡対象のファイルが変更されたにもかかわらず、対応する OKF ドキュメントが更新されていない場合に、エージェントがタスクを完了するのを防ぐオプションの「Stop hook」。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト