Community코딩 & 개발github.com

SebastienElet/agent-skills

Codex나 Cursor가 Claude로 작업을 전달해야 하거나, 수동 반복을 위해 Claude Code의 결과를 반환할 때 Claude Code를 직접 호출하지 않고 수동 구현 및 교정 프롬프트를 준비합니다.

agent-skills란 무엇인가요?

이 기술(Agent Skill)은 개발자가 수동으로 Claude Code에 작업을 전달(handoff)해야 할 때 필요한 **시작 명령어**와 **자체 포함된 프롬프트**를 준비하는 방법을 제공합니다. 주로 Cursor나 Codex 같은 다른 AI 에이전트가 작업을 Claude로 위임해야 하거나, 수동 반복 작업을 위해 Claude Code의 결과를 다시 입력해야 할 때 사용됩니다. 이 기술은 자동으로 Claude를 호출하지 않고, 대신 사용자가 직접 실행할 CLI 명령어와 붙여넣을 프롬프트를 생성하여 완전한 수동 제어를 보장합니다. 구현 및 교정 프롬프트는 `claude-development` 기술을 활성화하며, 이 기술이 구현, 검사, 요청된 Codex 리뷰를 담당합니다. 작업 트리 경로 검증, 권한 제한, 증거 기반 검토 등 중요한 안전 장치를 포함하고 있어 잘못된 체크아웃에서 시작하거나 요약을 맹신하는 등의 실수를 방지합니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/SebastienElet/agent-skills/tree/HEAD/skills/claude-developer

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Claude Developer

개요

수동 Claude Code 핸드오프를 위한 시작 명령어와 하나의 자체 포함된 프롬프트를 준비합니다. 사용자가 명령어를 실행하고 프롬프트를 붙여넣은 후, 준비가 되면 결과를 가져옵니다. 구현 및 교정 프롬프트는 claude-development를 구성하며, 이 기술이 구현, 검사 및 요청된 Codex 리뷰를 담당합니다.

사용법

$claude-developer <작업 또는 반환된 결과> — 구현 또는 교정 핸드오프를 준비합니다. Claude를 사용하지 않는 직접 구현 요청은 현재 에이전트가 처리합니다.

단계

  1. 저장소 지침과 핸드오프에 필요한 최소 읽기 전용 컨텍스트를 검사합니다. 추측하지 말고 해결되지 않은 사실을 기록합니다.
  2. 작업 컨텍스트에서 의도된 기존 작업 트리를 식별하고, git worktree list --porcelain 명령어로 절대 경로와 브랜치를 확인합니다. 작업이 현재 작업 트리를 대상으로 하면 현재 작업 트리를 사용합니다. 의도된 작업 트리가 없거나 모호하면 시작 명령어를 발행하기 전에 경로를 물어보고, 경로를 임의로 만들거나 체크아웃을 생성하지 않습니다.
  3. 결과, 확인된 작업 트리 경로 및 브랜치(또는 분리된 HEAD), 관련 사실, 제약 조건, 승인 기준, 허용 범위, 예상 검증, 전달 보고서가 포함된 하나의 프롬프트를 작성합니다. Claude에게 편집 전에 검사할 것, 관련 없는 변경 사항을 보존할 것, 충돌을 표면화할 것을 지시합니다. 사용자의 권한 제한을 포함하고, 명시적으로 승인되지 않은 영향력 있는 행동은 사용자에게 유보합니다.
  4. 구현 또는 교정 핸드오프의 경우, Claude에게 승인된 작업에 대해 claude-development를 활성화하도록 명시적으로 요구합니다. 이 기술이 구현, 검사 및 명시적으로 요청된 독립적인 Codex 리뷰를 담당합니다. 원래 범위와 제한된 로컬 교정 권한을 전달하고, 더 엄격한 사용자 제한을 유지하며, 보고서에 후보, 처분, 증거 및 불완전한 결과가 포함되도록 요구합니다. 그 마무리 절차를 프롬프트에 중복하지 않습니다. 계획 전용 및 리뷰 전용 핸드오프는 개발을 승인하지 않습니다. code-review-fix 교정 내에서 재시작하지 말고, 이 핸드오프로부터 오픈 PR 수리 또는 발행 권한을 추론하지 않습니다.
  5. 두 개의 펜스 블록을 순서대로 반환합니다: sh 블록에는 복사 가능한 한 줄 명령어 cd <셸 이스케이프된 절대 작업 트리 경로> && claude, text 블록에는 해당 세션에 붙여넣을 프롬프트를 넣습니다. 확인된 경로를 대체하고 셸 메타 문자를 안전하게 인용합니다. 모든 교체 또는 교정 프롬프트에 대해 두 블록을 반복한 후 중지합니다.
  6. 반환된 결과에 대해, 제공된 증거와 명시적으로 승인된 로컬 상태만 검토합니다. 사용자가 다른 반복을 요청하는 경우에만 교정 핸드오프를 생성합니다. 실행되지 않은 프롬프트 수정은 이전 핸드오프를 대체합니다.

주의사항

  • 잘못된 체크아웃에서 시작 — claude만 실행하면 터미널의 현재 디렉토리를 사용합니다. 확인된 절대 경로와 &&를 제공하여 cd 실패 시 시작을 방지합니다.
  • 수동 핸드오프 손실 — 명령어를 실행하거나 다른 반복을 시작하면 사용자의 제어권이 사라집니다. 두 블록을 제공하고 기다립니다.
  • 반환된 요약 신뢰 — 결함이나 실패한 검사를 생략할 수 있습니다. 검증 주장 전에 사용 가능한 diff와 증거를 검사합니다.
  • 리뷰 요구 사항 발명 — 핸드오프가 요청되지 않은 Codex 작업을 부과할 수 있습니다. claude-development를 한 번 구성하고 실제로 요청된 리뷰와 교정 권한만 유지합니다.

제약 조건

  • Claude Code, 수동 핸드오프 또는 그 반환된 결과를 명시적으로 포함하는 요청에만 활성화합니다. 자동 Claude 위임을 수동 핸드오프로 가로챕니다.
  • 준비 중에는 Claude, 자동화 래퍼 또는 다른 구현 에이전트를 호출하지 않습니다. 브랜치나 체크아웃을 생성하지 않고, 파일을 편집하지 않으며, 구현을 검증하지 않습니다.
  • 사용자의 현재 요청이 명시적으로 허용하지 않는 한 커밋, 푸시, 병합, 삭제, 게시 또는 권한 우회를 승인하지 않습니다.
  • 응답당 최대 하나의 프롬프트를 생성하고 매 반복마다 사용자를 기다립니다.
  • 요청되지 않은 최종 Codex 리뷰를 요구하지 않고, 프롬프트된 리뷰를 관찰된 증거로 취급하지 않으며, 사용자의 수리 제한을 우회하지 않습니다.
  • 이는 기술적 실행 장벽이 아닌 권고 정책입니다. 명시된 환경에서 명명된 증거를 검토하지 않고 Claude의 결과가 검증되었다고 주장하지 않습니다.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

관련 스킬