majiayu000 Feature Doctor (Self-Healing)
目標: CONTEXT.json 基盤パイプラインが壊れた時に 中断なく復旧 し、復旧不可項目は明確に表記する。
核心原則
- SSOT 維持: CONTEXT.json が真実の源泉
- 安全な復旧: 破損時にバックアップ作成後テンプレート基盤復旧
- 明示的警告: 自動復旧された項目は必ず警告として報告
- 非破壊的補正: 既存内容を上書きせず欠落フィールドのみ補完
実行手順
Step 1: 診断実行
python3 .quality/scripts/feature_doctor.py
Step 2: 自動復旧 (必要時)
python3 .quality/scripts/feature_doctor.py --fix
Step 3: 結果要約
- 修正された CONTEXT.json リスト
- バックアップ作成パス (
CONTEXT.json.bak.<timestamp>) 確認 - 復旧不可項目はユーザーに手動介入を要求
自動復旧ルール
- CONTEXT.json 欠落: テンプレート基盤生成 +
AwaitingUser状態で表示 - JSON 破損: 既存ファイルバックアップ → 復旧版生成 → blocker にバックアップパスを記録
- 必須フィールド欠落: テンプレートデフォルト値で補完
- index/spec パス欠落: 実ファイル存在時に自動マッピング
- feature_id 不整合: 自動修正せず警告のみ出力
- brief_context 欠落/空:
brief_regenerator.pyを実行して BRIEF.md から自動抽出python3 .quality/scripts/brief_regenerator.py --apply --feature <NNN> - schema_version 旧バージョン: 段階的マイグレーション実行
- v4→v5:
architectureセクション追加 (null 初期化) - v5→v6:
completion_contractセクション追加 (テンプレート初期値) - v6→v7:
completion_contract.version+brief_contextセクション追加 - マイグレーション後
schema_version→ 7 に更新 - 非破壊原則: 既存フィールドは上書きせず、欠落フィールドのみ追加
- v4→v5:
DO / DON'T
DO
- ✅ 復旧前にバックアップ作成有無を確認
- ✅ 復旧結果を要約してユーザーに報告
- ✅ 必要時
/feature-architectで再生成を誘導 - ✅ brief_context 欠落時に
brief_regenerator.py --applyで自動補完 - ✅ schema_version が最新版 (7) 未満の場合は段階的マイグレーション実行
DON'T
- ❌ ユーザー同意なく既存コンテンツを強制上書き
- ❌ feature_id 不整合を自動修正
- ❌ 復旧結果を非表示処理
使用例
# 全体復旧
/feature-doctor
# 特定機能のみ復旧
/feature-doctor 046
実際の実行は内部的に
python3 .quality/scripts/feature_doctor.pyを使用する。