| name | update-ai-tools |
| description | AI 도구(Skill, Agent) 추가/변경 후 모든 README.md를 재귀적으로 업데이트하고 CHANGELOG에 반영합니다. update-ai-tools, README 업데이트, 도구 문서 갱신, 문서 동기화 요청 시 사용.
|
| disable-model-invocation | true |
AI 도구 문서 업데이트
Skill, Agent 등 AI 도구를 추가/변경한 후, 모든 README.md를 재귀적으로 업데이트하고 CHANGELOG에 반영합니다.
활성화 조건
/update-ai-tools 명령어 입력 시- "도구 문서 갱신", "README 업데이트", "문서 동기화" 요청 시
실행 흐름
1. 변경 감지 → 2. 개별 도구 README → 3. 디렉토리 README → 4. 루트 README → 5. CHANGELOG
1단계: 변경 사항 감지
git diff --name-only HEAD
git diff --cached --name-only
git status --short
git diff --name-only HEAD -- skills/ agents/
감지 대상:
- 새로 추가된 도구 (
SKILL.md, AGENT.md 신규)
- 수정된 도구 (
SKILL.md, AGENT.md 변경)
- 삭제된 도구 (디렉토리 삭제)
변경이 없으면 사용자에게 알리고 종료합니다.
2단계: 개별 도구 README.md 업데이트
변경된 각 도구 디렉토리의 README.md를 업데이트합니다.
대상: skills/{name}/README.md, agents/{name}/README.md
각 README.md 작성 내용:
- 스킬/에이전트 이름, 설명 (SKILL.md/AGENT.md frontmatter 기반)
- 주요 기능 (본문에서 추출)
- 사용 방법 (호출 커맨드, 트리거 키워드)
- 디렉토리 구조 (실제 파일 목록)
새 도구: README.md 신규 생성
수정된 도구: 기존 README.md를 최신 SKILL.md/AGENT.md 기준으로 재작성
삭제된 도구: 해당 README.md도 함께 삭제됨 (디렉토리 삭제 시 자동)
변경된 도구가 3개 이상이면 에이전트 팀으로 병렬 처리를 권장합니다.
3단계: 디렉토리 README.md 업데이트
skills/README.md와 agents/README.md를 업데이트합니다.
skills/README.md:
- 모든
skills/*/SKILL.md를 스캔
- frontmatter에서 name, description 추출
- 카테고리별로 그룹화 (기존 카테고리 구조 유지)
- 요약 테이블 + 카테고리별 상세 섹션 재작성
agents/README.md:
- 모든
agents/*/AGENT.md를 스캔
- 요약 테이블 + 개별 상세 섹션 재작성
카테고리 분류 기준: 카테고리 가이드 참조. 없는 카테고리는 제안 후 생성 가능.
4단계: 루트 README.md 업데이트
README.md의 아래 섹션만 업데이트합니다 (나머지 섹션은 유지):
| 업데이트 대상 | 내용 |
|---|
| 리소스 목록 > Skills | 전체 스킬 테이블 (Name, Description) + 개수 |
| 리소스 목록 > Agents | 전체 에이전트 테이블 (Name, Description) + 개수 |
| 디렉토리 구조 | 실제 디렉토리 트리 반영 |
유지할 섹션: 설치 방법, 지원 에이전트, 설치 경로, 기여 방법
5단계: CHANGELOG 반영
/changelog 스킬을 호출하여 변경 내용을 CHANGELOG.md에 기록합니다.
changelog 스킬에 전달할 정보:
- 추가/수정/삭제된 도구 목록
- 변경 유형 (feat: 새 도구 추가, docs: 문서 업데이트 등)
- 담당자 (git author 기반)
병렬 처리 가이드
변경된 도구 수에 따라 실행 전략을 조절합니다:
| 변경 도구 수 | 전략 |
|---|
| 1~2개 | 순차 처리 |
| 3개 이상 | 에이전트 팀 구성 (배치별 병렬) |
병렬 처리 시 구성:
- 개별 도구 README 업데이트 에이전트 (배치별)
- 디렉토리 + 루트 README 업데이트 에이전트 (개별 완료 후)
주의사항
- 기존 README.md의 사용자 커스텀 내용이 있으면 보존 여부 확인
- 삭제된 도구는 디렉토리 README와 루트 README에서 자동 제거
- CHANGELOG 반영 시 버전 유형(patch/minor/major)은 사용자에게 확인
- 이 스킬은
disable-model-invocation: true로 사용자만 호출 가능
