ONEDEV

compass-skills

dongshuyan파일 163개

★ 728주당 +9조회 4

무엇인가

COMPASS Skills는 AI 에이전트가 장기 작업을 수행할 때 흩어지는 다섯 종류의 상태(사용자 맥락, 프로젝트 맥락, 목표 맥락, 중단 맥락, 인계 맥락)를 로컬 파일과 절차로 붙잡아 두는 규율 체계다. 실행 협업, 스킬 엔지니어링, 학술 문체, 채용 지원이라는 서로 다른 작업 영역을 각각 독립된 스킬로 분리해 두고, 에이전트가 해당 상황에서만 그 규칙을 따르게 한다.

어떻게 동작하나

각 스킬은 `skills/` 아래 폴더 하나에 `SKILL.md`를 두는 형식이며, 폴더마다 `references/`, `scripts/`, `assets/`, `evals/`, `agents/` 하위 디렉터리를 함께 유지한다. 발동은 대화 중 `$task-clarifier`, `$task-forest`, `$pause-and-resume`, `$session-handoff-prompt`, `$user-profile-keeper`, `$run-history-skill-builder`, `$run-history-skill-upgrader`, `$academic-humanizer`, `$assess-interview-candidate`처럼 이름을 직접 호출하는 방식이다. `task-clarifier`는 모호하거나 고비용·고위험·외부 노출 작업의 진입점으로, 사용자가 소유한 결정을 먼저 식별하고 1~3개의 초점 질문을 권장 답과 함께 제시한 뒤에야 검색이나 실행으로 넘어간다. `run-history-skill-upgrader`는 실제 실행 세션의 증거, 해결된 난점, 검증 결과, 사용자 피드백을 읽어 업그레이드 계획까지만 만들고 멈추며, 계획이 명시적으로 승인된 뒤에만 파일을 수정한다.

무엇과 다른가

프롬프트를 매번 직접 작성하거나 단일 `CLAUDE.md`·`AGENTS.md`에 규칙을 몰아넣는 방식과 달리, 이 묶음은 상태를 대화 기록이 아니라 로컬 산출물에 둔다. `user-profile-keeper`는 협업 선호와 위험 경계를 로컬 프로필로 남기고, `task-forest`는 대화 경계를 넘어 살아남는 저장소 로컬 작업 그래프를 기록하며, `pause-and-resume`은 같은 대화가 유지될 때의 안전 중단 지점을, `session-handoff-prompt`는 새 대화로 옮길 때의 붙여넣기용 프롬프트를 담당한다. 두 스킬은 대체재가 아니라 대화가 유지되는지 여부에 따라 갈리는 별개 경로다. 또한 `run-history-skill-builder`는 기존 스킬 수정 요청을 받으면 직접 편집하지 않고 해당 작업을 넘긴다.

어떻게 쓰나

설치 전 목록 확인은 `npx skills add dongshuyan/compass-skills --list`로 하고, Claude Code에 전체를 넣으려면 `npx skills add dongshuyan/compass-skills --skill '*' -a claude-code`를 실행한다. Codex와 Claude Code 양쪽에 넣으려면 `-a codex -a claude-code`를 함께 지정한다. 수동 설치 시에는 `skills/` 아래 폴더들을 에이전트의 로컬 스킬 디렉터리로 복사하되 하위 디렉터리를 그대로 유지해야 하며, 설치 후에는 대화에서 `$` 이름으로 바로 호출한다.

전제와 한계

동작 전제는 `SKILL.md`를 읽는 에이전트이며 README 기준 Claude Code를 대상으로 하고 Codex 설치도 함께 지원한다. `assess-interview-candidate`는 오프라인 HTML에 후보 개요, 직무 관련 이력서 불확실성, 12~18개의 질문만 노출하고 자동 채용·탈락·순위 결정을 승인하지 않는다. `academic-humanizer`는 주장·근거 강도·인용·수식·기술명·양태·논리·범위를 보존하는 선에서 AI 같은 문체를 줄이는 것을 목표로 하며 작성자 판정을 보증하지 않는다. 프로필에는 비밀이 들어가지 않아야 하고, 현재 파일·로그·사용자 제공 맥락이 항상 우선 권위를 가진다.

관련 논문 1

유사 스킬