AI 도구 문서 업데이트

Skill, Agent 등 AI 도구를 추가/변경한 후, 모든 README.md를 재귀적으로 업데이트하고 CHANGELOG에 반영합니다.

활성화 조건

• /update-ai-tools 명령어 입력 시

• "도구 문서 갱신", "README 업데이트", "문서 동기화" 요청 시

실행 흐름

1. 변경 감지 → 2. 개별 도구 README → 3. 디렉토리 README → 4. 루트 README → 5. CHANGELOG

1단계: 변경 사항 감지

최근 변경된 AI 도구 파일 확인 (git 기준)

git diff --name-only HEAD git diff --cached --name-only git status --short

skills/ 및 agents/ 하위 변경 파일 필터링

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 로 사용자만 호출 가능