musubix 3.6.1 → 3.7.3

package/.github/skills/eval-harness/examples/human-grader-template.md

@@ -0,0 +1,326 @@
+# Human Grader Templates
+
+## Standard Human Grader Template
+
+```markdown
+[HUMAN GRADE: <feature-name>]
+
+Reviewer: @<username>
+Date: YYYY-MM-DD
+Review Type: <Initial|Re-review|Final>
+
+---
+
+## Checklist
+
+### Functional Requirements
+  - [ ] 仕様を満たしている
+  - [ ] 全ての機能が正常に動作する
+  - [ ] エッジケースが考慮されている
+  - [ ] エラーハンドリングが適切
+
+### Code Quality
+  - [ ] コードが読みやすい
+  - [ ] 命名規則が一貫している
+  - [ ] 重複コードがない（DRY原則）
+  - [ ] 適切な抽象化レベル
+
+### Compatibility
+  - [ ] 既存API互換性が維持されている
+  - [ ] 後方互換性が確保されている
+  - [ ] 破壊的変更がある場合は文書化されている
+
+### Security
+  - [ ] セキュリティ上の懸念がない
+  - [ ] 入力バリデーションが適切
+  - [ ] 機密データの取り扱いが安全
+  - [ ] 認証・認可が正しく実装されている
+
+### Performance
+  - [ ] パフォーマンス要件を満たす
+  - [ ] N+1クエリがない
+  - [ ] 適切なキャッシュ戦略
+  - [ ] メモリリークの懸念がない
+
+### Testing
+  - [ ] テストカバレッジが十分（80%以上）
+  - [ ] ユニットテストが存在する
+  - [ ] 統合テストが存在する
+  - [ ] エッジケースのテストがある
+
+### Documentation
+  - [ ] コードコメントが適切
+  - [ ] APIドキュメントが更新されている
+  - [ ] READMEが更新されている（必要な場合）
+
+---
+
+## Scores (1-5)
+
+| Category        | Score | Notes                    |
+|-----------------|-------|--------------------------|
+| Functionality   |   /5  |                          |
+| Code Quality    |   /5  |                          |
+| Maintainability |   /5  |                          |
+| Documentation   |   /5  |                          |
+
+**Total: XX/20**
+
+---
+
+## Detailed Feedback
+
+### Strengths
+1. 
+2. 
+3. 
+
+### Areas for Improvement
+1. 
+2. 
+3. 
+
+### Critical Issues (if any)
+- 
+
+---
+
+## Verdict
+
+**Decision: <PASS|FAIL|NEEDS_REVISION>**
+
+### If NEEDS_REVISION, required changes:
+1. 
+2. 
+
+### Follow-up Actions:
+- [ ] 
+- [ ] 
+
+---
+
+**Signature:** [Reviewer Name]  
+**Date:** YYYY-MM-DD
+```
+
+---
+
+## Specialized Templates
+
+### Security Review Template
+
+```markdown
+[HUMAN GRADE: <feature-name> - Security Review]
+
+Reviewer: @<security-reviewer>
+Date: YYYY-MM-DD
+Review Type: Security Audit
+
+---
+
+## Security Checklist
+
+### Authentication
+  - [ ] 認証メカニズムが適切
+  - [ ] セッション管理が安全
+  - [ ] パスワードポリシーが適切
+  - [ ] MFAの考慮
+
+### Authorization
+  - [ ] アクセス制御が正しく実装
+  - [ ] 権限昇格の脆弱性なし
+  - [ ] リソースベースの認可
+
+### Data Protection
+  - [ ] 機密データの暗号化
+  - [ ] PII/PHIの適切な取り扱い
+  - [ ] データの最小化原則
+
+### Input Validation
+  - [ ] 全入力のバリデーション
+  - [ ] SQLインジェクション対策
+  - [ ] XSS対策
+  - [ ] CSRF対策
+
+### API Security
+  - [ ] レート制限
+  - [ ] 適切なエラーメッセージ
+  - [ ] ログの適切な出力
+
+---
+
+## Risk Assessment
+
+| Vulnerability Type | Risk Level | Status |
+|-------------------|------------|--------|
+| Injection         | Low/Med/High | ✅/⚠️/❌ |
+| Broken Auth       | Low/Med/High | ✅/⚠️/❌ |
+| XSS               | Low/Med/High | ✅/⚠️/❌ |
+| CSRF              | Low/Med/High | ✅/⚠️/❌ |
+| Broken Access     | Low/Med/High | ✅/⚠️/❌ |
+
+---
+
+## Findings
+
+### Critical (Must Fix)
+1. 
+
+### High (Should Fix)
+1. 
+
+### Medium (Consider Fixing)
+1. 
+
+### Low (Nice to Fix)
+1. 
+
+---
+
+**Security Verdict: <APPROVED|REJECTED|CONDITIONAL>**
+```
+
+---
+
+### Architecture Review Template
+
+```markdown
+[HUMAN GRADE: <feature-name> - Architecture Review]
+
+Reviewer: @<architect>
+Date: YYYY-MM-DD
+Review Type: Architecture Decision
+
+---
+
+## Architecture Checklist
+
+### Design Principles
+  - [ ] Single Responsibility Principle
+  - [ ] Open/Closed Principle
+  - [ ] Liskov Substitution Principle
+  - [ ] Interface Segregation Principle
+  - [ ] Dependency Inversion Principle
+
+### Patterns
+  - [ ] 適切なデザインパターンの使用
+  - [ ] アンチパターンの回避
+  - [ ] 過度な複雑さの回避
+
+### Scalability
+  - [ ] 水平スケーラビリティの考慮
+  - [ ] ボトルネックの特定と対策
+  - [ ] 負荷分散の戦略
+
+### Maintainability
+  - [ ] モジュール性
+  - [ ] テスタビリティ
+  - [ ] 変更容易性
+
+---
+
+## Architecture Decision Record
+
+### Context
+<決定の背景>
+
+### Decision
+<選択したアプローチ>
+
+### Consequences
+<この決定の結果・影響>
+
+### Alternatives Considered
+1. <代替案1>: <却下理由>
+2. <代替案2>: <却下理由>
+
+---
+
+**Architecture Verdict: <APPROVED|NEEDS_REVISION|REJECTED>**
+```
+
+---
+
+### UX Review Template
+
+```markdown
+[HUMAN GRADE: <feature-name> - UX Review]
+
+Reviewer: @<ux-designer>
+Date: YYYY-MM-DD
+Review Type: User Experience
+
+---
+
+## UX Checklist
+
+### Usability
+  - [ ] 直感的なUI
+  - [ ] 一貫したデザイン言語
+  - [ ] 適切なフィードバック
+  - [ ] エラー回復が容易
+
+### Accessibility
+  - [ ] キーボードナビゲーション
+  - [ ] スクリーンリーダー対応
+  - [ ] 色覚多様性への配慮
+  - [ ] 適切なコントラスト比
+
+### Performance Perception
+  - [ ] ローディング状態の表示
+  - [ ] スケルトンUI
+  - [ ] 楽観的更新
+  - [ ] 適切なアニメーション
+
+---
+
+## Heuristic Evaluation
+
+| Heuristic                    | Score (1-5) |
+|------------------------------|-------------|
+| Visibility of System Status  |     /5      |
+| Match with Real World        |     /5      |
+| User Control & Freedom       |     /5      |
+| Consistency & Standards      |     /5      |
+| Error Prevention             |     /5      |
+| Recognition over Recall      |     /5      |
+| Flexibility & Efficiency     |     /5      |
+| Aesthetic & Minimal Design   |     /5      |
+| Help Users with Errors       |     /5      |
+| Help & Documentation         |     /5      |
+
+**Total: XX/50**
+
+---
+
+**UX Verdict: <APPROVED|NEEDS_IMPROVEMENT|REJECTED>**
+```
+
+---
+
+## Usage Guidelines
+
+### When to Use Human Grader
+
+1. **主観的判断が必要な場合**
+   - UI/UXの品質評価
+   - コードの読みやすさ
+   - 設計の妥当性
+
+2. **ドメイン専門知識が必要な場合**
+   - ビジネスロジックの正確性
+   - 法規制への準拠
+   - 業界標準への適合
+
+3. **自動化が困難な場合**
+   - クロスブラウザ互換性
+   - アクセシビリティ
+   - パフォーマンス体感
+
+### Best Practices
+
+- 複数のレビュアーによる評価を推奨
+- チェックリストは事前に合意して一貫性を保つ
+- 主観的判断には必ず理由を明記
+- NEEDS_REVISIONの場合は具体的な改善点を列挙
+- フォローアップアクションを明確に定義

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

@@ -0,0 +1,228 @@
+# Regression Eval Examples
+
+## Example 1: User Service Regression
+
+```markdown
+[REGRESSION EVAL: user-service]
+
+Baseline: abc1234 (v3.6.0 release)
+Date: 2026-01-25
+
+Tests:
+  - user.create.test.ts: PASS
+  - user.update.test.ts: PASS
+  - user.delete.test.ts: FAIL
+  - user.search.test.ts: PASS
+  - user.auth.test.ts: PASS
+
+Result: 4/5 passed (previously 5/5)
+
+Regression Detected: Yes
+
+Failed Test Details:
+  - user.delete.test.ts:
+    - Error: "ValidationError: Cannot delete user with active sessions"
+    - Line: 45
+    - Expected: 204 No Content
+    - Actual: 400 Bad Request
+
+Root Cause:
+  - 新しいバリデーションルールが追加され、アクティブセッションを持つユーザーの削除が禁止された
+
+Resolution:
+  - [ ] テストを更新して新しい挙動を反映
+  - [ ] または、バリデーションルールの見直し
+
+Notes:
+  - この変更は意図的なセキュリティ強化
+  - テストケースの更新が必要
+```
+
+---
+
+## Example 2: API Endpoint Regression
+
+```markdown
+[REGRESSION EVAL: api-endpoints]
+
+Baseline: def5678 (v3.5.0 release)
+Date: 2026-01-25
+
+Tests:
+  - api.auth.test.ts: PASS
+  - api.users.test.ts: PASS
+  - api.products.test.ts: PASS
+  - api.orders.test.ts: PASS
+  - api.payments.test.ts: PASS
+
+Result: 5/5 passed (previously 5/5)
+
+Regression Detected: No
+
+Performance Comparison:
+  | Endpoint      | Baseline | Current | Change |
+  |---------------|----------|---------|--------|
+  | GET /users    | 45ms     | 42ms    | -6.7%  |
+  | POST /orders  | 120ms    | 115ms   | -4.2%  |
+  | GET /products | 30ms     | 28ms    | -6.7%  |
+
+Notes:
+  - パフォーマンスの改善を確認
+  - 機能的な回帰なし
+```
+
+---
+
+## Example 3: Database Migration Regression
+
+```markdown
+[REGRESSION EVAL: database-schema]
+
+Baseline: ghi9012 (pre-migration)
+Date: 2026-01-25
+
+Tests:
+  - migration.up.test.ts: PASS
+  - migration.down.test.ts: PASS
+  - schema.integrity.test.ts: FAIL
+  - data.consistency.test.ts: PASS
+  - index.performance.test.ts: PASS
+
+Result: 4/5 passed (previously 5/5)
+
+Regression Detected: Yes
+
+Failed Test Details:
+  - schema.integrity.test.ts:
+    - Error: "Foreign key constraint violation"
+    - Table: orders
+    - Constraint: fk_orders_users
+    - Reason: 孤立したorder レコードが存在
+
+Root Cause:
+  - マイグレーション前に外部キー制約がなかったため、不整合データが存在
+  - マイグレーションで制約を追加したことで検出
+
+Resolution:
+  - [x] 不整合データのクリーンアップスクリプトを実行
+  - [x] 制約を段階的に適用（まずソフト制約、その後ハード制約）
+  - [ ] データ検証の自動化テストを追加
+
+Notes:
+  - 本番環境適用前にデータクリーンアップが必須
+```
+
+---
+
+## Example 4: Frontend Component Regression
+
+```markdown
+[REGRESSION EVAL: ui-components]
+
+Baseline: jkl3456 (design-system-v2)
+Date: 2026-01-25
+
+Tests:
+  - button.visual.test.ts: PASS
+  - input.visual.test.ts: PASS
+  - modal.visual.test.ts: FAIL
+  - table.visual.test.ts: PASS
+  - form.visual.test.ts: PASS
+  - navigation.visual.test.ts: PASS
+
+Result: 5/6 passed (previously 6/6)
+
+Regression Detected: Yes
+
+Failed Test Details:
+  - modal.visual.test.ts:
+    - Error: "Visual diff exceeded threshold (15% vs 5% allowed)"
+    - Screenshot: .reports/screenshots/modal-diff.png
+    - Affected area: Close button position
+
+Root Cause:
+  - Flexboxのalign-items変更によりボタン位置が変化
+
+Resolution:
+  - [ ] CSSの修正
+  - [ ] または、ベースライン画像の更新（意図的変更の場合）
+
+Notes:
+  - デザインチームに確認が必要
+```
+
+---
+
+## Example 5: Security Regression
+
+```markdown
+[REGRESSION EVAL: security-scan]
+
+Baseline: mno7890 (security-audit-q4)
+Date: 2026-01-25
+
+Tests:
+  - auth.security.test.ts: PASS
+  - xss.prevention.test.ts: PASS
+  - csrf.protection.test.ts: PASS
+  - sql.injection.test.ts: PASS
+  - dependency.audit.test.ts: FAIL
+
+Result: 4/5 passed (previously 5/5)
+
+Regression Detected: Yes
+
+Failed Test Details:
+  - dependency.audit.test.ts:
+    - Error: "2 high severity vulnerabilities found"
+    - Packages:
+      1. lodash@4.17.20 → CVE-2021-23337 (Prototype Pollution)
+      2. axios@0.21.0 → CVE-2021-3749 (ReDoS)
+
+Resolution:
+  - [x] lodash を 4.17.21 に更新
+  - [x] axios を 0.21.4 に更新
+  - [x] npm audit を再実行して確認
+
+Notes:
+  - 依存関係の自動更新を検討
+  - Dependabotの設定を確認
+```
+
+---
+
+## Template for New Regression Eval
+
+```markdown
+[REGRESSION EVAL: <feature-name>]
+
+Baseline: <Git SHA または チェックポイント名> (<説明>)
+Date: YYYY-MM-DD
+
+Tests:
+  - <test-file-1>: <PASS|FAIL>
+  - <test-file-2>: <PASS|FAIL>
+  - <test-file-3>: <PASS|FAIL>
+  - <test-file-4>: <PASS|FAIL>
+
+Result: X/Y passed (previously Y/Y)
+
+Regression Detected: <Yes|No>
+
+Failed Test Details (if any):
+  - <test-file>:
+    - Error: "<エラーメッセージ>"
+    - Line: <行番号>
+    - Expected: <期待値>
+    - Actual: <実際の値>
+
+Root Cause:
+  - <回帰の原因分析>
+
+Resolution:
+  - [ ] <解決策1>
+  - [ ] <解決策2>
+
+Notes:
+  - <追加の注記>
+```

package/.github/skills/learning-hooks/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: learning-hooks
+description: セッションから再利用可能なパターンを自動抽出し、学習済みスキルとして保存。
+license: MIT
+version: 1.1.0
+triggers:
+  - セッション終了（10メッセージ以上）
+  - エラー解決後
+  - ユーザー修正後
+---
+
+# Learning Hooks
+
+> **要約**: セッションから再利用可能なパターンを自動抽出し、次回以降に活用。
+
+## 🔄 トリガーと即時アクション
+
+### パターン抽出 (REQ-LH-001)
+
+**WHEN** セッション終了時（条件: メッセージ10件以上 AND 15分以上）  
+**DO** 以下のパターンを抽出
+
+| タイプ | 説明 | 抽出条件 |
+|--------|------|---------|
+| `error_resolution` | エラー解決 | エラー→修正→解消の流れ |
+| `user_corrections` | ユーザー修正 | AI提案を修正→承認 |
+| `workarounds` | 回避策 | ライブラリ既知問題への対処 |
+| `debugging_techniques` | デバッグ技法 | 問題調査・解決手法 |
+| `project_specific` | プロジェクト固有 | アーキテクチャ、命名規則 |
+
+### 抽出フロー
+
+```
+セッション終了 → 条件チェック → 会話分析 → パターン候補 → 信頼度計算(≥0.7) → 保存
+```
+
+---
+
+## 📁 Learned Skills Storage (REQ-LH-002)
+
+**保存先**: `~/.musubix/skills/learned/<pattern-name>/SKILL.md`
+
+**フォーマット**:
+```markdown
+# [パターン名]
+
+**Extracted:** [日付]
+**Context:** [適用条件]
+**Confidence:** [信頼度]
+
+## Problem
+[解決する問題]
+
+## Solution
+[パターン/技法/回避策]
+
+## Example
+[コード例]
+
+## When to Use
+[トリガー条件]
+```
+
+---
+
+## 🚫 Pattern Ignore List (REQ-LH-003)
+
+**抽出しない**:
+- 単純なタイポ修正
+- 一時的な問題の修正
+- 外部API障害への対応
+
+---
+
+## 💡 抽出例
+
+### error_resolution
+```markdown
+# TypeScript TS2322 型不一致の解決
+
+**Problem:** `Type 'string' is not assignable to type 'number'`
+**Solution:** 明示的な型変換 `Number(value)` または型ガード追加
+**When:** TS2322エラーが発生し、型変換が必要な場合
+```
+
+### workaround
+```markdown
+# Vitest ESMモード設定
+
+**Problem:** ESMモジュールでVitestが動作しない
+**Solution:** `vitest.config.ts`に`deps.inline: [...]`を追加
+**When:** ESMパッケージをテストする際
+```
+
+---
+
+## トレーサビリティ
+
+- REQ-LH-001: Continuous Learning Evaluation
+- REQ-LH-002: Learned Skills Storage
+- REQ-LH-003: Pattern Ignore List

package/.github/skills/learning-hooks/templates/learned-skill-template.md

@@ -0,0 +1,79 @@
+# Learned Skill Template
+
+学習されたスキルのテンプレートです。
+
+---
+
+# [Descriptive Pattern Name]
+
+**Extracted:** [Date: YYYY-MM-DD]
+**Source:** [Session ID or Project]
+**Context:** [When this applies]
+**Confidence:** [0.0-1.0]
+**Category:** [error_resolution|user_corrections|workarounds|debugging_techniques|project_specific]
+
+---
+
+## Problem
+
+[What problem this solves]
+
+- 発生条件
+- エラーメッセージ（該当する場合）
+- 影響範囲
+
+---
+
+## Solution
+
+[The pattern/technique/workaround]
+
+### 手順
+
+1. ステップ1
+2. ステップ2
+3. ステップ3
+
+### 注意点
+
+- 注意点1
+- 注意点2
+
+---
+
+## Example
+
+```typescript
+// コード例（該当する場合）
+```
+
+---
+
+## When to Use
+
+[Trigger conditions]
+
+- トリガー1
+- トリガー2
+- トリガー3
+
+---
+
+## Related Patterns
+
+- [関連パターン1]
+- [関連パターン2]
+
+---
+
+## Metadata
+
+```yaml
+extracted_from: session-2026-01-25
+usage_count: 0
+last_used: null
+success_rate: null
+tags:
+  - tag1
+  - tag2
+```