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 기록과 세션 기록을 분석하여 지식 번들을 "백필(backfill)"할 수 있습니다.
대상 사용자
AI 코딩 에이전트(Claude Code, Cursor, Codex 등)를 사용하는 개발자 및 팀으로, 에이전트가 실제로 사용하고 유지 관리할 수 있는 구조화된 기계 판독 가능한 방식으로 시스템을 문서화하려는 경우에 적합합니다.
주요 특징
- 멀티 채널 배포: Claude Code 플러그인, skills.sh를 통한 에이전트 스킬, CI 검증을 위한 GitHub Action, 그리고 읽기 전용 MCP server로 제공됩니다.
- 결정론적 검증: v0.1 번들을 v0.2로 마이그레이션할 수 있는 독립형 적합성 검사기가 포함되어 있습니다.
- 지식 백필: 이벤트 분석기 및 bundle-weaver 에이전트 아키텍처를 사용하여 저장소 기록에서 지식 번들을 자동으로 재구성합니다.
- 대화형 시각화: 지식 번들의 독립형 HTML 그래프를 생성하며, 렌더링 시 신뢰도와 최신성 여부를 계산합니다.
- 강제 유지 관리: 추적 중인 파일이 변경되었으나 해당 OKF 문서가 업데이트되지 않은 경우 에이전트가 작업을 완료하지 못하도록 방지하는 선택적 "Stop hook" 기능을 제공합니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트