audit-semo
전체 SEMO 패키지 통합 품질 감사. Use when (1) 전체 패키지 품질 점검, (2) Agent/Skill/Command 표준 준수 검토, (3) 비효율적 구조 탐지, (4) 정기 감사 수행.
When & Why to Use This Skill
The audit-semo skill is a comprehensive quality assurance and compliance tool designed for the SEMO agentic framework. It automates the auditing of Agents, Skills, and Commands to ensure they strictly adhere to architectural standards, maintain optimal file lengths, and include mandatory metadata such as frontmatter and proactive triggers. By scanning multiple packages and identifying critical structural issues, it provides developers with actionable reports to maintain a high-quality, scalable, and efficient AI agent ecosystem.
Use Cases
- Standard Compliance: Automatically verify if all Agents and Skills across a repository contain required frontmatter fields like 'model', 'name', and 'description' to prevent runtime errors.
- Structural Optimization: Identify bloated Skill or Agent files that exceed recommended line counts (e.g., 100-200 lines), prompting developers to refactor code into modular references.
- Behavioral Consistency: Detect missing 'PROACTIVELY' patterns or system message blocks in Skill definitions to ensure agents trigger correctly and follow established interaction protocols.
- Multi-Package Health Checks: Perform scheduled audits across various modules (e.g., semo-backend, semo-next) to generate a centralized quality report with prioritized 'Critical' and 'Important' issues.
- Integration Validation: Ensure all Commands are properly registered in CLAUDE.md and that the physical file structure matches the framework's documentation requirements.
| name | audit-semo |
|---|---|
| description | 전체 SEMO 패키지 통합 품질 감사. Use when (1) 전체 패키지 품질 점검, (2) Agent/Skill/Command 표준 준수 검토, (3) 비효율적 구조 탐지, (4) 정기 감사 수행. |
| tools | [Bash, Read, Grep, Glob] |
🔔 시스템 메시지: 이 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 - 문제 유형별 수정 가이드