개발 스킬

저장소 파일과 CI 워크플로를 근거로 `AGENTS.md`를 작성·수정·점검합니다. 유지관리자의 기존 방침을 보존하면서 명령, 검증 절차, 디렉터리별 지침을 명확히 합니다.

• 저장소 근거로 AGENTS.md 작성
• 오래된 명령이나 중복 규칙 수정
• 루트와 패키지별 지침 정리

agenttrace로 로컬 AI 코딩 세션 로그를 살펴 비용이나 토큰 급증, 도구 실패, 재시도 반복, 긴 대기 시간을 확인합니다. 보고서를 만들고 실행을 비교하며, CI에서 비정상 실행을 판정하는 기준도 설정할 수 있습니다.

• AI 작업이 느리거나 비용이 큰 원인 조사
• 실패한 작업을 재시도하기 전 로그 확인
• 시도별 도구 사용과 검증 절차 비교

범위가 제한된 코드 수정을 Aider에 맡기고, 조정 에이전트가 변경 사항을 검토하고 프로젝트를 확인한 뒤 커밋하는 절차를 안내합니다. 작업 지시서 작성과 후속 수정도 다루며 실행 보조 스크립트는 포함되지 않습니다.

• 범위가 제한된 코드 수정을 Aider에 맡길 때
• 변경 사항과 테스트 결과를 확인한 뒤 커밋할 때
• 검토 후 추가 수정을 요청할 때

요구 사항, 계획, 설계, 구현, 검토, 테스트와 배포 업무를 전문 에이전트에게 배정하고 보고를 요약합니다. 산출물 버전과 진행 상황, 장애물 및 미결 사항을 추적하며 단계 이동 전 사용자 확인을 받습니다.

• 전문 담당자에게 요구 사항이나 계획 정리 요청
• 기존 코드 검토만 요청
• 산출물 버전과 개발 진행 상황 추적

기존 칸반 보드에서 여러 Claude Code 작업자의 개발을 조율하는 가이드입니다. 작업 분배, AI 검토 전 자동 검사, 작업별 비용 추적, 사람의 개입, 세션 중단 후 복구를 다룹니다. 실행 환경과 연동 기능은 별도로 설치해야 합니다.

• 여러 Claude Code 작업자의 업무 조율
• AI 검토 전에 자동 검사 도입
• 보드에서 진행 상황과 비용 확인

Expo 앱에 URL로 실행할 수 있는 경량 iOS App Clip을 추가하는 과정을 안내합니다. 도메인 연결, 웹 시작 카드, 권한 설정, TestFlight 제출과 App Store 실행 정보 등록을 다룹니다.

• Expo 앱에 App Clip 추가
• 도메인 연결과 시작 카드 설정
• App Clip의 TestFlight 제출 준비

Issue 접수부터 구현, 리뷰, 배포, 인수 확인까지 개발 작업을 관리합니다. 각 완료 조건을 최신 증거로 확인하고, 정해진 재시도 횟수 이후에도 해결되지 않거나 사람의 판단이 필요하면 명시적으로 넘깁니다.

• 실행 가능한 Issue의 구현부터 검증까지 진행
• 구현·리뷰·배포 간 인계 조정
• 인수 조건에 맞춰 실제 동작 확인

프로젝트 기능에 맞춰 AAS 카탈로그의 스킬 후보를 비교하고, 선택한 조합을 검증된 구성으로 기록합니다. 카탈로그에 없는 기능을 확인하고 필요하면 선택 근거도 내보낼 수 있습니다.

• Codex용 AAS 구성 준비
• 프로젝트 기능별 스킬 후보 비교
• 선택한 스킬과 카탈로그 누락 기록

Three.js, React Three Fiber 또는 Spline으로 웹사이트에 인터랙티브 3D 장면을 만들고 문제를 조사합니다. 모델 준비와 압축, 스크롤 연동, 로딩 표시와 대체 콘텐츠를 다루며 실제 기기에서 접근성과 성능을 확인하는 방법도 정리합니다.

• 조작 가능한 3D 상품 보기 추가
• 스크롤 연동 3D 포트폴리오 제작
• 3D 로딩 또는 렌더링 지연 조사

GitHub 풀 리퀘스트의 검토 의견을 정리하고 요청된 범위에서 코드를 수정한 뒤 결과를 검증합니다. 커밋과 검증 근거를 담은 답변을 준비하며, 승인된 경우 답변을 게시하거나 개별 검토 스레드를 해결합니다.

• 풀 리퀘스트 댓글과 검토 의견 정리
• 검토자가 요청한 코드 수정
• 커밋과 검증 근거를 담은 답변 작성

코드, 목표, 제약을 살펴 새 AI 프로젝트나 기존 프로젝트를 진단합니다. 사용 가능한 등록 목록에서 확인한 스킬을 제안하고, 의존 관계와 완료 기준, 점검 방법을 포함한 작업 목록과 구현 계획을 정리합니다.

• 새 AI 프로젝트 시작 계획 수립
• 기존 프로젝트의 기술 문제 정리
• 사용 가능한 스킬 선택

반복 작업을 입력, 결과물, 예시, 제한 사항이 명확한 Andru.ia 스킬로 정리합니다. `SKILL.md` 작성, 폴더 구조와 검증 항목 확인, 변경 내용을 검토할 풀 리퀘스트 준비를 지원합니다.

• 반복 작업을 스킬로 만들 때
• 기존 스킬의 예시나 제한을 개선할 때
• 스킬을 검증하고 풀 리퀘스트를 준비할 때

Workbench에서 AAS 스킬 구성과 변경 계획, 선정 근거를 검토합니다. 식별자와 버전, 설정 누락, 관련 파일 간 불일치를 확인하며, 검토 중에는 스킬을 설치하거나 변경 사항을 적용하지 않습니다.

• 구성한 AAS 스킬 조합 검토
• 적용 전 변경 계획 확인
• 설정 누락이나 파일 불일치 찾기

현재 사용 중인 AI 에이전트가 Git 변경 사항을 검토하도록 합니다. `ocr`가 파일과 적용 규칙을 정리하고, 결과는 심각도별 지적과 함께 검토·미검토 파일 수, 검토율, 미검토 사유를 보고합니다.

• 현재 AI 에이전트로 변경 사항 검토
• 브랜치 차이나 단일 커밋 확인
• 파일별 검토 규칙 적용

`ocr` 명령줄 도구와 설정된 AI 모델로 Git 작업 중인 변경 사항, 커밋 또는 브랜치 간 차이를 검토합니다. 심각도별 줄 단위 지적을 받고, 요청하면 코드 수정도 적용할 수 있습니다.

• 커밋 전에 변경 사항 점검
• 풀 리퀘스트나 브랜치 차이 검토
• 특정 커밋의 문제 조사

구현 계획에 따라 코드를 단계별로 수정하고 의존성 영향 확인, 테스트, 검증된 변경의 커밋을 진행합니다. 범위가 작은 작업도 직접 처리하며 코드 관계 인덱스를 확인한 뒤 분석 결과를 사용합니다.

• 기존 구현 계획 실행
• 한두 파일의 작은 변경
• 단계별 테스트와 커밋

코드 의존 관계를 살펴보며 함수 이름 변경, 모듈 추출, 함수나 서비스 분할, 파일 이동을 지원합니다. 수정 전 미리보기와 수정 후 영향 범위 확인 및 테스트를 포함하며, 의미 기반 이름 변경의 적용 범위와 한계도 확인할 수 있습니다.

• 함수 이름과 참조 위치 변경
• 코드를 별도 모듈로 추출
• 큰 함수나 서비스 분할

GitNexus 도구와 코드 관계 그래프를 살펴보는 방법을 안내합니다. 목적에 맞는 검색 도구와 관련 스킬을 찾고, 결과가 어느 브랜치와 커밋을 기준으로 하는지, 인덱스가 현재 코드와 일치하는지도 확인할 수 있습니다.

• 목적에 맞는 GitNexus 도구 찾기
• 코드 심볼 간 관계 검색
• 인덱스 최신 상태와 브랜치 확인

GitNexus로 함수와 파일의 호출자, 의존 관계, 영향을 받는 실행 흐름을 추적합니다. 기존 변경 사항도 살펴보고 편집이나 커밋 전에 영향 범위와 위험, 불확실한 점을 보고합니다.

• 함수를 바꾸기 전 호출자 확인
• 대상 코드에 의존하는 부분 찾기
• 커밋 전 변경 영향 검토

7개의 협력 검토 에이전트로 GitNexus 풀 리퀘스트의 프로덕션 준비 상태를 평가합니다. 발견 사항을 통합하고 마지막 비평자가 초안을 다시 점검해, 필요한 수정 사항을 정리합니다.

• 프로덕션 배포 전 GitNexus PR 평가
• 여러 검토 역할의 발견 사항 통합
• 최종 확정 전 통합 검토 초안 점검

GitNexus로 낯선 코드의 구조와 실행 흐름을 살펴봅니다. 관련 함수와 호출 관계를 찾고 구현 파일을 확인해 기능의 작동 방식을 설명하며, 대상 저장소와 색인의 최신 상태도 함께 안내합니다.

• 낯선 프로젝트의 구조 파악
• 인증 또는 결제 흐름 추적
• 함수의 호출 위치와 호출 대상 확인

GitNexus 명령으로 소스 코드를 분석하고 색인을 만들거나 갱신합니다. 상태 확인, 색인 삭제, 등록된 프로젝트 목록 조회와 코드 관계를 바탕으로 한 문서 생성도 지원합니다.

• 새 프로젝트 색인 만들기
• 큰 코드 변경 후 색인 갱신
• 색인 상태 확인·삭제·목록 조회

개발 작업을 계획, 구현, 검토 순서로 진행합니다. 계획을 확인한 뒤 구현을 계속할지 선택할 수 있으며, 마지막에 커밋, 검증 결과, 검토 내용, 미완료 항목을 보고합니다.

• 기능의 계획부터 검토까지 진행
• 계획을 확인한 뒤 구현 시작
• 기존 계획에서 구현 시작

GitNexus로 문장이 실행되는 조건과 함수 안에서 변수 값이 흐르는 위치를 살펴봅니다. 조기 종료와 의존 관계를 확인하고, 결과가 비어 있는 이유를 조사하거나 제어·데이터 의존성 조회 기능을 확장할 때 활용할 수 있습니다.

• 문장이 실행되는 조건 확인
• 함수 안에서 변수 사용 흐름 추적
• pdg_query 결과가 비어 있는 이유 조사