스킬 찾기

서로 독립적인 버그나 테스트 실패를 별도 에이전트에 맡겨 동시에 조사하고 수정합니다. 담당 범위를 정하고 결과 검토, 변경 충돌 확인, 전체 테스트와 통합까지 안내합니다.

• 원인이 다른 테스트 실패 조사
• 서로 다른 기능의 독립적인 버그 수정
• 여러 에이전트의 담당 범위 정리

AI 에이전트 스킬을 테스트부터 시작해 만들고 개정하며 공개 전에 검증합니다. 적용 전후의 행동을 비교해 지시의 누락과 오해를 수정합니다.

• 반복 절차를 재사용 가능한 스킬로 만들 때
• 오해를 일으키는 지시를 개정할 때
• 공개 전에 스킬을 검증할 때

코드 리뷰 의견을 실제 코드와 지원 환경에 대조해 타당성을 확인합니다. 불명확한 내용을 정리하고 근거를 들어 답변하며, 수정 사항마다 테스트합니다.

• 모호한 리뷰 의견을 정리할 때
• 제안된 변경의 호환성을 확인할 때
• 추가하려는 기능의 실제 사용 여부를 조사할 때

코드 검토자를 위한 풀 리퀘스트 본문을 작성합니다. 도식과 변경 비교, 변경 전후의 동작 증거를 담고 되돌리기 쉬운 정도와 영향 범위를 짧게 정리합니다.

• 풀 리퀘스트 본문 작성
• 파일 트리와 변경 비교로 구조 설명
• 화면 변경 전후의 증거 제시

공식 문서, 소스 코드, 명세 등 일차 자료로 질문을 조사합니다. 백그라운드 에이전트가 주장마다 출처를 달아 하나의 Markdown 조사 노트로 정리하고 저장소에 저장합니다.

• 공식 자료로 API 명세 확인
• 출처가 포함된 조사 노트 보관
• 다른 작업 중 자료 조사 맡기기

수집한 자료에서 글의 전개 후보를 제시하고 선택한 내용만 한 단계씩 작성합니다. 독자의 사전 지식을 확인한 뒤 필요한 개념을 먼저 설명하며 글을 구성합니다.

• 수집한 메모를 글로 작성
• 글의 도입부 후보 비교
• 초보 독자에 맞게 설명 순서 조정

한 번의 대화로 다루기 어려운 큰 기획이나 변경을 결정할 질문과 의존 관계로 정리합니다. 이슈 관리 도구에 판단 근거를 남기고 실행까지의 경로를 명확히 합니다.

• 여러 대화에 걸친 대규모 계획 수립
• 미결정 사항과 의존 관계 정리
• 협업 중 판단 과정 공유

명세서나 티켓의 작업을 코드로 구현합니다. 유형 검사와 테스트로 확인하고 code-review 스킬로 변경 사항을 검토한 뒤 현재 브랜치에 커밋합니다.

• 명세서에 따른 기능 구현
• 지정한 티켓의 작업 구현
• 유형 검사와 테스트로 변경 사항 확인

현재 대화와 코드베이스에 대한 이해를 바탕으로 명세서를 작성해 프로젝트 이슈 관리 시스템에 게시합니다. 사용자 요구, 구현과 테스트 방침, 제외 범위를 정리합니다.

• 기능 논의를 명세서로 정리
• 합의한 요구 사항을 이슈로 게시
• 구현과 테스트 방침 문서화

지정한 커밋이나 브랜치를 기준으로 코드 변경을 검토합니다. 문서화된 개발 규칙 준수와 요구 사항 구현을 별도로 확인하고 두 관점의 지적 사항을 나누어 보고합니다.

• 브랜치나 PR의 변경 검토
• 지정 커밋이나 태그 이후 변경 확인
• 문서화된 개발 규칙과 대조

호출자가 익혀야 할 사용법은 줄이고 복잡한 처리는 내부에 모으는 모듈 설계를 돕습니다. 공통 용어와 판단 기준으로 사용 편의성과 테스트 용이성을 검토합니다.

• 모듈 호출 방법 간소화
• 흩어진 복잡한 처리 통합
• 구현을 교체할 위치 검토

개발 스킬의 첫 사용에 앞서 작업 관리 위치, 분류 라벨, 용어집과 설계 결정 기록의 위치를 확인합니다. 사용자 검토를 거쳐 저장소 공통 설정 문서를 정리합니다.

• 개발 스킬의 초기 설정
• 작업 관리 위치와 분류 라벨 정리
• 용어집과 설계 결정 기록의 위치 결정

Turn a course plan into numbered exercise folders with problem, solution, and explanation variants. Create starter readme files, check naming and links with the project’s linter, and fix structural errors before committing.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

• Set up exercise folders for a new course section
• Create problem, solution, and explanation stubs
• Renumber exercises and check their structure

계획, 명세, 대화를 각각 동작을 확인할 수 있는 작은 개발 티켓으로 나눕니다. 의존 관계와 착수 순서를 명시하고 사용자 확인 후 로컬 파일이나 이슈 관리 도구에 등록합니다.

• 명세를 개발 티켓으로 나누기
• 티켓 의존 관계와 착수 순서 정리
• 광범위한 변경을 단계적으로 진행

Replace TypeScript type assertions in tests with functions from @total-typescript/shoehorn. Use partial objects when only a few properties matter, or deliberately invalid data for error tests, then run a type check to verify the migration.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

• Replace as assertions in TypeScript tests
• Build test objects with only the properties you need
• Pass deliberately invalid data for error tests

명세서와 관련 티켓의 의존 관계를 읽고 여러 에이전트가 구현을 진행합니다. 테스트와 검토를 거쳐 결과를 하나의 통합 브랜치로 모으고 티켓 완료 처리까지 진행합니다.

• 여러 티켓으로 나뉜 명세 구현
• 독립적인 작업의 병렬 구현
• 구현 결과를 통합 브랜치에 모으기

사람이 직접 해야 하는 서비스 설정과 이전 절차를 대화형 bash 스크립트로 만듭니다. 화면 조작과 비밀 정보 입력, 설정값 저장을 단계별로 안내합니다.

• 외부 서비스 설정 절차 안내
• 인증 정보를 입력하고 .env에 저장
• CI용 GitHub 비밀 정보 설정

기능 추가나 버그 수정을 실패하는 테스트와 최소 구현 순서로 진행합니다. 호출자가 쓰는 공개 인터페이스로 동작을 검증하고 내부 구조에 의존하지 않는 테스트를 만듭니다.

• 테스트를 먼저 작성해 기능 추가
• 버그 재현 테스트부터 수정 시작
• 통합 테스트 대상 인터페이스 선정

진행 중인 대화를 인계용으로 요약하고 민감한 정보를 제외한 뒤 새 백그라운드 에이전트에 전달합니다. 다음 작업의 초점과 참고 자료를 정리해 현재 작업 위치에서 이어 갑니다.

• 새 에이전트에 후속 작업 인계
• 다음 세션의 작업 범위를 좁혀 인계
• 다음 세션에 필요한 참고 자료 정리

처리 흐름과 상태 변화를 시험하는 HTML이나 여러 화면안을 전환하는 시제품을 만듭니다. 직접 조작하며 설계 의문을 확인하고 판단을 기록합니다.

• 복잡한 상태 변화를 직접 조작해 볼 때
• 서로 다른 화면 디자인을 비교할 때
• 비개발자에게 로직 시제품을 공유할 때

구체적인 사례와 코드 대조로 프로젝트의 업무 용어와 개념 경계를 명확히 합니다. 합의한 정의를 용어집에 기록하고 필요에 따라 중요한 설계 결정의 이유도 남깁니다.

• 모호한 업무 용어 정리
• GLOSSARY.md 생성과 갱신
• 업무 정의와 코드의 일치 여부 확인

코딩 작업 기록을 돌아보며 파일 탐색, 자동 검사, 지침, 도구 사용 등을 점검합니다. 다음 작업을 위한 에이전트 환경 개선안을 중요도순으로 정리합니다.

• 시간이 오래 걸린 개발 작업 회고
• 반복되는 실수를 막을 자동 검사 검토
• 에이전트용 지침 정리

질문으로 글의 주제를 깊이 탐색하고 문장, 경험, 비유, 미완성 생각을 모읍니다. 구성을 정하지 않고 하나의 Markdown 파일에 글감을 쌓습니다.

• 글의 구성을 정하기 전 소재 모으기
• 경험과 관찰을 글의 조각으로 남기기
• 생각의 중심이 될 비유와 표현 찾기

혼자 판단하기 어려운 문제를 필요한 지식을 가진 사람에게 전달할 질문지로 정리합니다. 답변자의 역할과 필요한 사실을 확인하고 답변란이 있는 Markdown 문서를 만듭니다.

• 판단에 필요한 정보 수집
• 전문가에게 물어볼 질문 준비
• 회의 전에 서면 답변 수집