개발 스킬

프로젝트 구조와 개발 명령, 고유 규칙을 조사하고 복잡도에 따라 AGENTS.md를 계층적으로 생성하거나 갱신해 에이전트용 안내를 정리합니다.

• 개발 에이전트용 프로젝트 안내를 작성합니다
• 기존 AGENTS.md를 갱신합니다
• 복잡한 디렉터리의 개별 규칙을 정리합니다

GitHub의 열린 Issue와 PR을 모두 조사해 특정 커밋의 코드와 수정 내역을 근거로 보고서를 만듭니다. 버그 상태와 수정안, 병합 판단에 필요한 자료를 정리합니다.

• 열린 Issue와 PR 전체 현황 정리
• 보고된 버그의 수정 여부 확인
• PR 병합 판단을 위한 사전 확인

구현 작업을 독립적으로 병합할 작은 PR로 나누고 작업 공간을 분리합니다. 수동 검증 기록, 영어 PR 작성, CI와 리뷰 대응, 병합 후 정리까지 진행합니다.

• 구현 결과를 PR로 전달합니다
• 큰 작업을 작은 PR로 나눕니다
• 독립적인 PR을 병렬로 구현합니다

변경 사항을 목적별 커밋으로 나누고 기존 메시지 형식에 맞춰 이력을 정리합니다. 리베이스와 충돌 해결을 지원하며 특정 코드가 언제, 누구에 의해 변경됐는지도 조사합니다.

• 변경 사항을 목적별로 나누어 커밋
• 기존 커밋 메시지 형식에 맞추기
• 병합 전 브랜치 이력 정리

구현 전에 코드와 자료를 조사하고 필요한 결정, 작업 의존 관계, 검증 방법을 담은 계획을 만듭니다. 승인 후 계획 파일을 작성하며 코드 변경은 별도 실행 단계로 넘깁니다.

• 구현 전 대규모 변경 계획
• 모호한 요청을 구체적인 작업으로 정리
• 다른 에이전트에게 전달할 계획 작성

사용하지 않는 TypeScript 코드를 찾아 참조를 확인한 뒤 병렬 에이전트가 삭제하고, 타입 검사·테스트·빌드와 변경 단위별 커밋까지 진행합니다.

• 미사용 가져오기·함수·타입 삭제하기
• 특정 파일이나 디렉터리 정리하기
• 참조 없는 파일의 삭제 가능 여부 확인하기

코드 편집 후 자동 검사기가 보내는 주석 경고를 Codex가 이해하고, 지적된 주석을 수정하거나 설명한 뒤 다음 작업을 이어 가도록 안내합니다.

• 편집 후 나타난 주석 경고 이해하기
• 검사기가 지적한 주석 수정하기
• 지적된 주석을 설명한 뒤 작업 계속하기

임시 작업 환경에서 LazyCodex나 Codex의 버그를 재현하고 수정합니다. 수정 전후 테스트와 실제 동작 증거를 첨부해 담당 프로젝트에 PR이나 패치가 담긴 issue를 제출합니다.

• 재현 가능한 버그 수정
• 상위 Codex에 수정 PR 제출
• LazyCodex에 검증된 패치 제출

역할이 다른 에이전트가 계획의 전제와 설계를 상호 비평해 맹점과 불필요한 복잡성을 찾습니다. 검토를 통과한 결과를 계획 담당에게 전달해 실행 가능한 계획으로 정리합니다.

• 계획의 전제를 엄격히 점검할 때
• 연계 위험과 예외 누락을 찾을 때
• 설계의 불필요한 복잡성을 검토할 때

ZCode 클라이언트의 MCP 서버 설정 문제를 조사합니다. 상태, 설정 범위, 필드, 통신 방식, 시작 오류를 확인해 연결 실패, 도구 누락, 파일 수정 미반영의 원인과 수정 위치를 찾습니다.

• MCP 서버가 연결되거나 시작되지 않을 때
• 세션에 MCP 도구가 표시되지 않을 때
• 설정 파일 수정이 반영되지 않을 때

ZCode 플러그인을 만들거나 수정하고 로컬 테스트 마켓플레이스 목록을 준비합니다. 파일과 경로를 확인한 뒤 앱에서 마켓을 추가하고 플러그인을 설치하거나 업데이트해 시험하는 방법을 안내합니다.

• 새 ZCode 플러그인을 만들 때
• 기존 플러그인의 기능을 바꿀 때
• 로컬 테스트 마켓을 준비할 때

ZCode 훅의 설정 위치, 이벤트, 매처, 스크립트, 출력과 실행 로그를 점검해 훅이 실행되지 않거나 세션을 막거나 오류를 내는 원인을 찾고 구체적인 수정 방법을 안내합니다.

• 훅이 실행되지 않는 원인을 찾을 때
• 이벤트 이름과 매처를 확인할 때
• 시간 초과나 JSON 검증 오류를 고칠 때

ZCode에서 스킬이 보이지 않거나, 로드되지 않거나, 자동으로 실행되지 않는 이유를 진단합니다. 탐색 순서와 설정, SKILL.md 메타데이터 및 우선순위를 확인하고 원인에 맞는 수정 절차를 안내합니다.

• ZCode에 스킬이 표시되지 않는 이유 찾기
• 스킬이 자동으로 실행되지 않는 문제 확인
• 이름이 같은 스킬의 우선순위 확인

반복 작업을 재사용 가능한 기술로 정리하고, 목적과 실행 조건을 분명히 한 뒤 `SKILL.md` 초안을 작성하거나 개선합니다. 실제 요청 예시로 동작을 확인하고 결과에 따라 설명과 지침을 조정합니다.

• 반복 작업을 기술로 정리할 때
• 새 `SKILL.md`를 작성할 때
• 기존 기술 설명을 개선할 때

ZCode의 스킬, 명령, MCP 서버, 훅, 플러그인 및 AGENTS.md 설정 방법을 안내합니다. 사용자 및 작업 공간 설정 위치와 탐색·병합 규칙을 확인하고, 각 리소스에 맞는 설정 범위를 선택할 수 있습니다.

• 개인 설정과 팀 공유 설정의 위치 선택
• MCP 서버나 훅의 설정 위치 확인
• 설정 우선순위와 충돌 확인

ZCode 클라이언트에서 사용자 지정 슬래시 명령이 메뉴에 나타나지 않거나, 같은 이름의 명령에 가려지거나, 형식이나 인수 처리에 문제가 있는 원인을 찾습니다. 검색 경로, 파일 이름, 프런트매터, 플러그인 상태와 우선순위를 살펴보고 단계별 수정 절차를 안내합니다.

• 명령이 메뉴에 표시되지 않는 원인 찾기
• 같은 이름 명령의 우선순위 확인
• 인수 또는 프런트매터 문제 수정

ZCode 클라이언트에서 플러그인 검색, 설치, 활성화, 매니페스트, 의존성 및 설정 문제를 점검합니다. 증상에 따라 원인을 좁혀 구체적인 수정 위치를 찾습니다.

• 플러그인을 추가하거나 설치할 수 없을 때
• 활성화한 플러그인의 스킬이나 명령이 보이지 않을 때
• 매니페스트나 의존성 오류를 조사할 때

Three.js로 3D 표현을 구현할 때 분야별 자료에서 API와 구현 패턴을 확인합니다. 장면 구성부터 형상, 재질, 조명, 애니메이션, 조작까지 다룹니다.

• 카메라와 조명이 있는 3D 장면 구성하기
• GLTF 모델 로딩 방법 확인하기
• 애니메이션과 독자적인 화면 효과 구현하기

Git 기록 변경과 작업 폐기를 사용자의 명시적 요청에 한정하고, 폐기 전 복구 상태 저장과 잠금·인덱스 손상 시 대응 절차를 정해 작업 내용을 보호합니다.

• 커밋 전에 변경 내용을 확인합니다
• 허용된 폐기 작업 전에 상태를 저장합니다
• Git 잠금이나 인덱스 손상을 조사합니다

Python 프로젝트 내부에 실행 환경을 만들고 필요한 패키지를 설치합니다. 기존 관리 도구를 따르며 시스템 Python을 변경하지 않고 다음 실행에 쓸 절차도 정리합니다.

• 새 Python 프로젝트 환경 구성
• 기존 환경에 패키지 추가
• 환경 관리 관련 설치 오류 대응

Muse Code의 현재·과거 세션 로그에서 요청, 판단, 실행 결과를 확인합니다. 작업 인계를 돕고 로그에 내용이 남은 유실 파일을 복원합니다.

• 이전 Muse Code 작업 요약
• 로그에서 유실 파일 복원
• 과거 요청과 실행 결과 확인

소프트웨어 문제 조사, 구현, 코드 검토와 테스트를 Codex 작업에 전달하고 결과를 확인합니다. 풀 리퀘스트와 CI 상태 확인, 허가된 수정도 다룹니다.

• 문제 원인 조사와 요청한 기능 구현하기
• 코드 검토와 관련 테스트 실행하기
• 풀 리퀘스트가 지연되는 원인 확인하기

Muse Code에 저장된 설정과 기본값을 확인하고 명시적인 요청에 따라 필요한 항목만 변경합니다. 추론과 화면 표시 설정을 현재 세션 상태와 구분해 설명합니다.

• 저장된 설정과 기본값 확인
• 저장할 추론 설정 변경
• 추론 요약과 출력 상세 수준 조정

로컬에 남아 있는 개발 에이전트의 대화 기록에서 목표, 완료한 작업, 미해결 사항을 추려 현재 작업 환경에서 다시 시작할 수 있도록 인계 요약을 작성합니다.

• 세션 식별자로 작업 상황 복원
• 로컬 로그의 미완료 작업 정리
• JSONL 기록과 Markdown 인계 문서 확인