generate-subsystem-skills

サブシステムスキルの生成

このスキルは、LlamaFarm モノレポ内の各サブシステムを分析し、セキュリティ、パフォーマンス、言語固有のベストプラクティスに関する Claude Code スキルを生成します。

使用方法

/generate-subsystem-skills

---

生成される内容

共通言語スキル（4）

• python-skills/ - 使用先：server、rag、runtime、config、common
• go-skills/ - 使用先：cli
• typescript-skills/ - 使用先：designer、electron
• react-skills/ - 使用先：designer

サブシステム固有のスキル（8）

• cli-skills/ - Cobra、Bubbletea のパターン
• server-skills/ - FastAPI、Celery、Pydantic のパターン
• rag-skills/ - LlamaIndex、ChromaDB のパターン
• runtime-skills/ - PyTorch、Transformers のパターン
• designer-skills/ - TanStack Query、Tailwind、Radix のパターン
• electron-skills/ - Electron IPC、セキュリティのパターン
• config-skills/ - Pydantic、JSONSchema のパターン
• common-skills/ - HuggingFace Hub のパターン

---

生成プロセス

ステップ 1：レジストリを読み込む

subsystem-registry.md からサブシステムの定義を読み込みます。

ステップ 2：共通言語スキルを生成する

サブエージェントを並列で起動して、次のスキルを生成します。

1. Python スキルエージェント - Python サブシステム（server、rag、runtime、config、common）を分析し、理想的なパターンを特定して、python-skills/ を生成します。

2. Go スキルエージェント - CLI サブシステムを分析し、理想的な Go パターンを特定して、go-skills/ を生成します。

3. TypeScript スキルエージェント - designer と electron を分析し、理想的な TS パターンを特定して、typescript-skills/ を生成します。

4. React スキルエージェント - designer を分析し、理想的な React 18 パターンを特定して、react-skills/ を生成します。

ステップ 3：サブシステムスキルを生成する

各サブシステムについて、サブエージェントを並列で起動します。

各サブシステムについて、エージェントは次の作業を行います。

1. サブシステムの依存関係ファイル（package.json、pyproject.toml、go.mod）を読み込みます。
2. Grep と Read を使ってコードパターンを分析します。
3. 共通言語スキルへのリンクを含む SKILL.md を生成します。
4. フレームワーク固有のチェックリストファイルを生成します。
5. すべてのファイルを .claude/skills/{subsystem}-skills/ に書き込みます。

ステップ 4：概要を報告する

すべてのエージェントが完了したら、次の内容を報告します。

• 生成したスキルの数
• 作成したファイルの合計数
• 発生したエラー

---

サブエージェントのプロンプトテンプレート

共通言語スキル用

You are generating a shared {LANGUAGE} skills directory for Claude Code.

Analyze these subsystems that use {LANGUAGE}:
{SUBSYSTEM_PATHS}

Your task:
1. Read key files to understand patterns used
2. When patterns vary, document the IDEAL approach (not inconsistencies)
3. Reference industry best practices
4. Generate files in .claude/skills/{LANGUAGE}-skills/

Files to generate:
- SKILL.md (overview, ~100 lines)
- patterns.md (idiomatic patterns)
- error-handling.md
- testing.md
- security.md
- {additional language-specific files}

Each checklist item should have:
- Description of what to check
- Search pattern (grep command)
- Pass/fail criteria
- Severity level

サブシステムスキル用

You are generating subsystem-specific skills for {SUBSYSTEM} in Claude Code.

Directory: {PATH}
Tech Stack: {TECH_STACK}
Links to: {SHARED_SKILLS}

Your task:
1. Read dependency files and key source files
2. Identify framework-specific patterns
3. Generate SKILL.md that links to shared language skills
4. Generate framework-specific checklists

Files to generate:
- SKILL.md (overview with links to shared skills)
- {framework}.md for each framework used
- performance.md (subsystem-specific optimizations)

Remember: Document IDEAL patterns, not existing inconsistencies.

---

重要な原則

理想的なパターンを推奨する - コードベース内でパターンに一貫性がない場合、生成するスキルでは、既存の不整合をそのまま規範化するのではなく、業界標準に基づくベストプラクティスを記述してください。

---

出力先

すべてのスキルは .claude/skills/ に、次の構成で書き込まれます。

.claude/skills/
├── python-skills/      # Shared
├── go-skills/          # Shared
├── typescript-skills/  # Shared
├── react-skills/       # Shared
├── cli-skills/         # Subsystem
├── server-skills/      # Subsystem
├── rag-skills/         # Subsystem
├── runtime-skills/     # Subsystem
├── designer-skills/    # Subsystem
├── electron-skills/    # Subsystem
├── config-skills/      # Subsystem
└── common-skills/      # Subsystem