jules-prompts

Jules Prompts는 코딩 에이전트를 위해 설계된 기계 판독 가능 작업 프롬프트, Agent Skills, 그리고 고의로 결함을 심은 픽스처의 선별된 라이브러리입니다. 이름은 역사적일 뿐이며, 지침은 특정 제품(예: Jules, Claude Code, Codex, Cursor)에 의존하지 않는 하네스 독립적입니다. 저장소는 여러 계층으로 구성됩니다: - `_prompts/`: 표준 절차 텍스트로, 웹사이트, JSON 인덱스, MCP 슬래시 명령을 포함합니다. - `skills/`: `_prompts/`에서 생성된 동일한 텍스트를 Agent Skills 형식으로 제공하며, `.claude/skills/` 또는 `.agents/skills/`에 복사할 준비가 되어 있습니다. - `fixtures/`: 스킬이 어떻게 실패하는지 보여주기 위해 결함을 심은 소형 저장소입니다. - `plugin/`: 매니페스트, 스킬, 슬래시 명령을 포함한 설치 가능한 번들로 제공되는 전체 라이브러리입니다. - `library.json`: 모든 절차, 해당 카테고리 및 등급의 기계 판독 가능 목록입니다. 생성된 모든 출력물은 CI에서 바이트 단위로 검사되어 소스와 동기화 상태를 유지합니다. 새 출력 형식을 추가하는 것은 `scripts/emit.py`의 `TARGETS` 목록에 항목 하나를 추가하는 것만으로 가능합니다. 절차는 `status: legacy`로 표시되지 않는 한 `core`로 분류됩니다. 핵심 절차는 에이전트가 실제로 겪는 실패를 다루는 반면, 레거시 절차는 2025년의 일반 목적 작업 텍스트로 여전히 유용하지만 이 라이브러리를 독특하게 만드는 요소는 아닙니다. 라이브러리는 `harness/AGENTS.md`에 상시 적용되는 지침을 포함하여 스킬이 선택되지 않았을 때도 작동하도록 보장합니다. 시작 가이드는 `PROMPTS_GUIDE.md`(각 프롬프트와 권장 순서 설명) 및 `ENVIRONMENT_SETUP.md`(에이전트 복제, 설치, 테스트를 위한 저장소 준비)에 제공됩니다. 사용 옵션은 다음과 같습니다: - Agent Skills로 사용: 스킬 디렉토리를 `.claude/skills/`에 복사하고 `harness/AGENTS.md`를 프로젝트의 `AGENTS.md`에 붙여넣습니다. - MCP 서버로 사용: `mcpServers`에서 서버를 구성하여 Claude Code, Claude Desktop, VS Code/Copilot Chat, Windsurf, Zed에서 프롬프트를 슬래시 명령으로 노출합니다. 서버는 저장소를 실시간으로 읽으며 `<PR_URL_OR_DIFF_RANGE>` 같은 자리 표시자는 인수로 노출됩니다. - 사람용: YAML 프론트 매터 이후의 프롬프트 파일 본문을 복사하여 에이전트의 지시 입력에 붙여넣습니다. - 에이전트용: `https://jules-prompts.wecanuseai.com/prompts.json`을 가져와 제목/설명/카테고리로 프롬프트를 선택하고, 해당 URL에서 렌더링된 프롬프트를 가져오거나 `_prompts/<slug>.md`를 읽습니다. - 픽스처 대상: `python scripts/score_fixture.py fixtures/unfailable-tests path/to/REPORT.md`를 사용하여 픽스처를 평가하며, holds/broken/skipped 판정과 적용 범위 라인을 제공합니다. 기여 지침은 아직 다루지 않은 반복 작업에 대한 프롬프트만 추가하고, YAML 프론트 매터를 일치시키며, 하네스 독립적 지침을 작성하고, 스킬을 재생성하고, 가이드와 워크플로우를 업데이트하고, 실패 포착 프롬프트에 대한 픽스처를 추가하고, 무결성 검사를 통과하는 것을 강조합니다.