musubix 3.6.1 → 3.7.3

package/.github/skills/context-optimizer/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: context-optimizer
+description: コンテキストウィンドウ最適化。圧縮提案、Pre/PostToolUse Hooks、モード注入。
+license: MIT
+version: 1.1.0
+triggers:
+  - ツール呼び出し50回超過
+  - ファイル編集後
+  - 危険なコマンド実行前
+  - /mode
+---
+
+# Context Optimizer
+
+> **要約**: コンテキストウィンドウを最適化し、効率的なセッション管理を支援。
+
+## 🔄 トリガーと即時アクション
+
+### 1. Strategic Compact (REQ-CO-001/002)
+
+**WHEN** ツール呼び出しが50回に到達  
+**DO** 圧縮を提案
+
+```
+💡 コンテキスト圧縮の提案
+━━━━━━━━━━━━━━━━━━━━━━
+ツール呼び出し: 50回
+フェーズ: [現在のフェーズ]
+━━━━━━━━━━━━━━━━━━━━━━
+圧縮前にsession-managerで状態を保存してください。
+```
+
+**リマインダースケジュール**:
+| 回数 | アクション |
+|------|----------|
+| 50回 | 圧縮提案 |
+| 75回 | リマインダー |
+| 100回 | 強い警告 |
+| 以降25回ごと | リマインダー |
+
+---
+
+### 2. PostToolUse Hooks (REQ-CO-004)
+
+**WHEN** ファイル編集後（Edit/Write）  
+**DO** ファイル種別に応じた自動チェック
+
+| 拡張子 | チェック | コマンド |
+|--------|---------|---------|
+| `.ts`, `.tsx` | 型チェック | `npx tsc --noEmit` |
+| `.ts`, `.tsx`, `.js` | フォーマット | `prettier --check` |
+| `.ts`, `.tsx`, `.js` | console.log検出 | `grep -n "console.log"` |
+
+**問題発見時**: ユーザーに報告し、修正を提案
+
+---
+
+### 3. PreToolUse Hooks (REQ-CO-005)
+
+**WHEN** 以下のコマンド実行前  
+**DO** 確認/警告を表示
+
+| パターン | アクション |
+|---------|----------|
+| `npm install`, `pnpm install` | tmux使用を提案 |
+| `npm run build`, `cargo build` | バックグラウンド実行を提案 |
+| `git push` | 変更差分の最終確認 |
+| `rm -rf`, `git reset --hard` | ⚠️ 破壊的操作の警告 |
+
+---
+
+### 4. Doc Blocker (REQ-CO-006)
+
+**WHEN** Markdownファイル作成時  
+**DO** 必要性を確認（以下は除外）
+
+**除外リスト**: `README.md`, `CHANGELOG.md`, `LICENSE`, `docs/**`, `.github/**`
+
+---
+
+## 🎯 Context Mode (REQ-CO-003)
+
+**WHEN** `/mode <name>` または モード切り替え要求  
+**DO** 対応するコンテキストを注入
+
+| モード | フォーカス | 推奨ツール |
+|--------|----------|----------|
+| `dev` | 実装・コーディング | Edit, Write, Bash |
+| `review` | コードレビュー | Read, Grep, Glob |
+| `research` | 調査・探索 | Read, Grep, semantic_search |
+
+**モード切り替え時の出力**:
+```
+🎯 Mode: [モード名]
+━━━━━━━━━━━━━━━━
+フォーカス: [説明]
+推奨ツール: [ツールリスト]
+```
+
+---
+
+## トレーサビリティ
+
+- REQ-CO-001: Strategic Compact Suggestion
+- REQ-CO-002: Tool Call Counter
+- REQ-CO-003: Context Mode Injection
+- REQ-CO-004: PostToolUse Hooks
+- REQ-CO-005: PreToolUse Hooks
+- REQ-CO-006: Doc Blocker

package/.github/skills/context-optimizer/contexts/dev.md

@@ -0,0 +1,40 @@
+# Development Mode Context
+
+このコンテキストはアクティブな開発・コーディングセッションに最適化されています。
+
+## フォーカス
+
+- 実装とコーディング
+- 機能開発
+- バグ修正
+- コード変更
+
+## 推奨ツール
+
+| ツール | 用途 |
+|--------|------|
+| `Edit` | ファイル編集 |
+| `Write` | 新規ファイル作成 |
+| `Bash` | コマンド実行、ビルド、テスト |
+| `Grep` | コード検索 |
+
+## ベストプラクティス
+
+1. **テスト駆動開発**: 実装前にテストを書く
+2. **小さな変更**: 一度に1つの変更に集中
+3. **頻繁なビルド確認**: 変更後は `npm run build` で確認
+4. **型チェック**: TypeScriptファイル編集後は `npx tsc --noEmit`
+
+## 自動チェック
+
+ファイル編集後、以下を自動実行：
+
+- `.ts`, `.tsx` → `npx tsc --noEmit`
+- `.js`, `.ts`, `.tsx` → Prettier確認
+- console.log検出 → 警告表示
+
+## 避けるべきこと
+
+- 大規模なリファクタリングを一度に行う
+- テストなしでコードをコミット
+- 型エラーを無視する

package/.github/skills/context-optimizer/contexts/research.md

@@ -0,0 +1,55 @@
+# Research Mode Context
+
+このコンテキストは調査・探索セッションに最適化されています。
+
+## フォーカス
+
+- コードベースの理解
+- アーキテクチャの把握
+- 依存関係の調査
+- ドキュメントの確認
+
+## 推奨ツール
+
+| ツール | 用途 |
+|--------|------|
+| `Read` | ファイル内容の確認 |
+| `Grep` | テキスト検索 |
+| `semantic_search` | 意味的なコード検索 |
+| `Glob` | ファイル構造の把握 |
+| `list_dir` | ディレクトリ構造の確認 |
+
+## 調査パターン
+
+### コードベース理解
+1. `README.md` を確認
+2. `package.json` で依存関係を把握
+3. エントリーポイント（`src/index.ts` 等）を確認
+4. ディレクトリ構造を把握
+
+### 機能調査
+1. 関連するファイルを特定（grep/semantic_search）
+2. 主要な関数・クラスを確認
+3. テストファイルで使用例を確認
+4. 型定義を確認
+
+### 依存関係調査
+1. `package.json` で直接依存を確認
+2. `import` 文をgrep検索
+3. 内部モジュール間の依存を追跡
+
+## 質問テンプレート
+
+調査中に以下の質問を意識：
+
+- このコードの目的は何か？
+- 誰がこのコードを使用するか？
+- どのような前提条件があるか？
+- 既知の制限事項は何か？
+- 関連するドキュメントはどこにあるか？
+
+## 避けるべきこと
+
+- 調査中にコードを変更する
+- 理解が不十分なまま結論を出す
+- 関連コードを見落とす

package/.github/skills/context-optimizer/contexts/review.md

@@ -0,0 +1,49 @@
+# Review Mode Context
+
+このコンテキストはコードレビューセッションに最適化されています。
+
+## フォーカス
+
+- コード品質の評価
+- 潜在的なバグの発見
+- ベストプラクティスの確認
+- セキュリティ問題の検出
+
+## 推奨ツール
+
+| ツール | 用途 |
+|--------|------|
+| `Read` | ファイル内容の確認 |
+| `Grep` | パターン検索 |
+| `Glob` | ファイル一覧取得 |
+| `semantic_search` | 関連コードの検索 |
+
+## レビューチェックリスト
+
+### コード品質
+- [ ] 命名規則が一貫している
+- [ ] 関数が単一責任原則に従っている
+- [ ] エラーハンドリングが適切
+- [ ] ログ出力が適切
+
+### セキュリティ
+- [ ] ユーザー入力のバリデーション
+- [ ] SQLインジェクション対策
+- [ ] XSS対策
+- [ ] 認証・認可の確認
+
+### パフォーマンス
+- [ ] N+1クエリがない
+- [ ] 不要なループがない
+- [ ] メモリリークの可能性がない
+
+### テスト
+- [ ] 十分なテストカバレッジ
+- [ ] エッジケースのテスト
+- [ ] エラーケースのテスト
+
+## 避けるべきこと
+
+- レビュー中にコードを直接編集する
+- 細かいスタイルの問題に時間をかけすぎる
+- コンテキストなしで批判する

package/.github/skills/e2e-runner/SKILL.md

@@ -0,0 +1,145 @@
+---
+name: e2e-runner
+description: Playwrightを使用してE2Eテストを生成・実行。クリティカルユーザーフローの検証。
+license: MIT
+version: 1.1.0
+triggers:
+  - /e2e
+  - /playwright
+  - E2Eテスト
+---
+
+# E2E Runner
+
+> **要約**: PlaywrightでE2Eテストを生成・実行。テスト結果のレポートとスクリーンショット管理。
+
+## 📌 コマンド
+
+| コマンド | 説明 |
+|---------|------|
+| `/e2e generate <flow>` | テスト生成 |
+| `/e2e run [flow]` | テスト実行 |
+| `/e2e report` | レポート表示 |
+
+---
+
+## 🎬 テスト生成 (REQ-E2E-001)
+
+**WHEN** `/e2e generate <flow>` 実行  
+**DO** テストファイルを生成
+
+**出力構造**:
+```
+tests/e2e/
+├── <flow>.spec.ts     # テストファイル
+├── fixtures/
+│   └── <flow>.json    # テストデータ
+└── pages/
+    └── <flow>.page.ts # Page Object
+```
+
+**テストテンプレート**:
+```typescript
+import { test, expect } from '@playwright/test';
+
+test.describe('<Flow>', () => {
+  test('should complete flow', async ({ page }) => {
+    // Step 1: Navigate
+    await page.goto('/');
+    
+    // Step 2: Action
+    await page.click('[data-testid="button"]');
+    
+    // Step 3: Assert
+    await expect(page.locator('.success')).toBeVisible();
+  });
+});
+```
+
+---
+
+## ▶️ テスト実行 (REQ-E2E-002)
+
+**WHEN** `/e2e run [flow]` 実行  
+**DO** Playwrightでテスト実行
+
+| オプション | 説明 |
+|-----------|------|
+| `--headed` | ブラウザ表示 |
+| `--debug` | デバッグモード |
+| `--trace` | トレース記録 |
+| `--browser <name>` | ブラウザ指定 |
+
+```bash
+# 全テスト
+npx playwright test
+
+# 特定フロー
+npx playwright test tests/e2e/login.spec.ts
+
+# デバッグ
+npx playwright test --debug
+```
+
+---
+
+## 📊 レポート (REQ-E2E-003)
+
+**WHEN** テスト完了  
+**DO** レポート生成
+
+```
+📊 E2E Test Report
+━━━━━━━━━━━━━━━━━━━━━━━━
+Total:   10 tests
+Passed:  8 ✅
+Failed:  2 ❌
+Skipped: 0
+
+Duration: 45.2s
+━━━━━━━━━━━━━━━━━━━━━━━━
+
+Failed Tests:
+1. login.spec.ts > should login
+   Error: Timeout waiting for selector
+   Screenshot: playwright-report/login-1.png
+
+2. checkout.spec.ts > should pay
+   Error: Element not found
+   Screenshot: playwright-report/checkout-1.png
+```
+
+**HTMLレポート**:
+```bash
+npx playwright show-report
+```
+
+---
+
+## 📁 設定
+
+**playwright.config.ts**:
+```typescript
+export default defineConfig({
+  testDir: './tests/e2e',
+  timeout: 30000,
+  retries: 2,
+  use: {
+    baseURL: 'http://localhost:3000',
+    screenshot: 'only-on-failure',
+    trace: 'retain-on-failure',
+  },
+  projects: [
+    { name: 'chromium', use: { ...devices['Desktop Chrome'] } },
+    { name: 'firefox', use: { ...devices['Desktop Firefox'] } },
+  ],
+});
+```
+
+---
+
+## トレーサビリティ
+
+- REQ-E2E-001: E2E Test Generation
+- REQ-E2E-002: E2E Test Execution
+- REQ-E2E-003: E2E Report

package/.github/skills/eval-harness/SKILL.md

@@ -0,0 +1,111 @@
+---
+name: eval-harness
+description: pass@kメトリクスでAIコード生成の品質を評価。Capability/Regression評価をサポート。
+license: MIT
+version: 1.1.0
+triggers:
+  - /eval
+  - 機能評価
+  - 回帰テスト
+---
+
+# Eval Harness
+
+> **要約**: AIコード生成の品質を定量的に評価。pass@kメトリクスと複数の評価タイプをサポート。
+
+## 📊 評価タイプ
+
+### 1. Capability Eval (REQ-EH-001)
+
+**WHEN** 新機能の品質評価が必要  
+**DO** 以下のフォーマットで定義
+
+```markdown
+[CAPABILITY EVAL: <feature-name>]
+Task: <達成タスク>
+Success Criteria:
+  - [ ] 基準1
+  - [ ] 基準2
+  - [ ] 基準3
+Expected Output: <期待出力>
+Test Command: <テストコマンド>
+```
+
+---
+
+### 2. Regression Eval (REQ-EH-002)
+
+**WHEN** 既存機能の品質維持を確認  
+**DO** 以下のフォーマットで定義
+
+```markdown
+[REGRESSION EVAL: <feature-name>]
+Baseline: <Git SHA / チェックポイント>
+Tests:
+  - test-1: PASS/FAIL
+  - test-2: PASS/FAIL
+Result: X/Y passed (previously Y/Y)
+Regression: Yes/No
+```
+
+---
+
+## 📈 pass@k Metrics (REQ-EH-003)
+
+| メトリクス | 定義 | 用途 |
+|-----------|------|------|
+| **pass@1** | 初回試行成功率 | 基本信頼度 |
+| **pass@3** | 3回中1回以上成功 | 一般ターゲット |
+| **consecutive@3** | 3回連続成功 | クリティカルパス |
+
+**計算**:
+```
+pass@1 = 成功数 / 試行数
+pass@k = 1 - C(n-c, k) / C(n, k)
+consecutive@3 = 連続成功シーケンス数 / 可能シーケンス数
+```
+
+**レポート例**:
+```
+📊 Eval Report: user-auth
+━━━━━━━━━━━━━━━━━━━━
+pass@1: 80% (8/10)
+pass@3: 95% 
+consecutive@3: 60%
+━━━━━━━━━━━━━━━━━━━━
+Status: ✅ Meets target
+```
+
+---
+
+## 🔍 Grader Types (REQ-EH-004/005)
+
+| タイプ | 説明 | 使用場面 |
+|--------|------|---------|
+| **Code-Based** | コマンド実行で判定 | 決定的な検証 |
+| **Model-Based** | LLMで判定 | 自由形式の評価 |
+| **Human** | 人手で判定 | 主観的品質評価 |
+
+### Human Grader Template
+
+```markdown
+[HUMAN GRADE: <feature>]
+Reviewer: @username
+Checklist:
+  - [ ] 仕様を満たしている
+  - [ ] エッジケース考慮
+  - [ ] API互換性維持
+  - [ ] セキュリティ問題なし
+Verdict: PASS/FAIL
+Notes: [コメント]
+```
+
+---
+
+## トレーサビリティ
+
+- REQ-EH-001: Capability Eval Definition
+- REQ-EH-002: Regression Eval Definition
+- REQ-EH-003: pass@k Metrics
+- REQ-EH-004: Grader Types
+- REQ-EH-005: Human Grader Support

package/.github/skills/eval-harness/examples/capability-eval.md

@@ -0,0 +1,158 @@
+# Capability Eval Examples
+
+## Example 1: User Authentication Feature
+
+```markdown
+[CAPABILITY EVAL: user-authentication]
+
+Task: JWTベースのユーザー認証機能を実装する
+
+Success Criteria:
+  - [x] ログインエンドポイントが正常に動作する
+  - [x] JWTトークンが正しく生成される
+  - [x] トークン検証ミドルウェアが機能する
+  - [ ] リフレッシュトークンが実装されている
+
+Expected Output: 
+  - POST /api/auth/login → 200 OK + JWT token
+  - GET /api/protected → 401 without token, 200 with valid token
+
+Constraints:
+  - bcryptを使用したパスワードハッシュ
+  - トークン有効期限: 15分
+  - リフレッシュトークン有効期限: 7日
+
+Test Command: npm run test:auth
+
+Result: 3/4 criteria met
+Status: PARTIAL PASS
+```
+
+---
+
+## Example 2: API Rate Limiting
+
+```markdown
+[CAPABILITY EVAL: api-rate-limiting]
+
+Task: APIエンドポイントにレート制限を実装する
+
+Success Criteria:
+  - [x] IPベースのレート制限が機能する
+  - [x] 制限超過時に429エラーを返す
+  - [x] X-RateLimit-* ヘッダーが正しく設定される
+  - [x] Redis/メモリでの状態管理が動作する
+  - [x] ホワイトリストIPが除外される
+
+Expected Output:
+  - 正常リクエスト → 200 OK + X-RateLimit-Remaining: 99
+  - 制限超過 → 429 Too Many Requests + Retry-After header
+
+Constraints:
+  - 制限: 100 requests/minute/IP
+  - スライディングウィンドウアルゴリズム
+
+Test Command: npm run test:rate-limit
+
+Result: 5/5 criteria met
+Status: PASS
+```
+
+---
+
+## Example 3: Data Export Feature
+
+```markdown
+[CAPABILITY EVAL: data-export-csv]
+
+Task: ユーザーデータをCSV形式でエクスポートする機能を実装する
+
+Success Criteria:
+  - [x] CSVファイルが正しいフォーマットで生成される
+  - [x] 大量データ（10万件以上）でもメモリ効率が良い
+  - [x] ダウンロードAPIエンドポイントが動作する
+  - [ ] 非同期エクスポートがサポートされる
+  - [x] 文字エンコーディング（UTF-8 BOM）が正しい
+
+Expected Output:
+  - GET /api/export/users → CSV file download
+  - Content-Type: text/csv; charset=utf-8
+  - Content-Disposition: attachment; filename="users-YYYY-MM-DD.csv"
+
+Constraints:
+  - ストリーミング処理でメモリ消費を抑制
+  - 最大エクスポート件数: 100万件
+
+Test Command: npm run test:export
+
+Result: 4/5 criteria met
+Status: PARTIAL PASS
+
+Notes:
+  - 非同期エクスポートは次のスプリントで実装予定
+```
+
+---
+
+## Example 4: Search Feature with Elasticsearch
+
+```markdown
+[CAPABILITY EVAL: elasticsearch-search]
+
+Task: Elasticsearchを使用した全文検索機能を実装する
+
+Success Criteria:
+  - [x] 基本的なキーワード検索が動作する
+  - [x] ファセット検索（フィルタリング）がサポートされる
+  - [x] ハイライト機能が動作する
+  - [x] ページネーションが正しく実装される
+  - [x] 検索結果のソートが機能する
+  - [x] 検索サジェスト（オートコンプリート）が動作する
+
+Expected Output:
+  - GET /api/search?q=keyword → { hits: [...], total: N, facets: {...} }
+  - レスポンス時間: 200ms以内
+
+Constraints:
+  - Elasticsearch 8.x 使用
+  - 日本語形態素解析（kuromoji）対応
+  - 同義語辞書のサポート
+
+Test Command: npm run test:search
+
+Result: 6/6 criteria met
+Status: PASS
+```
+
+---
+
+## Template for New Capability Eval
+
+```markdown
+[CAPABILITY EVAL: <feature-name>]
+
+Task: <達成すべきタスクの詳細説明>
+
+Success Criteria:
+  - [ ] <成功基準1 - 測定可能で明確に>
+  - [ ] <成功基準2>
+  - [ ] <成功基準3>
+  - [ ] <成功基準4>
+  - [ ] <成功基準5>
+
+Expected Output: 
+  <期待される出力の具体例>
+
+Constraints:
+  - <制約条件1>
+  - <制約条件2>
+  - <制約条件3>
+
+Test Command: <テスト実行コマンド>
+
+Result: X/Y criteria met
+Status: <PASS|PARTIAL PASS|FAIL>
+
+Notes:
+  - <追加の注記や改善点>
+```