[Guryss]

💡 Issue

• closed [Setting] Claude 스킬 추가·수정 시 Discord 자동 알림 및 GitHub 아카이빙 #295

💭 Summary

Claude 스킬이 develop에 머지되면 Discord 포럼에 스킬별 글이 자동으로 올라가고, GitHub 이슈와 위키에 기록되도록 했어요.

스킬을 새로 알리거나 보완 논의를 할 창구가 없어서 만들었어요. 기록은 GitHub로 모으고, Discord는 공유·논의용으로만 써요.

make-PR 스킬은 4단계 안내만 바뀌었어요. 스킬을 건드리는 PR이면 Summary가 그대로 Discord·아카이브 이슈로 나간다는 안내를 추가했어요.

🔑 Key Changes

워크플로 skill-archive.yml

• .claude/skills/**·.claude/agents/**(와 두 스크립트)가 develop에 머지되면 실행돼요.
• 수동 실행(skills=all 또는 스킬 이름 목록)으로 기존 스킬을 백필하거나 재시도할 수 있어요.
• 두 job 모두 develop에서만 돌아요. 다른 브랜치를 골라 실행해도 건너뛰어요.

아카이브 skill_archive.py

• 스킬마다 GitHub 이슈 [Skill] <name>(라벨 skill-archive)를 정본으로 만들어요.
• 이슈에는 설명·활용, 추가 이유(도입 PR의 Summary), SKILL.md·위키·Discord 링크가 들어가요.
• Discord 포럼에 스킬마다 글(스레드)을 하나씩 만들어요. 웹훅만 쓰고 봇 토큰은 필요 없어요.
• 수정되면 같은 스레드와 이슈 코멘트에 업데이트를 이어 붙여요. 삭제되면 알리고 이슈를 닫아요.
• 아카이브 이전부터 있던 스킬은 도입 커밋 제목을 추가 이유로 써요. 초기 스킬은 기능 PR에 섞여 머지돼서, PR로 찾으면 엉뚱한 PR이 나오기 때문이에요.
• Discord 멘션(@everyone 등)은 울리지 않게 막았어요.

위키 wiki_sync.py

• 스킬 15개와 서브 에이전트 3개를 위키 페이지로 만들어요.
• 위키는 폴더를 지원하지 않아서, 접고 펼 수 있는 사이드바로 "스킬 / 서브 에이전트"를 나눠 보여줘요.
• 사람이 쓴 페이지(Home 등)와 사이드바의 자동 블록 밖 내용은 건드리지 않아요.

문서

• docs/WORKFLOW.md에 "스킬 아카이브 · Discord 알림 · 위키" 절을 추가했어요(동작, 셋업, 백필, 실패 시 복구).
• 루트 CLAUDE.md에 위키·아카이브 이슈는 사본이니 원본에서 고치라는 안내를 넣었어요.

📱 Simulation

해당 없음 (CI·툴링 변경이에요)

🧑‍🧒‍🧒 To Reviewer

머지 전에 확인한 것

• 임시 브랜치 트리거로 위키 동기화를 실제로 돌려봤어요. 기본 토큰(GITHUB_TOKEN)으로 위키 push가 되고, 하위 폴더 페이지와 사이드바도 정상이었어요.
• 그때 쓴 임시 트리거 커밋 2쌍은 revert로 되돌려서 최종 워크플로에는 남지 않아요.
• 아카이브 쪽은 로컬 dry-run과 가짜 외부 호출로 신규·수정·삭제·백필·재시도 경로를 확인했어요.
• Discord 실제 전송은 웹훅이 아직 없어서 확인하지 못했어요.

머지 후 필요한 셋업

1. Discord에 포럼 채널을 만들고 웹훅을 생성해 주세요("태그 필수"는 꺼야 해요).
2. 레포 Secrets에 DISCORD_SKILL_WEBHOOK_URL을 등록해 주세요. 없으면 이슈 아카이브까지 건너뛰고 위키만 동기화돼요.
3. Actions → Skill Archive → Run workflow(skills=all)로 기존 스킬을 백필해 주세요.

알고 수용한 한계 (WORKFLOW.md에 적어뒀어요)

• 같은 스킬을 수 초 간격으로 두 번 머지하면 이슈가 중복될 수 있어요.
• 업데이트 기록이 실패하면 수동 실행으로는 다시 안 올라가요.

※ Reference

• Discord 웹훅 실행 API — 포럼 글 생성(thread_name), 기존 스레드 전송(thread_id)

🤖 Generated with Claude Code

[github-actions]

테스트 커버리지 리포트

Module	Coverage
AuthData	55.3%
AuthDomain	98.2%
BaseDomain	70.3%
CollectionDomain	98.3%
CollectionFeature	0.0%
CommentData	0.0%
CommentDomain	94.9%
FeedData	62.8%
FeedDomain	98.7%
HomeFeature	⚠️ Missing coverage
Keychain	0.0%
LibraryFeature	0.0%
Networking	78.0%
NotificationData	33.9%
NotificationDomain	100.0%
NotificationFeature	0.0%
NovelData	15.4%
NovelDetailFeature	0.0%
NovelDomain	92.9%
NovelReviewData	77.4%
NovelReviewDomain	96.8%
NovelReviewFeature	5.3%
ProfileData	46.1%
ProfileDomain	97.1%
RecommendationData	54.7%
RecommendationDomain	91.7%
SearchData	5.1%
SearchDomain	100.0%
SettingData	31.1%
SettingDomain	99.0%
SocialData	53.4%
SocialDomain	87.5%
SplashData	77.1%
SplashDomain	95.5%
SplashFeature	32.9%

_{Generated by CI on 2026-10-15 17:46 KST}