create-ai-project 1.16.0 → 1.16.2

package/.claude/commands-ja/review.md

@@ -34,6 +34,8 @@ Design Doc準拠率を検証:
 - コード品質チェック
 - 実装完全性の評価
 
+**出力を保存**: `$STEP_2_OUTPUT`
+
 ### 3. 判定と対応
 
 **判定基準（プロジェクト段階を考慮）**:
@@ -60,7 +62,7 @@ Design Doc準拠率を検証:
 1. **TodoWrite更新**: 作業ステップを登録。必ず含める: 最初に「スキル制約の確認」、最後に「スキル忠実度の検証」。タスクテンプレート（documentation-criteriaスキル参照）に従いタスクファイル作成 → `docs/plans/tasks/review-fixes-YYYYMMDD.md`
 2. **task-executor実行**: 自動修正を段階的実行（5ファイル超過で停止）
 3. **quality-fixer実行**: 品質ゲート通過を確認
-4. **再検証**: code-reviewerで改善度を測定
+4. **再検証**: 修正後のDesign Doc準拠率を再検証する。前回の準拠問題: $STEP_2_OUTPUT。各問題が解決されたことを確認する。
 
 ### 4. 最終レポート
 ```

package/.claude/commands-ja/update-doc.md

@@ -11,7 +11,7 @@ description: 既存設計ドキュメント（Design Doc / PRD / ADR）をレビ
 **初期アクション**: 実行前にステップ1-6をTodoWriteに登録する。
 
 **実行プロトコル**:
-1. **全作業をサブエージェントに委譲**（自分でドキュメントを編集しない）
+1. **全作業をサブエージェントに委譲** — 役割はサブエージェントの呼び出し、データの受け渡し、結果の報告
 2. **更新フローを実行**:
    - 対象特定 → 変更内容確認 → ドキュメント更新 → レビュー → 整合性チェック
    - **`[停止: ...]`マーカーで必ず停止** → 次に進む前にユーザー承認を待つ
@@ -125,9 +125,29 @@ prompt: |
   - 変更履歴の完全性
 ```
 
+**出力を保存**: `$STEP_5_OUTPUT`
+
 **レビュー結果に基づく対応**:
 - 承認 → ステップ6へ進む
-- 要修正 → レビュアーフィードバックを持ってステップ4に戻る（最大2回）
+- 要修正 → 以下のプロンプトでステップ4に戻る:
+  ```
+  subagent_type: [ステップ2の更新エージェント]
+  description: "レビューフィードバックに基づき[タイプ]を修正"
+  prompt: |
+    動作モード: update
+    既存ドキュメント: [ステップ1のパス]
+
+    ## 前回のレビューフィードバック
+    $STEP_5_OUTPUT
+
+    severity別に対処する:
+    - critical: 必須修正
+    - important: 推奨修正
+    - recommended: 任意修正
+
+    修正を適用し変更履歴を更新する。
+  ```
+  （最大2回）
 - **2回のリジェクト後** → 人間レビュー用にフラグ、蓄積されたフィードバックをユーザーに提示して終了
 
 レビュー結果をユーザーに提示して承認を得る。

package/.claude/skills-en/skill-optimization/SKILL.md

@@ -0,0 +1,145 @@
+---
+name: skill-optimization
+description: Evaluates and optimizes skill file quality against 8 content patterns and 9 editing principles. Use when creating skills, refining skill content, or auditing skill quality.
+---
+
+# Skill Content Optimization
+
+## Core Philosophy
+
+1. **Evidence-Based**: Grounded in prompt engineering research, applied to skill authoring
+2. **Concrete**: Each pattern provides detection criteria and transform methods
+3. **Structure-Focused**: Optimizes expression and organization; domain knowledge remains unchanged
+
+## Content Optimization Patterns
+
+### P1: Critical (Must Fix)
+
+Issues that directly reduce LLM execution accuracy when consuming the skill.
+
+#### BP-001: Negative Instructions → Positive Form
+
+| Detection | Transform |
+|-----------|-----------|
+| "don't", "do not", "never", "avoid" in skill instructions | Reframe as positive directive with equivalent constraint |
+
+**Skill example:**
+- Before: "Don't use generic variable names"
+- After: "Use descriptive variable names that reflect purpose (e.g., `userId` not `x`)"
+
+**Why critical for skills**: LLM attention mechanisms focus on negated content. Skill instructions with "don't" increase probability of the forbidden behavior.
+
+#### BP-002: Vague Instructions → Specific Criteria
+
+| Detection | Transform |
+|-----------|-----------|
+| "appropriate", "good", "proper", "best", "should be clear" | Replace with measurable if-then criteria or concrete thresholds |
+| Missing output format, scope, or success criteria | Add explicit constraints |
+
+**Skill example:**
+- Before: "Handle errors appropriately"
+- After: "Error handling criteria: 1. try-catch for external API calls, file I/O, JSON.parse 2. Log: error.name, error.stack, timestamp 3. Re-throw with context if caller needs to handle"
+
+**Why critical for skills**: Accounts for ~40% of execution variance. Every vague instruction forces LLM to guess.
+
+#### BP-003: Missing Output Format → Structured Output
+
+| Detection | Transform |
+|-----------|-----------|
+| Skill describes what to do but not the expected deliverable format | Add output section with structure, fields, and example |
+
+**Skill example:**
+- Before: "Analyze the code for issues"
+- After: "Output format: `## Issues Found` with table: | Severity | Location | Description | Suggested Fix |"
+
+**Why critical for skills**: Structured output constraints reduce hallucination and make skill results consistent.
+
+### P2: High Impact (Should Fix)
+
+Issues that reduce skill effectiveness when addressed.
+
+#### BP-004: Unstructured Content → Organized Format
+
+| Detection | Transform |
+|-----------|-----------|
+| Wall of text without headings | Apply standard section order (see below) |
+| Multiple topics mixed in one section | Split into distinct headed sections |
+| No tables for reference data | Convert lists of criteria/patterns to tables |
+
+**Standard skill section order:**
+1. Context/Prerequisites
+2. Core concepts (definitions, patterns)
+3. Process/Methodology (step-by-step)
+4. Output format/Examples
+5. Quality checklist
+6. References
+
+**Conditional**: Skip restructuring if skill is under 30 lines and covers a single topic.
+
+#### BP-005: Missing Context → Explicit Prerequisites
+
+| Detection | Transform |
+|-----------|-----------|
+| Skill assumes knowledge not stated | Add Prerequisites section listing required context |
+| Domain terms used without definition | Add definitions inline or in a glossary table |
+| No "when to use" guidance | Add trigger conditions with concrete scenarios |
+
+**Skill example:**
+- Before: "Apply the strangler pattern for migration"
+- After: "**Prerequisite**: Existing monolith with identifiable module boundaries. **When to use**: Replacing legacy module while maintaining production traffic."
+
+#### BP-006: Complex Content → Decomposed Steps
+
+| Detection | Transform |
+|-----------|-----------|
+| 3+ objectives in one instruction | Break into numbered steps with checkpoints |
+| Sequential dependencies not explicit | Add dependency markers between steps |
+| No intermediate verification | Insert checkpoint after each step |
+
+**Conditional**: Skip decomposition for simple reference tables or single-criteria rules.
+
+**Key insight**: Goal is evaluable granularity with quality checkpoints, not decomposition for its own sake.
+
+### P3: Enhancement (Could Fix)
+
+Incremental improvements for specific contexts.
+
+#### BP-007: Biased Examples → Diverse Coverage
+
+| Detection | Transform |
+|-----------|-----------|
+| All examples share same pattern/structure | Add edge cases and exceptions |
+| Only happy-path examples | Add error cases, boundary conditions |
+| Examples all same complexity | Include simple, moderate, and complex |
+
+#### BP-008: No Uncertainty Permission → Explicit Escalation
+
+| Detection | Transform |
+|-----------|-----------|
+| Skill demands definitive answers always | Add escalation criteria for ambiguous cases |
+| No "when to stop" guidance | Add explicit stopping conditions |
+
+**Skill example:**
+- Before: "Determine the root cause"
+- After: "Determine the root cause. If root cause is uncertain after 3 investigation cycles, report top 3 hypotheses with confidence levels and evidence for each."
+
+## 9 Skill Editing Principles
+
+Measurable quality criteria for skill content. Each principle includes a pass/fail test.
+
+| # | Principle | Pass Criteria | Fail Example |
+|---|-----------|---------------|--------------|
+| 1 | Context efficiency | Every sentence contributes to LLM decision-making. No filler. | "This is an important skill that helps with..." |
+| 2 | Deduplication | No concept explained twice within the skill or across skills | Same error handling rules in both coding-standards and typescript-rules |
+| 3 | Grouping | Related criteria in single section (minimize read operations) | Scattered error handling rules across 4 sections |
+| 4 | Measurability | All criteria use if-then format or concrete thresholds | "Write clean code" without definition of clean |
+| 5 | Positive form | Instructions state what to do (BP-001 applied) | "Don't use any" instead of "Use only X" |
+| 6 | Consistent notation | Uniform heading levels, list styles, table formats | Mix of `-`, `*`, `1.` in same context |
+| 7 | Explicit prerequisites | All assumed knowledge stated | Uses "DI" without defining Dependency Injection |
+| 8 | Priority ordering | Most important items first, exceptions last | Edge cases before common patterns |
+| 9 | Scope boundaries | Explicit coverage: what this skill addresses vs references to other skills | Overlapping guidance with no cross-reference |
+
+## References
+
+- **Creating skills**: See [references/creation-guide.md](references/creation-guide.md) for generation flow and description guidelines
+- **Reviewing skills**: See [references/review-criteria.md](references/review-criteria.md) for evaluation flow and grading

package/.claude/skills-en/skill-optimization/references/creation-guide.md

@@ -0,0 +1,58 @@
+# Skill Creation Guide
+
+Guide for generating new skill content from raw user knowledge.
+
+## Creation Flow
+
+### Step 1: Analysis
+
+**Input**: Raw user knowledge (rules, patterns, examples, criteria)
+
+**Process**:
+1. Classify content: definitions, patterns, processes, criteria, examples
+2. Detect issues using BP patterns (BP-001 through BP-008)
+3. Estimate size: small (<80 lines), medium (80-250), large (250+)
+4. Identify cross-references to existing skills
+
+**Output**: Content classification + issue list.
+
+### Step 2: Generate Optimized Content
+
+**Input**: Classified content + issue list
+
+**Process**:
+1. Apply transforms in priority order: P1 → P2 → P3
+2. Structure content following standard section order:
+   - Context/Prerequisites
+   - Core concepts (definitions, patterns)
+   - Process/Methodology (step-by-step)
+   - Output format/Examples
+   - Quality checklist
+   - References
+3. **Balance checks**:
+   - Over-optimization: Content exceeds scope of user's input → trim
+   - Clarity trade-off: Structure obscures main point → simplify
+4. Verify 9 principles pass
+
+**Output**: Optimized SKILL.md content.
+
+## Description Guidelines
+
+For skill frontmatter `description` field:
+
+| Rule | Example |
+|------|---------|
+| Third-person, verb-first | "Evaluates code quality..." not "This skill evaluates..." |
+| Include "Use when:" trigger | "Use when creating tests or reviewing test quality." |
+| Target ~200 characters | Shorter descriptions reduce context pressure across all loaded skills |
+| Specific over generic | "Applies 8 content patterns" not "Improves quality" |
+| No implementation details | Describe what it does, not how |
+
+**Template**: `{Verb}s {what} against {criteria}. Use when {trigger scenarios}.`
+
+## Split Decision
+
+If generated content exceeds 400 lines:
+- Extract reference data (large tables, example collections) to `references/`
+- Keep SKILL.md under 250 lines with references to extracted files
+- All reference files one level deep from SKILL.md

package/.claude/skills-en/skill-optimization/references/review-criteria.md

@@ -0,0 +1,51 @@
+# Skill Review Criteria
+
+Criteria for evaluating existing or generated skill content quality.
+
+## Review Flow
+
+### Step 1: Pattern Scan
+
+**Input**: Skill content (SKILL.md frontmatter + body)
+
+**Process**:
+1. Scan for each BP pattern (BP-001 through BP-008)
+2. Record: pattern ID, severity, location, original text
+3. Evaluate against 9 editing principles
+4. Count total lines, estimate size category
+
+**Output**: Issue list with severity, location, and original text per finding.
+
+### Step 2: Evaluate and Grade
+
+**Input**: Issue list + skill content
+
+**Process**:
+1. Count P1 and P2 issues
+2. Count principles passed (pass/partial/fail)
+3. Check cross-skill overlap
+4. **Balance assessment**:
+   - Over-optimization: Excessive constraints for simple topic
+   - Lost expertise: Domain knowledge compressed away in structured content
+   - Clarity trade-off: Structure obscures main point
+   - Description quality: Frontmatter description follows guidelines
+5. Assign grade
+
+**Output**: Quality report with grade, issues, and action items.
+
+## Grading
+
+| Grade | Criteria | Recommendation |
+|-------|----------|----------------|
+| A | 0 P1, 0 P2 issues, 8+ principles pass | Ready for use |
+| B | 0 P1, ≤2 P2 issues, 6+ principles pass | Acceptable with noted improvements |
+| C | Any P1 OR >2 P2 OR <6 principles pass | Revision required |
+
+## Review Mode Differences
+
+| Aspect | creation | modification |
+|--------|----------|-------------|
+| Scope | All content, comprehensive | Changed sections + regression check |
+| BP scan | All 8 patterns | Focus on patterns relevant to changes |
+| Cross-skill check | Full overlap scan | Verify changes didn't introduce overlap |
+| Extra check | — | Report issues outside change scope separately |

package/.claude/skills-en/task-analyzer/references/skills-index.yaml

@@ -25,14 +25,11 @@ skills:
       - "Debugging Techniques"
       - "Type Safety Fundamentals"
       - "Refactoring Techniques"
-      - "Situations Requiring Technical Decisions"
-      - "Continuous Improvement Mindset"
       - "Implementation Completeness Assurance"
+      - "Impact Analysis"
       - "Red-Green-Refactor Process (Test-First Development)"
       - "Test Design Principles"
-      - "Test Helper Utilization Rules"
       - "Test Granularity Principles"
-      - "Continuity Test Scope"
 
   typescript-rules:
     skill: "typescript-rules"
@@ -85,7 +82,6 @@ skills:
       - "Basic Technology Stack Policy"
       - "Environment Variable Management and Security"
       - "Architecture Design"
-      - "Architecture Patterns"
       - "Unified Data Flow Principles"
       - "Build and Testing"
 
@@ -97,9 +93,10 @@ skills:
     key-references:
       - "Project-specific (empirical)"
     sections:
-      - "Basic Configuration"
-      - "Implementation Principles"
-      - "Customization Guide"
+      - "Project Overview"
+      - "Domain Constraints"
+      - "Development Phase"
+      - "Directory Conventions"
 
   documentation-criteria:
     skill: "documentation-criteria"
@@ -120,6 +117,7 @@ skills:
       - "AI Automation Rules"
       - "Diagram Requirements"
       - "Common ADR Relationships"
+      - "Templates"
 
   implementation-approach:
     skill: "implementation-approach"
@@ -163,10 +161,33 @@ skills:
       - "Workflow Orchestration Patterns"
       - "Agent Coordination Patterns"
     sections:
-      - "Scale Determination"
-      - "Document Requirements"
-      - "Stop Points"
+      - "Core Principle: I Am an Orchestrator"
+      - "Decision Flow When Receiving Tasks"
+      - "Subagents I Can Utilize"
+      - "My Orchestration Principles"
+      - "Constraints Between Subagents"
+      - "Scale Determination and Document Requirements"
+      - "Structured Response Specifications"
+      - "My Basic Flow for Work Planning"
+      - "Cross-Layer Orchestration"
       - "Autonomous Execution Mode"
+      - "My Main Roles as Orchestrator"
+      - "Important Constraints"
+      - "Required Dialogue Points with Humans"
+
+  skill-optimization:
+    skill: "skill-optimization"
+    tags: [skill-creation, skill-editing, content-optimization, quality-evaluation, description-generation, metadata]
+    typical-use: "Creating new skills, refining skill content, evaluating skill quality, generating descriptions"
+    size: medium
+    key-references:
+      - "BP-001~008 Content Optimization Patterns"
+      - "9 Skill Editing Principles"
+    sections:
+      - "Core Philosophy"
+      - "Content Optimization Patterns"
+      - "9 Skill Editing Principles"
+      - "References"
 
   # Frontend-specific Skills
   frontend/typescript-rules:
@@ -220,6 +241,3 @@ skills:
       - "Architecture Design"
       - "Unified Data Flow Principles"
       - "Build and Testing"
-      - "Quality Check Requirements"
-      - "Coverage Requirements"
-      - "Non-functional Requirements"

package/.claude/skills-ja/skill-optimization/SKILL.md

@@ -0,0 +1,145 @@
+---
+name: skill-optimization
+description: スキルファイルの品質を8つのコンテンツパターンと9つの編集原則で評価・最適化。スキル作成、内容改善、品質監査時に使用。
+---
+
+# スキルコンテンツ最適化
+
+## 基本方針
+
+1. **根拠に基づく**: プロンプト工学の研究成果をスキル執筆に応用
+2. **具体的**: 各パターンに検出条件と変換方法を提供
+3. **構造特化**: 表現と構成を最適化し、ドメイン知識は変更しない
+
+## コンテンツ最適化パターン
+
+### P1: 重大（修正必須）
+
+スキル読み込み時のLLM実行精度に直接影響する問題。
+
+#### BP-001: 否定形の指示 → 肯定形への変換
+
+| 検出条件 | 変換方法 |
+|----------|----------|
+| 「〜しない」「〜を避ける」「禁止」等の否定形指示 | 同等の制約を持つ肯定形の指示に変換 |
+
+**スキルでの例:**
+- 変更前: 「汎用的な変数名を使わないこと」
+- 変更後: 「目的を表す具体的な変数名を使用する（例: `x`ではなく`userId`）」
+
+**スキルで重大な理由**: LLMの注意機構は否定された内容に集中する。「〜するな」という指示は禁止行為の出現確率をむしろ高める。
+
+#### BP-002: 曖昧な指示 → 具体的な判断基準
+
+| 検出条件 | 変換方法 |
+|----------|----------|
+| 「適切に」「良い」「正しく」「ベスト」「明確に」等 | 測定可能なif-then基準または具体的な閾値に置換 |
+| 出力形式・スコープ・成功基準が未定義 | 明示的な制約を追加 |
+
+**スキルでの例:**
+- 変更前: 「エラーは適切に処理する」
+- 変更後: 「エラーハンドリング基準: 1. try-catch必須: 外部API呼び出し、ファイルI/O、JSON.parse 2. ログ必須項目: error.name、error.stack、タイムスタンプ 3. 呼び出し元での処理が必要な場合はコンテキスト付きで再throw」
+
+**スキルで重大な理由**: 実行精度の差異の約40%は曖昧な指示に起因する。曖昧な記述はLLMに推測を強いる。
+
+#### BP-003: 出力形式の欠落 → 構造化出力の明示
+
+| 検出条件 | 変換方法 |
+|----------|----------|
+| 何をすべきかは書いてあるが成果物の形式が未定義 | 構造・フィールド・例を含む出力セクションを追加 |
+
+**スキルでの例:**
+- 変更前: 「コードの問題を分析する」
+- 変更後: 「出力形式: `## 検出した問題` テーブル形式: | 重大度 | 箇所 | 説明 | 修正案 |」
+
+**スキルで重大な理由**: 構造化出力の制約はハルシネーションを抑制し、スキル適用結果の一貫性を確保する。
+
+### P2: 高影響（修正推奨）
+
+対処により実効性が向上する問題。
+
+#### BP-004: 未構造化コンテンツ → 整理されたフォーマット
+
+| 検出条件 | 変換方法 |
+|----------|----------|
+| 見出しのない文章の塊 | 標準セクション順序を適用（下記参照） |
+| 複数トピックが1セクションに混在 | 見出し付きの個別セクションに分割 |
+| 参照データがリスト形式のまま | テーブル形式に変換 |
+
+**標準セクション順序:**
+1. コンテキスト/前提条件
+2. 中核概念（定義、パターン）
+3. プロセス/手順（ステップ形式）
+4. 出力形式/具体例
+5. 品質チェックリスト
+6. 参照
+
+**適用条件**: 30行未満かつ単一トピックのスキルには構造化を省略。
+
+#### BP-005: コンテキスト不足 → 前提条件の明示
+
+| 検出条件 | 変換方法 |
+|----------|----------|
+| 記述されていない前提知識に依存 | 必要な前提を列挙したPrerequisitesセクションを追加 |
+| 定義なしにドメイン用語を使用 | インラインまたは用語テーブルで定義を追加 |
+| 使用場面の指針がない | 具体的なシナリオ付きのトリガー条件を追加 |
+
+**スキルでの例:**
+- 変更前: 「移行にはStrangler Patternを適用する」
+- 変更後: 「**前提**: モジュール境界が識別可能な既存モノリス。**使用場面**: 本番トラフィックを維持しながらレガシーモジュールを置換する場合。」
+
+#### BP-006: 複雑な内容 → ステップ分解
+
+| 検出条件 | 変換方法 |
+|----------|----------|
+| 1つの指示に3つ以上の目的 | チェックポイント付きの番号付きステップに分解 |
+| 順序依存が暗黙的 | ステップ間の依存関係を明示 |
+| 中間検証がない | 各ステップ後にチェックポイントを挿入 |
+
+**適用条件**: 単純な参照テーブルや単一基準のルールには分解を省略。
+
+**要点**: 目的は「分解すること」ではなく、品質チェックポイント付きの**評価可能な粒度**にすること。
+
+### P3: 改善（対応可能なら）
+
+特定の状況で効果がある段階的な改善。
+
+#### BP-007: 偏った例示 → 多様なカバレッジ
+
+| 検出条件 | 変換方法 |
+|----------|----------|
+| 全例が同じパターン/構造 | エッジケースと例外を追加 |
+| 正常系の例のみ | エラーケース、境界条件を追加 |
+| 全例が同じ複雑度 | 簡単・中程度・複雑の例を含める |
+
+#### BP-008: 不確実性の許容なし → 明示的なエスカレーション
+
+| 検出条件 | 変換方法 |
+|----------|----------|
+| 常に確定的な回答を要求 | 曖昧な場合のエスカレーション基準を追加 |
+| 「いつ止めるか」の指針がない | 明示的な停止条件を追加 |
+
+**スキルでの例:**
+- 変更前: 「根本原因を特定する」
+- 変更後: 「根本原因を特定する。3回の調査サイクル後も不確定な場合は、上位3仮説を信頼度と根拠付きで報告する。」
+
+## 9つの編集原則
+
+スキルコンテンツの測定可能な品質基準。各原則に合否判定基準を設定。
+
+| # | 原則 | 合格基準 | 不合格例 |
+|---|------|----------|----------|
+| 1 | コンテキスト効率 | 全文がLLMの判断に寄与する。冗長な記述なし | 「これは〜に役立つ重要なスキルで...」 |
+| 2 | 重複排除 | スキル内・スキル間で同じ概念の重複説明なし | coding-standardsとtypescript-rulesに同じエラーハンドリング規則 |
+| 3 | 関連内容の集約 | 関連する基準を1セクションに集約（読み込み回数最小化） | エラーハンドリング規則が4セクションに散在 |
+| 4 | 測定可能性 | 全基準がif-then形式または具体的閾値 | 「きれいなコードを書く」の定義なし |
+| 5 | 肯定形 | 指示は「何をするか」を記述（BP-001適用済み） | 「一切使わないこと」→「Xのみ使用する」 |
+| 6 | 表記の一貫性 | 見出しレベル、リスト記法、テーブル形式が統一 | 同一文脈で`-`、`*`、`1.`が混在 |
+| 7 | 前提条件の明示 | 暗黙の前提知識が全て記述されている | 「DI」を定義せずに使用 |
+| 8 | 重要度順の記述 | 最重要項目が先頭、例外は末尾 | エッジケースが共通パターンより先に記述 |
+| 9 | スコープ境界 | このスキルが扱う範囲と他スキルへの参照が明示 | 他スキルと重複する記述に相互参照なし |
+
+## References
+
+- **スキル生成時**: [references/creation-guide.md](references/creation-guide.md) - 生成フローとdescription指針
+- **スキルレビュー時**: [references/review-criteria.md](references/review-criteria.md) - 評価フローとグレード判定基準

package/.claude/skills-ja/skill-optimization/references/creation-guide.md

@@ -0,0 +1,58 @@
+# スキル生成ガイド
+
+ユーザーの生の知識から新規スキルコンテンツを生成するためのガイド。
+
+## 生成フロー
+
+### Step 1: 分析
+
+**入力**: ユーザーの生の知識（ルール、パターン、具体例、判断基準）
+
+**手順**:
+1. コンテンツを分類: 定義、パターン、プロセス、基準、具体例
+2. BPパターン（BP-001〜BP-008）で問題を検出
+3. サイズ見積もり: small（80行未満）、medium（80-250行）、large（250行以上）
+4. 既存スキルとの相互参照を特定
+
+**出力**: コンテンツ分類 + 検出リスト。
+
+### Step 2: 最適化済みコンテンツの生成
+
+**入力**: 分類済みコンテンツ + 検出リスト
+
+**手順**:
+1. 優先度順に変換を適用: P1 → P2 → P3
+2. 標準セクション順序で構造化:
+   - コンテキスト/前提条件
+   - 中核概念（定義、パターン）
+   - プロセス/手順（ステップ形式）
+   - 出力形式/具体例
+   - 品質チェックリスト
+   - 参照
+3. **バランス確認**:
+   - 過剰最適化: ユーザー入力の範囲を超えている → 削減
+   - 可読性低下: 構造化で要点が不明瞭 → 簡素化
+4. 9原則の合否を確認
+
+**出力**: 最適化済みSKILL.mdコンテンツ。
+
+## description記述の指針
+
+スキルのfrontmatter `description`フィールド向け:
+
+| ルール | 例 |
+|--------|-----|
+| 三人称・動詞始まり | 「コード品質を検査。」（「このスキルは〜」としない） |
+| 使用場面を含める | 「機能実装、コードレビュー時に使用。」 |
+| 200文字前後を目安 | 短いほど全スキル読み込み時のコンテキスト圧迫が減る |
+| 具体的に記述 | 「8つのコンテンツパターンを適用」（「品質を改善」としない） |
+| 実装詳細を含めない | 何をするかを記述し、どうやるかは記述しない |
+
+**テンプレート**: `{対象}を{基準}で{動詞}。{使用場面}時に使用。`
+
+## 分割判定
+
+生成コンテンツが400行を超える場合:
+- 参照データ（大規模テーブル、具体例集）を`references/`に抽出
+- SKILL.md本体は250行以内に収め、抽出ファイルへの参照を記載
+- 参照ファイルはSKILL.mdから1階層のみ

package/.claude/skills-ja/skill-optimization/references/review-criteria.md

@@ -0,0 +1,51 @@
+# スキルレビュー基準
+
+既存または生成済みスキルコンテンツの品質評価基準。
+
+## レビューフロー
+
+### Step 1: パターン検出
+
+**入力**: スキルコンテンツ（SKILL.md frontmatter + 本文）
+
+**手順**:
+1. BPパターン（BP-001〜BP-008）を順に検出
+2. 記録: パターンID、重大度、該当箇所、原文
+3. 9つの編集原則に照らして評価
+4. 総行数を集計しサイズ区分を判定
+
+**出力**: 重大度・該当箇所・原文を含む検出リスト。
+
+### Step 2: 評価とグレード判定
+
+**入力**: 検出リスト + スキルコンテンツ
+
+**手順**:
+1. P1・P2問題の件数を集計
+2. 原則の合否を集計（合格/部分的/不合格）
+3. スキル間の重複を確認
+4. **バランス評価**:
+   - 過剰最適化: 単純なトピックに対して制約過多
+   - 知識の欠落: 構造化でドメイン固有の知見が消失
+   - 可読性低下: 構造化で要点が不明瞭
+   - description品質: frontmatterのdescriptionが指針に準拠
+5. グレード判定
+
+**出力**: グレード・問題点・修正提案を含む品質レポート。
+
+## グレード判定基準
+
+| グレード | 基準 | 判定 |
+|----------|------|------|
+| A | P1問題0件、P2問題0件、原則8つ以上合格 | 即使用可 |
+| B | P1問題0件、P2問題2件以下、原則6つ以上合格 | 改善点を認識した上で使用可 |
+| C | P1問題あり、またはP2問題3件以上、または原則合格6未満 | 修正が必要 |
+
+## レビューモード別の差異
+
+| 観点 | creation | modification |
+|------|----------|-------------|
+| 対象範囲 | 全コンテンツを網羅的に | 変更箇所 + 退行チェック |
+| BPスキャン | 全8パターン | 変更に関連するパターンに注力 |
+| スキル間確認 | 全体の重複スキャン | 変更で重複が発生していないか |
+| 追加確認 | — | 変更スコープ外の問題は別途報告 |