Claude-skill-registry audit-semo
전체 SEMO 패키지 통합 품질 감사. Use when (1) 전체 패키지 품질 점검, (2) Agent/Skill/Command 표준 준수 검토, (3) 비효율적 구조 탐지, (4) 정기 감사 수행.
install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/audit-semo" ~/.claude/skills/majiayu000-claude-skill-registry-audit-semo && rm -rf "$T"
manifest:
skills/data/audit-semo/SKILL.mdsource content
🔔 시스템 메시지: 이 Skill이 호출되면
시스템 메시지를 첫 줄에 출력하세요.[SEMO] Skill: audit-semo 호출 - {감사 범위}
audit-semo Skill
전체 SEMO 패키지 Agent/Skill/Command 통합 품질 감사
Purpose
모든 SEMO 패키지를 일괄 검토하여 표준 위반, 비효율적 구조, 품질 문제를 탐지합니다.
| 감사 대상 | 검토 내용 |
|---|---|
| Agent | Frontmatter, PROACTIVELY 패턴, model 필드, 라인 수 |
| Skill | Frontmatter, 시스템 메시지, Progressive Disclosure |
| Command | 파일 존재, CLAUDE.md 연동 |
Quick Start
# 1. 전체 패키지 스캔 for pkg in semo-meta semo-next semo-backend semo-po semo-qa semo-core semo-pm; do echo "=== $pkg ===" ls -la $pkg/agents/ 2>/dev/null ls -la $pkg/skills/ 2>/dev/null done # 2. Agent 감사 (Frontmatter 4필드) grep -rL "model:" semo-*/agents/*/*.md # 3. Skill 감사 (100 lines 초과) wc -l semo-*/skills/*/SKILL.md | awk '$1 > 100' # 4. PROACTIVELY 패턴 누락 grep -rL "PROACTIVELY\|Use when" semo-*/agents/*/*.md
감사 체크리스트
Agent 검증
| 항목 | 기준 | 심각도 |
|---|---|---|
| Frontmatter 4필드 | name, description, tools, model | 🔴 Critical |
| PROACTIVELY 패턴 | description에 "PROACTIVELY use when" | 🔴 Critical |
| model 필드 | opus/sonnet/haiku/inherit 중 하나 | 🔴 Critical |
| 라인 수 | 200 lines 이하 | 🟡 Important |
| references/ | 200+ lines 시 분리 | 🟢 Nice-to-have |
Skill 검증
| 항목 | 기준 | 심각도 |
|---|---|---|
| Frontmatter 3필드 | name, description, tools | 🔴 Critical |
| 시스템 메시지 | Frontmatter 직후 blockquote | 🔴 Critical |
| "Use when" 패턴 | description에 포함 | 🟡 Important |
| 라인 수 | 100 lines 이하 | 🟡 Important |
| references/ | 100+ lines 시 분리 | 🟢 Nice-to-have |
Command 검증
| 항목 | 기준 | 심각도 |
|---|---|---|
| 파일 존재 | commands/{name}.md 존재 | 🔴 Critical |
| Frontmatter | name, description 필수 | 🔴 Critical |
| CLAUDE.md 연동 | commands 테이블에 등록 | 🟡 Important |
Output Format
[SEMO] Skill: audit-semo 완료 ## 📊 SEMO 통합 감사 결과 **감사 일시**: {날짜} **감사 범위**: 전체 SEMO 패키지 (7개) ### 📈 요약 | 패키지 | Agent | Skill | Command | 문제 | |--------|-------|-------|---------|------| | semo-meta | 5 ✅ | 6 ✅ | 2 ✅ | 0 | | semo-next | 3 ⚠️ | 8 ✅ | 1 ✅ | 2 | | ... | ... | ... | ... | ... | **총 문제**: 🔴 Critical {n}건, 🟡 Important {n}건, 🟢 Nice-to-have {n}건 ### 🔴 Critical 문제 (즉시 수정 필요) #### semo-next/agents/example-agent - **문제**: model 필드 누락 - **위치**: `semo-next/agents/example-agent/example-agent.md:1-10` - **수정**: Frontmatter에 `model: sonnet` 추가 ### 🟡 Important 문제 (권장 수정) #### semo-po/skills/some-skill - **문제**: SKILL.md 150 lines (100 lines 초과) - **권장**: references/ 분리 ### 📋 권장 조치 1. Critical 문제 우선 수정 2. agent-manager/skill-manager로 수정 작업 위임 3. package-validator로 수정 후 재검증
SEMO Message
[SEMO] Skill: audit-semo 호출 - {범위} [SEMO] Audit: Agent 검사 중... ({n}개) [SEMO] Audit: Skill 검사 중... ({n}개) [SEMO] Audit: Command 검사 중... ({n}개) [SEMO] Skill: audit-semo 완료 (🔴 {n}건, 🟡 {n}건, 🟢 {n}건)
Related
- agent-manager Agent - Agent 수정 위임
- skill-manager Agent - Skill 수정 위임
- package-validator Skill - 단일 패키지 구조 검증
References
- Audit Checklist - 상세 검증 기준
- Scan Commands - 패키지별 스캔 명령어
- Fix Guide - 문제 유형별 수정 가이드