Jangpm Meta Skills (Claude Code & Codex용)

Claude Code와 Codex에서 에이전트 시스템 설계, 요구사항 구체화, 세션 마무리, 스킬 자동 최적화를 위한 메타 스킬 모음.

• Claude Code 배포: .claude/
• Codex 배포: .codex/skills/ 또는 사용자 전역 ~/.codex/skills/

스킬 목록

스킬 워크플로우

네 가지 스킬은 다음 순서로 함께 사용할 때 가장 효과적입니다:

blueprint → deep-dive → [구현] → autoresearch → reflect

상황별 간단 패턴:

• 새 프로젝트: blueprint → deep-dive → 구현 → autoresearch → reflect
• 중간 기능 추가: deep-dive → 구현 → reflect
• 스킬 최적화만: autoresearch 단독 실행
• 세션 마무리만: reflect 단독 실행
• 버그 수정 직후: 구현 → 구체적 fix 확인 문맥에서 reflect의 빠른 학습 캡처

디렉토리 구조

.claude/
  skills/
    autoresearch/
      SKILL.md
      references/
        dashboard-guide.md     # 실행 중 실시간 HTML 대시보드
        eval-guide.md          # 이진/비교 평가 작성 방법
        execution-guide.md     # 실행 루프 동작 방식
        logging-guide.md       # results.json / results.tsv 스키마
        mutation-guide.md      # 프롬프트·자산·실행 코드 변형 전략 (L1/L2a/L2b/L3)
        pipeline-guide.md      # 전체 파이프라인 개요
        worked-example.md      # 주석 포함 엔드투엔드 예시
    blueprint/
      SKILL.md
      references/
        document-template.md   # 출력 문서 섹션별 템플릿
        design-principles.md   # 에이전트 구조 및 설계 원칙
        example-blueprint.md   # 주석 포함 샘플 블루프린트
      scripts/
        validate_blueprint_doc.py  # 블루프린트 문서 구조 검증 스크립트
    deep-dive/
      SKILL.md
      references/
        question-library.md
        agent-design-questions.md
        anti-patterns.md
        reviewer-checklist.md
    reflect/
      SKILL.md

.codex/
  skills/
    autoresearch/
      SKILL.md
      agents/openai.yaml       # Codex UI 메타데이터
      references/              # (Claude Code와 동일)
    blueprint/
      SKILL.md
      agents/openai.yaml
      references/
      scripts/
    deep-dive/
      SKILL.md
      agents/openai.yaml
      references/
    reflect/
      SKILL.md
      agents/openai.yaml

.codex/
  agents/
    reviewer.toml             # optional: create only when you need a custom subagent
    explorer.toml             # optional: create only when you need a custom subagent

설치 (Codex)

네 개의 스킬 폴더를 ~/.codex/skills/에 복사합니다.

Windows PowerShell

Copy-Item -Recurse .\.codex\skills\autoresearch "$env:USERPROFILE\.codex\skills\"
Copy-Item -Recurse .\.codex\skills\blueprint   "$env:USERPROFILE\.codex\skills\"
Copy-Item -Recurse .\.codex\skills\deep-dive   "$env:USERPROFILE\.codex\skills\"
Copy-Item -Recurse .\.codex\skills\reflect     "$env:USERPROFILE\.codex\skills\"

macOS / Linux

mkdir -p ~/.codex/skills
cp -r ./.codex/skills/autoresearch ~/.codex/skills/
cp -r ./.codex/skills/blueprint    ~/.codex/skills/
cp -r ./.codex/skills/deep-dive    ~/.codex/skills/
cp -r ./.codex/skills/reflect      ~/.codex/skills/

설치 (Claude Code)

Claude Code 배포 방식도 동일하게 지원됩니다.

Windows PowerShell

Copy-Item -Recurse .\.claude\skills\autoresearch "$env:USERPROFILE\.claude\skills\"
Copy-Item -Recurse .\.claude\skills\blueprint   "$env:USERPROFILE\.claude\skills\"
Copy-Item -Recurse .\.claude\skills\deep-dive   "$env:USERPROFILE\.claude\skills\"
Copy-Item -Recurse .\.claude\skills\reflect     "$env:USERPROFILE\.claude\skills\"

macOS / Linux

cp -r ./.claude/skills/autoresearch ~/.claude/skills/
cp -r ./.claude/skills/blueprint    ~/.claude/skills/
cp -r ./.claude/skills/deep-dive    ~/.claude/skills/
cp -r ./.claude/skills/reflect      ~/.claude/skills/

Codex vs Claude Code 차이점

• 이 저장소는 SKILL.md 중심의 스킬 폴더로 두 플랫폼 배포를 모두 제공합니다. Claude 슬래시 커맨드(/commands) 래퍼 파일은 포함하지 않습니다.
• .claude/... 경로, Task 기반 서브에이전트, AskUserQuestion 처리를 Codex 흐름에 맞게 조정했습니다.
• blueprint는 Codex 호환 문서 템플릿, 설계 원칙, 구조 검증 스크립트를 포함합니다.
• autoresearch는 Claude Code와 Codex 양쪽에서 동일한 기능을 제공합니다. Codex에서는 명시적 위임 승인이 있는 기본 순차 실행 모델을 따릅니다.
• Codex 배포에는 각 스킬 폴더에 선택적 UI 메타데이터를 담은 agents/openai.yaml 파일이 포함됩니다.
• 공개 배포용 기본 정책으로 blueprint, deep-dive는 암묵 호출을 허용하고, reflect는 명시 호출과 구체적 fix confirmation 문맥에서의 제한적 암묵 호출을 함께 허용합니다. autoresearch는 명시 호출($autoresearch)만 허용합니다.
• Codex의 커스텀 서브에이전트는 스킬 폴더가 아니라 .codex/agents/*.toml에 정의해야 합니다.
• 이 저장소는 커스텀 서브에이전트를 아직 포함하지 않으므로 .codex/agents/ 디렉터리는 기본적으로 체크인하지 않습니다. 필요할 때만 .codex/agents/를 추가하면 됩니다.

라이선스

MIT