| name | eld-ground-law-monitor |
| description | 実行時Law違反監視スキル。本番環境でのLaw違反を検知し、分析結果を記録して継続的改善を促す。使用タイミング: 本番ログからLaw違反を分析する時、「Law違反を確認して」、運用中のLaw健全性をチェックする時、違反パターンから新Lawを発見する時。 |
Law Monitor
本番環境でのLaw違反を監視し、分析結果を記録する。
監視フロー
Telemetry/Log → 違反検知 → パターン分析 → 記録 → 改善提案
↓ ↓ ↓ ↓ ↓
law.*.violated 分類・集計 根本原因分析 lessons.md Law強化
監視対象
Telemetryメトリクス
law.<domain>.<law_name>.violated_total # 違反総数
law.<domain>.<law_name>.violation_rate # 違反率
law.<domain>.<law_name>.p95_latency_ms # 95パーセンタイル遅延
Log/Event
{
"event": "law.violation",
"law_id": "LAW-inv-balance",
"severity": "S1",
"context": {
"expected": 100,
"actual": -5,
"diff": 105
},
"timestamp": "2024-12-21T10:30:00Z"
}
分析プロセス
Step 1: 違反イベント収集
grep "law.violation" /var/log/app/*.log | jq -s 'group_by(.law_id)'
Step 2: パターン分類
| パターン | 説明 | 対応 |
|---|
| 単発 | 1回限りの違反 | 個別調査 |
| 周期的 | 定期的に発生 | 根本原因分析 |
| バースト | 短時間に集中 | 緊急対応 |
| 漸増 | 徐々に増加 | Law見直し |
Step 3: 根本原因分析
violation_analysis:
law_id: LAW-inv-balance
pattern: 漸増
period: 2024-12-01 ~ 2024-12-21
count: 47
root_cause_candidates:
- hypothesis: "並行処理での競合条件"
confidence: high
evidence: "複数リクエスト同時処理時に集中"
- hypothesis: "バリデーション漏れ"
confidence: medium
evidence: "特定APIエンドポイントからのみ発生"
affected_contexts:
- endpoint: /api/orders
- user_segment: enterprise
- time_window: 10:00-12:00 JST
Step 4: 改善提案
recommendations:
immediate:
- action: "STMによる在庫更新のトランザクション化"
priority: high
effort: medium
law_enhancement:
- action: "LAW-inv-balance に並行制御要件を追加"
new_statement: "在庫更新は原子的に行い、並行リクエスト間で整合性を保つ"
new_law_candidate:
- id: LAW-inv-concurrent-update
type: Invariant
statement: "同一商品への並行更新は順序付けて実行する"
出力形式
Law Health Report
# Law Health Report
## Period: 2024-12-15 ~ 2024-12-21
## Summary
| Severity | Total Laws | Violations | Health |
|----------|------------|------------|--------|
| S0 | 3 | 0 | 🟢 Healthy |
| S1 | 5 | 2 | 🟡 Degraded |
| S2 | 10 | 5 | 🟢 Healthy |
## S1 Violations (Attention Required)
### LAW-inv-balance
- **Violations**: 47
- **Trend**: 📈 Increasing
- **Pattern**: Burst (10:00-12:00 JST)
- **Root Cause**: Concurrency issue (high confidence)
**Recommended Actions**:
1. [Immediate] 在庫更新にトランザクション追加
2. [Law Enhancement] 並行制御要件を明文化
3. [New Law] LAW-inv-concurrent-update の追加検討
### LAW-pre-order-limit
- **Violations**: 12
- **Trend**: 📉 Decreasing
- **Pattern**: Single events
- **Root Cause**: Edge case in validation
**Recommended Actions**:
1. [Bug Fix] バリデーションのエッジケース修正
使用例
User: 今週のLaw違反を確認して
Claude: Telemetry/Logを集計し(対象期間: 2024-12-15〜21)、Law Health Reportを生成します。
LAW-inv-balance (S1): 47件, 📈+35%, バースト型(10:00-12:00集中)
根本原因候補: 並行処理での競合条件(confidence: high)
推奨アクション: 在庫更新処理にSTM導入、Lawに並行制御要件を追加
→ 分析結果をtasks/lessons.mdに記録しました