moai-adk 0.15.0__py3-none-any.whl → 0.25.4__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-cc-skill-descriptions/reference.md

@@ -1,218 +0,0 @@
-# Skills Description 개선 정책
-
-> MoAI-ADK의 모든 Skills에 적용되는 description 작성 표준
-
----
-
-## 🎯 설명 (Description) 작성 원칙
-
-### 1. 기본 구조
-
-모든 Skill의 description은 다음 3가지를 포함해야 합니다:
-
-```
-[What it does]: 간단한 기능 설명 (8-12 단어)
-[Key capabilities]: 핵심 기능 목록 (2-3개)
-[When to use]: 사용 시점 (3-5개 트리거 키워드, "Use when" 사용)
-```
-
-### 2. 작성 템플릿
-
-**기본 템플릿**:
-```
-description: [기능 설명]. [핵심 기능]. Use when [트리거1], [트리거2], or [트리거3].
-```
-
-**확장 템플릿** (필요 시):
-```
-description: [기능 설명]. [핵심 기능1], [핵심 기능2]. Use when [트리거1], [트리거2], [트리거3], or [트리거4]. Automatically activates [연관 Skills] for [목적].
-```
-
-### 3. Skills 카테고리별 템플릿
-
-#### Foundation Skills (moai-foundation-*)
-```
-description: [기능]. [핵심 기능 (예: validation, authoring)]. Use when [작업1], [작업2], [작업3], or [작업4].
-```
-**예시**:
-- ✅ "Validates SPEC YAML frontmatter (7 required fields) and HISTORY section. Use when creating SPEC documents, validating SPEC metadata, checking SPEC structure, or authoring specifications."
-- ❌ "SPEC metadata validation" (너무 짧음)
-
-#### Alfred Skills (moai-alfred-*)
-```
-description: [기능]. [핵심 능력]. Use when [검증/분석/관리 대상], [조건], or [상황]. Automatically activates [연관 Skills] for [목적].
-```
-**예시**:
-- ✅ "Validates TRUST 5-principles (Test 85%+, Code constraints, Architecture unity, Security, TAG trackability). Use when validating code quality, checking TRUST compliance, verifying test coverage, or analyzing security patterns. Automatically activates moai-foundation-trust and language-specific skills for comprehensive validation."
-- ❌ "TRUST validation" (너무 짧고 트리거 키워드 없음)
-
-#### Language Skills (moai-lang-*)
-```
-description: [언어] best practices with [주요 도구]. Use when [개발 활동], [패턴], or [특수 케이스].
-```
-**예시**:
-- ✅ "Python best practices with pytest, mypy, ruff, black. Use when writing Python code, implementing tests, type-checking, formatting code, or following PEP standards."
-- ❌ "Python best practices" (너무 일반적)
-
-#### Domain Skills (moai-domain-*)
-```
-description: [도메인] development with [주요 기술/패턴]. Use when [도메인 활동1], [도메인 활동2], or [특수 상황].
-```
-**예시**:
-- ✅ "Backend API development with REST patterns, authentication, error handling. Use when designing REST APIs, implementing authentication, or building backend services."
-- ❌ "Backend development" (구체성 부족)
-
-### 4. 트리거 키워드 가이드
-
-#### 작업 중심 키워드
-- "creating [artifact]", "writing [code/docs]", "implementing [feature]"
-- "validating [aspect]", "checking [quality]", "verifying [compliance]"
-- "analyzing [code/data]", "debugging [issue]", "diagnosing [problem]"
-
-#### 조건 중심 키워드
-- "when working with [file type/framework]"
-- "when developing [feature/component]"
-- "when applying [pattern/practice]"
-
-#### 상황 중심 키워드
-- "for [workflow/process]", "during [phase/stage]"
-- "to [achieve goal/outcome]"
-
-### 5. 금지 사항 (Anti-patterns)
-
-❌ **너무 짧음**:
-```
-description: Helps with documents
-```
-
-❌ **트리거 키워드 없음**:
-```
-description: PDF processing tool
-```
-
-❌ **"I can", "You can" 사용** (첫 인칭 회피):
-```
-description: I help you process Excel files
-```
-
-❌ **기술적 세부사항만**:
-```
-description: Uses pdfplumber library
-```
-
----
-
-## 📊 Skills 목록별 개선 체크리스트
-
-### Priority 1: Foundation Skills (7개)
-- [ ] moai-foundation-specs ✅ 완료
-- [ ] moai-foundation-ears ✅ 완료
-- [ ] moai-foundation-tags
-- [ ] moai-foundation-trust
-- [ ] moai-foundation-langs
-- [ ] moai-claude-code
-- [ ] moai-foundation-git
-
-### Priority 2: Alfred Skills (10개)
-- [ ] moai-alfred-tag-scanning
-- [ ] moai-alfred-trust-validation
-- [ ] moai-alfred-spec-metadata-validation
-- [ ] moai-alfred-code-reviewer
-- [ ] moai-alfred-git-workflow
-- [ ] moai-alfred-ears-authoring
-- [ ] moai-alfred-debugger-pro
-- [ ] moai-alfred-language-detection
-- [ ] moai-alfred-performance-optimizer
-- [ ] moai-alfred-refactoring-coach
-
-### Priority 3: Language Skills (20개)
-- moai-lang-typescript
-- moai-lang-python
-- moai-lang-go
-- moai-lang-rust
-- moai-lang-java
-- ... (14개 더)
-
-### Priority 4: Domain Skills (12개)
-- moai-domain-backend
-- moai-domain-frontend
-- moai-domain-web-api
-- moai-domain-database
-- ... (8개 더)
-
-### Priority 5: Essentials Skills (4개)
-- moai-essentials-debug
-- moai-essentials-review
-- moai-essentials-refactor
-- moai-essentials-perf
-
----
-
-## 🔧 개선 방법
-
-### 방법 1: 개별 Edit (고품질)
-각 Skill의 `description` 필드를 수작업 Edit
-- 이점: 각 Skill에 최적화된 description
-- 단점: 시간이 오래 걸림 (60+ Skills)
-
-### 방법 2: 정책 기반 일괄 개선 (효율성)
-템플릿을 기반으로 Pattern matching으로 우선순위별 개선
-1. Priority 1-2: 개별 Edit (가장 중요)
-2. Priority 3-5: 템플릿 기반 일괄 적용
-
-### 현재 진행 상태
-- ✅ moai-foundation-specs (Priority 1)
-- ✅ moai-foundation-ears (Priority 1)
-- ⏳ 나머지 50+ Skills (Priority 2-5)
-
----
-
-## 📝 작성 예시
-
-### 좋은 예시
-
-#### Foundation Skill
-```yaml
-description: Validates SPEC YAML frontmatter (7 required fields id, version, status, created, updated, author, priority) and HISTORY section. Use when creating SPEC documents, validating SPEC metadata, checking SPEC structure, or authoring specifications.
-```
-
-#### Alfred Skill
-```yaml
-description: Generates descriptive commit messages by analyzing git diffs. Use when writing commit messages, reviewing staged changes, or summarizing code modifications. Automatically activates git-workflow skill for advanced patterns.
-```
-
-#### Language Skill
-```yaml
-description: TypeScript best practices with Vitest, Biome, strict typing. Use when implementing TypeScript code, writing tests, checking code quality, or applying type safety patterns.
-```
-
-#### Domain Skill
-```yaml
-description: REST API design patterns with authentication, versioning, error handling. Use when designing REST APIs, implementing authentication, building backend services, or managing API versions.
-```
-
-### 수정 전 vs 수정 후
-
-| Skill | Before | After |
-|-------|--------|-------|
-| moai-foundation-specs | "Validates SPEC YAML frontmatter (7 required fields) and HISTORY section" | "Validates SPEC YAML frontmatter (7 required fields id, version, status, created, updated, author, priority) and HISTORY section. Use when creating SPEC documents, validating SPEC metadata, checking SPEC structure, or authoring specifications." |
-| moai-foundation-ears | "EARS requirement authoring guide (Ubiquitous/Event/State/Optional/Constraints)" | "EARS requirement authoring guide covering Ubiquitous/Event/State/Optional/Constraints syntax patterns. Use when writing requirements, authoring specifications, defining system behavior, or creating functional requirements." |
-
----
-
-## ✅ 최종 검증 체크리스트
-
-각 Skill의 description이 다음을 만족하는지 확인:
-
-- [ ] **"What it does"**: 명확한 기능 설명 (명사 + 동사)
-- [ ] **"Use when"**: 3~5개 구체적 트리거 키워드 포함
-- [ ] **길이**: 한 줄 (150-200 자 권장)
-- [ ] **관계**: 연관된 Skills 명시 (선택)
-- [ ] **발견성**: 검색 키워드 포함 (sub-agent가 발견 가능)
-- [ ] **첫 인칭 회피**: "I", "You", "Our" 사용 안 함
-- [ ] **기술 중심성 회피**: 라이브러리/도구명보다 기능/목적 우선
-
----
-
-**작성일**: 2025-10-20
-**최종 업데이트**: Phase 2 진행 중

moai_adk/templates/.claude/skills/moai-cc-skill-factory/CHECKLIST.md

@@ -1,482 +0,0 @@
-# Skill Quality Validation Checklist
-
-This checklist ensures every Skill meets MoAI-ADK quality standards before publication. Use this guide for pre-publication audits and release validation.
-
----
-
-## Pre-Publication Audit (40 Points)
-
-Complete this checklist before committing a new Skill to the repository.
-
-### Metadata Completeness (8 Points)
-
-- [ ] **name** field present
-  - [ ] ≤ 64 characters
-  - [ ] Gerund format (action verb)
-  - [ ] Specific and discoverable (not generic like "Python Helper")
-  - Points: 2
-
-- [ ] **description** field present
-  - [ ] ≤ 1024 characters
-  - [ ] Includes 3+ discoverable keywords
-  - [ ] Describes both WHAT (capabilities) and WHEN (use cases)
-  - [ ] Written in third person ("The Skill does X")
-  - Points: 3
-
-- [ ] **allowed-tools** field present
-  - [ ] Tools actually used by Skill
-  - [ ] Minimal scope (no overly broad patterns)
-  - [ ] Properly comma-separated
-  - Points: 1
-
-- [ ] YAML frontmatter valid
-  - [ ] Starts with `---`
-  - [ ] Ends with `---`
-  - [ ] No tabs (spaces only)
-  - Points: 2
-
-**Subtotal**: 8 points
-
-### Content Quality (16 Points)
-
-- [ ] **SKILL.md completeness**
-  - [ ] ≤ 500 lines total
-  - [ ] Clear overview/introduction section
-  - [ ] Progressive Disclosure pattern applied
-  - [ ] Relative paths used for cross-file links
-  - Points: 4
-
-- [ ] **Examples included**
-  - [ ] At least 1 example per major concept
-  - [ ] Concrete code or pseudocode shown
-  - [ ] Examples match skill's freedom level
-  - Points: 2
-
-- [ ] **Terminology consistency**
-  - [ ] Key terms defined once (glossary section)
-  - [ ] Same term used consistently (no synonyms)
-  - [ ] No conflicting definitions
-  - Points: 2
-
-- [ ] **Anti-patterns avoided**
-  - [ ] No time-sensitive information
-  - [ ] No Windows-style paths (`\`)
-  - [ ] No absolute paths
-  - [ ] No vague instructions ("make it fast")
-  - Points: 2
-
-- [ ] **File organization**
-  - [ ] One level deep (no nested subdirs)
-  - [ ] Forward slashes in all paths
-  - [ ] Clear file naming (kebab-case for scripts)
-  - Points: 2
-
-- [ ] **Supporting files (if present)**
-  - [ ] reference.md has clear structure
-  - [ ] examples.md demonstrates 3-4 scenarios
-  - [ ] Files progressively disclosed (not duplicating SKILL.md)
-  - Points: 2
-
-**Subtotal**: 16 points
-
-### Multi-Model Compatibility (8 Points)
-
-Test Skill with Haiku, Sonnet, and Opus (or equivalent):
-
-- [ ] **Haiku activation test**
-  - [ ] Skill activates on relevant request
-  - [ ] Simple examples understood
-  - [ ] Can follow basic patterns
-  - Points: 2
-
-- [ ] **Sonnet full capability test**
-  - [ ] Exploits full Skill depth
-  - [ ] Connects concepts across sections
-  - [ ] Uses all provided patterns
-  - Points: 3
-
-- [ ] **Opus extension test** (if Opus available)
-  - [ ] Can extend patterns beyond examples
-  - [ ] Applies concepts to novel scenarios
-  - [ ] Integrates with broader knowledge
-  - Points: 3
-
-**Subtotal**: 8 points
-
-### Security & Compliance (8 Points)
-
-- [ ] **No sensitive data**
-  - [ ] No credentials, API keys, secrets
-  - [ ] No private email addresses
-  - [ ] No internal URLs or IPs
-  - Points: 2
-
-- [ ] **Scripts security**
-  - [ ] Error handling included (`set -euo pipefail` for Bash)
-  - [ ] Input validation present
-  - [ ] Safe file operations (with backups)
-  - [ ] Exit codes properly used
-  - Points: 2
-
-- [ ] **No risky assumptions**
-  - [ ] No "assuming ~/config exists"
-  - [ ] No system-state dependencies
-  - [ ] Platform-agnostic paths
-  - Points: 2
-
-- [ ] **Destructive operations protected**
-  - [ ] `rm`, `mv`, `mv` require confirmation
-  - [ ] Rollback options documented
-  - [ ] Warnings clearly marked
-  - Points: 2
-
-**Subtotal**: 8 points
-
----
-
-## Verification Checklist (30 Points)
-
-### File Structure (6 Points)
-
-- [ ] Root directory named correctly (skill-name format)
-- [ ] SKILL.md present in root
-- [ ] All files at one level (no nesting)
-- [ ] scripts/ subdirectory (if scripts present)
-- [ ] templates/ subdirectory (if templates present)
-- [ ] No extra directories or files
-  - Points: 6
-
-### File Validity (6 Points)
-
-- [ ] All `.md` files are valid Markdown
-  - [ ] Headers properly formatted (`#`, `##`, etc.)
-  - [ ] Code blocks properly fenced (` ``` `)
-  - [ ] Links properly formatted (`[text](path)`)
-  - Points: 2
-
-- [ ] All scripts have proper shebang
-  - [ ] Bash: `#!/bin/bash`
-  - [ ] Python: `#!/usr/bin/env python3`
-  - [ ] Permissions: 755 or `chmod +x`
-  - Points: 2
-
-- [ ] YAML frontmatter parses correctly
-  - [ ] No syntax errors
-  - [ ] Proper indentation
-  - [ ] All required fields present
-  - Points: 2
-
-### Progressive Disclosure (6 Points)
-
-- [ ] **Level 1 (Metadata)**
-  - [ ] Name, description, allowed-tools complete
-  - [ ] YAML valid
-  - Points: 2
-
-- [ ] **Level 2 (Main Instructions)**
-  - [ ] SKILL.md standalone and complete
-  - [ ] Can understand without reading Level 3
-  - Points: 2
-
-- [ ] **Level 3 (Resources)**
-  - [ ] Supporting files referenced but not required
-  - [ ] Scripts/templates optional enhancements
-  - [ ] No circular dependencies
-  - Points: 2
-
-### Reference Accuracy (6 Points)
-
-- [ ] All links valid
-  - [ ] `[text](reference.md)` links work
-  - [ ] No broken internal links
-  - [ ] No external links (except documentation)
-  - Points: 2
-
-- [ ] All file paths relative
-  - [ ] No absolute paths
-  - [ ] Forward slashes throughout
-  - [ ] Platform-agnostic
-  - Points: 2
-
-- [ ] Scripts and templates discoverable
-  - [ ] Referenced in SKILL.md
-  - [ ] Clear usage instructions
-  - [ ] Easy to find and use
-  - Points: 2
-
-### Completeness (6 Points)
-
-- [ ] All referenced files exist
-  - [ ] Every link points to existing file
-  - [ ] No dangling references
-  - Points: 2
-
-- [ ] No TODO or incomplete sections
-  - [ ] All sections written
-  - [ ] No placeholder text
-  - [ ] No "TBD" or "coming soon"
-  - Points: 2
-
-- [ ] Documentation complete
-  - [ ] Scripts have usage comments
-  - [ ] Templates have placeholders documented
-  - [ ] All examples explained
-  - Points: 2
-
----
-
-## Release Gate Checks (15 Points)
-
-Performed before merge to production:
-
-### Final Review (5 Points)
-
-- [ ] At least 1 peer review completed
-- [ ] No critical issues flagged
-- [ ] All feedback addressed
-  - Points: 5
-
-### Automated Checks (5 Points)
-
-- [ ] YAML syntax valid
-- [ ] Markdown renders without errors
-- [ ] All file paths accessible
-- [ ] No forbidden patterns detected
-  - Points: 5
-
-### Documentation (5 Points)
-
-- [ ] Skill registered in `.moai/memory/skill-registry.md`
-- [ ] CHANGELOG entry added
-- [ ] Version number set (start with 0.1.0)
-  - Points: 5
-
----
-
-## Quick Validation Script
-
-Use this bash script for automated validation:
-
-```bash
-#!/bin/bash
-set -euo pipefail
-
-SKILL_PATH=$1
-SCORE=0
-MAX_SCORE=85
-
-echo "🔍 Validating Skill: $SKILL_PATH"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-
-# Check SKILL.md exists
-if [[ -f "$SKILL_PATH/SKILL.md" ]]; then
-  echo "✓ SKILL.md found"
-  ((SCORE+=5))
-else
-  echo "✗ SKILL.md missing"
-fi
-
-# Check metadata
-if grep -q "^name:" "$SKILL_PATH/SKILL.md"; then
-  echo "✓ name field present"
-  ((SCORE+=2))
-else
-  echo "✗ name field missing"
-fi
-
-if grep -q "^description:" "$SKILL_PATH/SKILL.md"; then
-  echo "✓ description field present"
-  ((SCORE+=2))
-else
-  echo "✗ description field missing"
-fi
-
-# Check file count
-FILE_COUNT=$(find "$SKILL_PATH" -maxdepth 1 -type f | wc -l)
-if [[ $FILE_COUNT -lt 10 ]]; then
-  echo "✓ Reasonable file count ($FILE_COUNT files)"
-  ((SCORE+=3))
-else
-  echo "⚠ Many files ($FILE_COUNT), consider consolidation"
-fi
-
-# Check line count
-SKILL_LINES=$(wc -l < "$SKILL_PATH/SKILL.md" || echo 0)
-if [[ $SKILL_LINES -le 500 ]]; then
-  echo "✓ SKILL.md within limits ($SKILL_LINES lines)"
-  ((SCORE+=3))
-else
-  echo "✗ SKILL.md too large ($SKILL_LINES lines, max 500)"
-fi
-
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "Score: $SCORE/$MAX_SCORE"
-
-if [[ $SCORE -ge 75 ]]; then
-  echo "✅ Ready for publication"
-  exit 0
-else
-  echo "❌ Needs improvement"
-  exit 1
-fi
-```
-
-**Usage**:
-```bash
-./validate-skill.sh /path/to/skill-name
-```
-
----
-
-## Audit Report Template
-
-Document your validation results:
-
-```markdown
-# Skill Audit Report: [Skill Name]
-
-**Date**: [YYYY-MM-DD]
-**Reviewer**: [Name]
-**Status**: ✅ PASS / ❌ FAIL
-
-## Metadata Completeness
-- [x] name (64 chars max)
-- [x] description (includes triggers)
-- [x] allowed-tools (minimal)
-Score: 8/8
-
-## Content Quality
-- [x] SKILL.md ≤ 500 lines
-- [x] Examples included
-- [x] Terminology consistent
-Score: 16/16
-
-## Multi-Model Compatibility
-- [x] Haiku: Can activate and use
-- [x] Sonnet: Full exploitation
-- [x] Opus: Can extend patterns
-Score: 8/8
-
-## Security & Compliance
-- [x] No sensitive data
-- [x] Scripts have error handling
-- [x] No risky assumptions
-- [x] Destructive ops protected
-Score: 8/8
-
-## File Structure
-- [x] Proper organization
-- [x] All files valid
-- [x] Progressive Disclosure applied
-- [x] References accurate
-Score: 24/24
-
-## Release Gate
-- [x] Peer reviewed
-- [x] Automated checks pass
-- [x] Documentation complete
-Score: 15/15
-
----
-
-## Total Score: 85/85 ✅
-
-### Notes
-- Exceeded all quality gates
-- Excellent example coverage
-- Well-structured documentation
-
-### Recommendations
-- None; ready for merge
-
-### Approved By
-[Signature/Name]
-```
-
----
-
-## Common Issues & Fixes
-
-| Issue | Points Lost | Fix | Prevention |
-|-------|------------|-----|-----------|
-| SKILL.md > 500 lines | -5 | Split into reference.md | Plan file structure upfront |
-| No examples | -4 | Add 1+ concrete examples | Add during initial draft |
-| Time-sensitive data | -8 | Remove dates, use "current" | Security audit before draft |
-| Vague descriptions | -5 | Add specific keywords | Test description with Haiku |
-| Broken links | -3 | Verify all references | Run automated checker |
-| Windows paths | -2 | Replace `\` with `/` | Use linter/CI check |
-| No error handling | -3 | Add `set -euo pipefail` | Script template with safety |
-
----
-
-## Passing Criteria
-
-| Score | Status | Action |
-|-------|--------|--------|
-| 85-95 | ✅ Pass | Ready for merge |
-| 75-84 | ⚠️ Minor issues | Fix and retest |
-| 65-74 | ❌ Significant gaps | Major revisions needed |
-| <65 | 🔴 Critical issues | Consider redesign |
-
----
-
-## Checklist Scoring Breakdown
-
-```
-Metadata Completeness ............ 8/8 points
-Content Quality .................. 16/16 points
-Multi-Model Compatibility ........ 8/8 points
-Security & Compliance ............ 8/8 points
-File Structure ................... 6/6 points
-File Validity .................... 6/6 points
-Progressive Disclosure ........... 6/6 points
-Reference Accuracy ............... 6/6 points
-Completeness ..................... 6/6 points
-Final Review ..................... 5/5 points
-Automated Checks ................. 5/5 points
-Documentation .................... 5/5 points
-─────────────────────────────────────────
-TOTAL ............................ 85/85 points
-```
-
----
-
-## Continuous Quality
-
-### Before Merge
-- [ ] All checklist items completed
-- [ ] Score ≥ 85/85
-- [ ] Peer review approved
-- [ ] No blocking issues
-
-### After Merge
-- [ ] Monitor activation patterns
-- [ ] Gather feedback from users
-- [ ] Update if gaps discovered
-- [ ] Version bump for significant changes
-
----
-
-## Related References
-
-- [SKILL.md](SKILL.md) — Main Skill framework
-- [METADATA.md](METADATA.md) — Metadata specifications
-- [STRUCTURE.md](STRUCTURE.md) — File organization
-- [EXAMPLES.md](EXAMPLES.md) — Real-world examples
-- [INTERACTIVE-DISCOVERY.md](INTERACTIVE-DISCOVERY.md) — TUI discovery patterns
-- [WEB-RESEARCH.md](WEB-RESEARCH.md) — Web research strategies
-- [SKILL-UPDATE-ADVISOR.md](SKILL-UPDATE-ADVISOR.md) — Skill analysis & updates
-
----
-
-**Version**: 0.3.0 (with Interactive Discovery, Web Research, & Update Advisor)
-**Last Updated**: 2025-10-22
-**Framework**: MoAI-ADK + Claude Code Skills + skill-factory
-**Key Enhancements**:
-- ✅ Interactive TUI surveys for requirement gathering
-- ✅ Web research integration for latest information
-- ✅ Skill update analysis & recommendations
-- ✅ Official documentation validation
-- ✅ Progressive Disclosure pattern
-- ✅ Freedom level framework
-- ✅ Multi-model compatibility testing