| name | eld-ground |
| description | ELD v2.3 接地検証+PRレビュー統合スキル。2軸評価（Grounding Level G0-G4 × Evaluator Quality E0-E3）+TDD統制。verify: Law/Term接地チェック+完成度確認。review: PRレビュー（Artifact-Based + 行レビュー必須領域）。full: verify+review一括実行。使用タイミング: PR作成前の接地確認、PRレビュー、「Groundingチェックして」「PRレビューして」、Law/Term追加後の接地完了確認。 |
ELD Ground: Verify + Review
Purpose
実装の 接地検証（Grounding Verify） と PRレビュー（PR Review） を統合したスキル。
2軸評価モデル（Grounding Level × Evaluator Quality）により、検証の品質を構造的に保証する。
$ARGUMENTS
| Argument | Description | Behavior |
|---|
verify | Law/Term接地チェック + 完成度確認 | Phase A-C を実行 |
review | PRレビュー（Artifact-Based + 行レビュー必須領域） | Review Hybrid を実行 |
full | verify + review 一括実行 (default) | Phase A-C → Review Hybrid を順次実行 |
引数省略時は full として動作する。
2-Axis Evaluation Model
Grounding Level（接地レベル）
| Level | Name | Definition |
|---|
| G0 | No Evidence | 根拠なし。主張のみ |
| G1 | Anecdotal | 個別事例・経験則のみ |
| G2 | Documented | ドキュメント・設計書に記載あり |
| G3 | Tested | テストコードで検証済み |
| G4 | Proven in Production | 本番環境で実証済み |
Evaluator Quality（評価者品質）
| Level | Name | Definition |
|---|
| E0 | Unchecked | 未レビュー |
| E1 | Self-Checked | 実装者自身によるセルフチェック |
| E2 | Peer-Reviewed | 同等スキルの他者によるレビュー |
| E3 | Expert-Reviewed | ドメインエキスパートによるレビュー |
Severity × Evaluator Quality Requirements
| Severity | 必要Evaluator Quality | 備考 |
|---|
| S0 + security | E3 | セキュリティ関連の最重要変更は専門家レビュー必須 |
| S1 | E2 | 重要な変更はピアレビュー必須 |
| S2 | E1 | 中程度の変更はセルフチェック以上 |
| S3 | E1 | 軽微な変更はセルフチェック以上 |
この要件を満たさない場合、Ground結果は 不合格 とする。
TDD統制
TDDサイクル（RED-GREEN-REFACTOR）とテストなし実装の防止を、Law Severityに応じて強制する。
Law Severity別Evidence要件
| Severity | L1（ユニット） | L2（統合） | L4（本番Telemetry） |
|---|
| S0 | 必須 | 必須 | 必須 |
| S1 | 必須 | 推奨 | 推奨 |
| S2 | オプション | - | 推奨 |
S0/S1 LawはL1テストなしで実装完了扱いにしない。
テストなきコミット禁止
該当Severityの要件を満たさない場合、コミットを拒否する:
- 変更コードに対応するテストが存在するか
- すべてのテストが成功しているか
- カバレッジが低下していないか
RED状態の時間制限
| 経過時間 | 判定 | 対応 |
|---|
| 5分以内 | 正常 | 実装を続行 |
| 5-15分 | 警告 | 設計の見直しを提案 |
| 15分超 | 停止 | タスクを原子化（5-10分単位）して再スタート |
コードへの接地ルール
- モデルベーステスト: 状態を持つLawには、ランダム操作列に対して不変条件を毎ステップ検証するモデルベーステストを1本置く（手選びの例では到達しない状態を踏むため）。設計手順は /systematic-test-design のstate-machineプロパティを参照（delivery-plugin導入時）。
- 契約コメント: Law Cardの事前・事後・不変条件は、対応する論理式（Formal-ish）をコメントとして実装関数のシグネチャ近傍に残す（カードとコードの接地）。
- 実行時アサーションの抑制: 実行時アサーションは「破られたらデータ破壊につながる不変条件」のみに限定する。全Lawをassert化しない。
Verify Mode
Phase A: Grounding Check
Law/Termに対する実装の接地状態を検証する。
A-1. Law接地チェック
For each Law in eld/laws/:
1. Lawの要求事項を抽出
2. 対応する実装箇所を特定
3. Grounding Levelを判定（G0-G4）
4. 未接地（G0-G1）のLawを検出 → 要対応リストに追加
A-2. Term接地チェック
For each Term in eld/terms/:
1. Termの定義を確認
2. コード内での使用箇所を検索
3. 定義と実装の一致度を検証
4. 不一致・未使用Termを検出 → 要対応リストに追加
A-3. 接地マトリクス出力
### Grounding Matrix
| Law/Term | Grounding Level | 接地箇所 | Gap |
|----------|-----------------|---------|-----|
| {Law/Term名} | G{n} | {ファイル:行} | {未接地の場合の説明} |
Phase B: Output Evaluation
実装成果物の品質を2軸で評価する。
B-1. Grounding Level評価
各変更ファイルについて:
- テストの有無と品質 → G3判定の基準
- ドキュメントとの整合性 → G2判定の基準
- 本番実績の有無 → G4判定の基準
B-2. Evaluator Quality評価
### Output Evaluation
| 対象 | Grounding Level | Evaluator Quality | Severity | 要件充足 |
|------|-----------------|-------------------|----------|---------|
| {ファイル/モジュール} | G{n} | E{n} | S{n} | {OK/NG} |
B-3. Gap Analysis
要件を満たさない項目について:
- 現在の状態と必要な状態のギャップを明示
- 改善アクションを具体的に提示
Phase C: Pre-Completion
完成度の最終確認。
C-1. 完成度チェックリスト
C-2. 完成度スコア
完成度 = (接地済みLaw/Term数) / (全Law/Term数) × 100%
- 100%: 完全接地。Ground合格。
- 80-99%: 条件付き合格。残Gapを明示して判断を仰ぐ。
- 80%未満: 不合格。Gapリストを返却して停止。
Review Mode
Review Hybrid
PRレビューを Artifact-Based Review と Line Review のハイブリッドで実施する。
Artifact-Based Review（全PR共通）
すべてのPRに対してデフォルトで実施する成果物ベースのレビュー。
Compile Phase
1. PR差分を取得（git diff base...head）
2. 変更ファイルを分類:
- 新規追加 / 修正 / 削除
- ファイル種別（コード / テスト / 設定 / ドキュメント）
3. 変更の意図をPRタイトル・説明から抽出
4. 関連するLaw/Termを特定
Execute Phase
1. アーキテクチャ整合性チェック:
- 既存パターンとの一貫性
- 依存関係の方向性
- モジュール境界の尊重
2. Law/Term接地チェック（verify modeのPhase A簡易版）:
- 新規/変更コードが既存Law/Termに違反していないか
- 新たなLaw/Termの追加が必要か
3. テスト充足度チェック:
- 変更に対応するテストの有無
- テストのカバレッジと品質
4. 設計品質チェック:
- 命名の一貫性
- 責務の分離
- エラーハンドリング
- ログ・可観測性
Capture Phase
### Artifact-Based Review Result
| # | Category | Finding | Severity | Suggestion |
|---|----------|---------|----------|------------|
| 1 | {カテゴリ} | {発見事項} | S{n} | {改善提案} |
**Overall Assessment**: {APPROVE / REQUEST_CHANGES / COMMENT}
Line Review（必須領域）
以下の領域に該当する変更は、行単位の詳細レビューを必須とする。
| 必須領域 | 対象パターン | レビュー観点 |
|---|
| Security | 認証・認可、入力検証、暗号化、シークレット管理 | 脆弱性、インジェクション、情報漏洩 |
| Concurrency | 並行処理、ロック、非同期、キュー | 競合状態、デッドロック、データ整合性 |
| Persistence | DB操作、ファイルI/O、キャッシュ | データ損失、整合性、パフォーマンス |
| Auth | 認証フロー、セッション管理、トークン | 認証バイパス、セッション固定、CSRF |
| Migration | DBマイグレーション、データ移行 | ロールバック可能性、データ損失リスク |
| Billing | 課金計算、決済連携、サブスクリプション | 計算誤り、二重課金、レース条件 |
Line Review Output
### Line Review: {領域名}
**File**: {ファイルパス}
| Line | Code | Issue | Severity | Recommendation |
|------|------|-------|----------|----------------|
| L{n} | `{コード抜粋}` | {問題点} | S{n} | {改善案} |
LDE Integration Check
PRが以下のLDE（Law-Driven Engineering）要件を満たしているか確認する。
1. 新規機能の場合:
- 対応するLawが存在するか
- Termが適切に定義されているか
- テストがLawの要求をカバーしているか
2. バグ修正の場合:
- 原因となったLaw/Term違反を特定
- 再発防止のためのLaw/Term追加が必要か
3. リファクタリングの場合:
- 既存のLaw/Term接地を破壊していないか
- 接地状態が改善されているか
### LDE Integration
| Check | Status | Detail |
|-------|--------|--------|
| Law Coverage | {OK/NG/N/A} | {説明} |
| Term Consistency | {OK/NG/N/A} | {説明} |
| Test-Law Alignment | {OK/NG/N/A} | {説明} |
Full Mode
full モード（デフォルト）は以下を順次実行する:
1. Verify Mode 実行
├── Phase A: Grounding Check
├── Phase B: Output Evaluation
└── Phase C: Pre-Completion
2. Review Mode 実行
├── Artifact-Based Review (Compile → Execute → Capture)
├── Line Review (必須領域のみ)
└── LDE Integration Check
3. 統合レポート出力
統合レポート
## ELD Ground Report
### Summary
- **Verify**: {PASS/CONDITIONAL/FAIL} (完成度: {n}%)
- **Review**: {APPROVE/REQUEST_CHANGES/COMMENT}
- **Grounding Level Range**: G{min}-G{max}
- **Evaluator Quality**: E{n}
### Critical Findings
{S0-S1の発見事項をリスト}
### Action Items
- [ ] {必須対応項目}
### Detailed Results
{verify/reviewの詳細結果を展開}
References
Quality Principles
- Evidence over Opinion: 主観的判断ではなく、証拠（テスト結果、ドキュメント、本番データ）に基づいて評価する。
- Severity-Proportional Rigor: 重大度に比例した検証深度を適用する。S0は最高品質の検証を、S3は効率的な確認を。
- Grounding Completeness: すべてのLaw/Termが実装に接地されていることを確認する。未接地は明示的にGapとして報告する。
- Review Transparency: レビュー結果はすべて構造化された形式で出力し、判断根拠を追跡可能にする。
- LDE Alignment: すべての変更がLaw-Driven Engineeringの原則に沿っていることを確認する。
Stop Conditions
以下の条件に該当した場合、即座に作業を停止し報告する。
| ID | 条件 | 対応 |
|---|
| S-GND-01 | S0 + security の発見事項が E3 未満の状態で存在 | 専門家レビューを要求して停止 |
| S-GND-02 | Law接地率が 50% 未満 | 設計の根本的見直しを提案して停止 |
| S-GND-03 | DBマイグレーションにロールバック手順がない | ロールバック手順の追加を要求して停止 |
| S-GND-04 | 認証・認可の変更にテストがない | テスト追加を要求して停止 |
| S-GND-05 | 課金ロジックの変更で二重課金リスクが検出された | 即座に停止し、リスク分析を報告 |
| S-GND-06 | verify不合格（完成度 80% 未満）の状態でreviewに進もうとした | verifyのGap解消を優先 |
| S-GND-07 | PRの差分取得に失敗、またはベースブランチが不明 | 情報の確認を要求して停止 |
Execution Flow
引数解析 → モード決定（verify / review / full）
│
├─ verify ─→ Phase A → Phase B → Phase C → 結果出力
│
├─ review ─→ Artifact-Based Review → Line Review(必須領域) → LDE Check → 結果出力
│
└─ full ───→ verify実行 → 合格判定 → review実行 → 統合レポート出力
│
└─ 不合格 → S-GND-06停止条件適用
