dongshuyan/compass-skills

What it solves

COMPASS Skills는 장시간 실행되는 AI 에이전트 워크플로우에서 상태와 컨텍스트가 손실되는 문제를 해결합니다. 사용자 선호도, 프로젝트 진행 상황 및 작업 의존성을 로컬에서 관리함으로써 전체 대화 기록을 재생할 필요를 없애고, 에이전트가 서로 다른 세션에서도 사용자 목표와 일치하도록 유지합니다.

How it works

이 프로젝트는 AI 코딩 에이전트(예: Claude Code 또는 Codex)에 설치할 수 있는 SKILL.md 패키지 세트를 제공합니다. 이러한 스킬은 Markdown 지시문과 로컬 Python 스크립트를 사용해 특정 워크플로를 구현합니다:

• State Management: 커뮤니케이션 선호도를 저장하는 로컬 사용자 프로필과, 레포지토리 내 작업 그래프(DAG)를 통해 목표와 서브태스크를 추적합니다.
• Alignment: 모호하거나 고위험 작업은 실행 전에 집중 질문을 통해 좁히는 명확화 게이트를 거칩니다.
• Continuity: 현재 대화 상태를 새로운 AI 세션에서 바로 사용할 수 있는 프롬프트로 압축합니다.
• Meta-Programming: 성공적인 실행 기록을 새로운 재사용 가능한 스킬로 전환하거나 실제 증거에 기반해 기존 스킬을 업그레이드하는 도구를 포함합니다.

Who it’s for

복잡하고 장기적인 프로젝트를 관리하며, 컨텍스트를 구조화된 방식으로 유지하고 진행 상황을 추적하며, 에이전트가 원래 목표에서 벗어나지 않도록 하고 싶은 개발자를 위한 것입니다.

Highlights

• Local-First Privacy: 모든 작업 및 프로필 데이터는 로컬에 저장되며 외부 서버로 업로드되지 않습니다.
• Task Forest: 대화 경계를 넘어 지속되는 시각화 가능한 작업 그래프.
• Session Handoff: AI 대화 간 원활한 전환을 위한 특수 프롬프트 생성기.
• Skill Engineering: 관찰된 에이전트 실행 기록으로부터 직접 스킬을 구축하고 다듬는 도구.