← 전체 기능

도구 확장v0.3.0에서 사용 가능

스킬 선택과 업데이트

스킬은 Claude Code와 Codex가 읽어 들이는 지침 폴더다. oah가 작업 종류, 단계, 위험, Scope의 파일 종류로 지시문마다 스킬을 고르고 스킬마다 이유를 붙인다. 키트 캐시는 리스가 없을 때 하루에 많아야 한 번 업데이트되고, 프로젝트에 추적되는 사본은 oah skills update --project를 실행할 때까지 고정된다.

필요한 상황

작업마다 스킬을 손으로 고르기는 번거롭고, 낡은 스킬은 새 모델을 막거나 결과를 나쁘게 만들 수 있다. 그래서 업데이트는 검사되고 되돌릴 수 있어야 한다.

동작 방식

  1. 선택기는 설치된 Claude와 Codex의 스킬 폴더(사용자, 프로젝트, 플러그인 스킬)와 키트 캐시를 읽고 바꾸지 않는다.
  2. 작업 종류, 단계, 위험, Scope의 파일 종류로 고르고 스킬마다 이유를 붙인다. 지시문에는 고른 스킬의 이름과 경로가 들어가고, [skills] mode = "attach"이면 본문을 넣는다.
  3. 같은 스킬이 두 군데 설치돼 있으면 프로젝트 사본, 키트 캐시, 사용자와 플러그인 사본 순서로 고른다.
  4. [skills] auto_update = true이면 키트 캐시를 update_interval_days(기본 1일)마다 많아야 한 번 확인하고, 리스가 열려 있으면 하지 않는다.
  5. 업데이트는 반영하기 전에 라이선스가 같은지, 읽히는지, 개인정보 스캔을 통과하는지 검사한다. 실패하거나 수상한 업데이트는 마지막으로 성공한 사본을 지키고 보고한다.
  6. 프로젝트 사본은 별도의 리스를 잡는 작업인 oah skills update --project로만 바뀌고, 전역 폴더는 --global과 사용자의 확인이 있을 때만 바뀐다.

예제

업데이트를 확인한 뒤 키트 캐시와 MCP 고정 버전 알림을 새로 고친다(업그레이드 문서).

oah skills update --check
oah skills update
oah doctor

요구 사항

  • 따로 필요한 것은 없다. TypeSafe Jev 재정렬은 선택이다.
  • oah skills schedule install은 사용자의 동의를 받아 자동 확인용 일일 launchd 에이전트(macOS)나 작업 스케줄러 작업(Windows)을 더한다.

한계와 복구

  • Scope가 비어 있으면 조용히 아무것도 고르지 않는 대신 OAH_SCOPE_EMPTY로 경고한다.
  • 재정렬기는 순서만 바꾸고 스킬을 더하거나 빼지 않는다.
  • unlazy는 oah 게이트를 검증한 커밋에 머물고 스킬 업데이트는 이것을 옮기지 않는다.
  • 스킬 하나를 그대로 두려면 [skills]에 pins = ["<name>"]를 적는다.
  • 툴킷 문서는 oah start 같은 일반 명령에 자동 확인을 잇는 일을 후속 작업으로 적는다. 그때까지는 스킬을 바꾸는 명령이나 일정 등록을 쓴다.

원문 문서

관련 기능