harness-error-recovery

name	harness-error-recovery
description	エラー発生時の統一リカバリ契約。エラー分類（Build失敗・Test失敗・書き込み失敗・ API制限・権限不足）ごとのリカバリフロー、3要素出力（root_cause_hint / safe_retry_instruction / stop_condition）テンプレートを提供する。 PHASE: エラー発生時（実行中または検証中にエラーを検知したとき）。 USE FOR: error recovery, build failure recovery, test failure recovery. DO NOT USE FOR: verification pipeline execution (use harness-verification-loop), pre-execution safety check (use harness-safety-guard). WHEN: エラーが発生した、ビルドが失敗した。
metadata	{"origin":"user","version":"2.0.1"}

harness-error-recovery

目的

copilot-instructions.md §0（エラーリカバリ）で定義したエラーリカバリ契約の エラー分類と対処手順 を提供する。 Agent がエラーに遭遇した際、本 Skill を参照して統一された3要素出力を行う。

---

Non-goals

• エラーの根本原因の修正 — root_cause_hint（原因推定）と safe_retry_instruction（再試行手順）を出力するが、実際の修正は Agent が行う
• 外部サービスの設定変更 — Azure リソースの権限付与等は Agent の権限外。ユーザーへの報告と stop_condition 宣言のみ
• 検証パイプラインの実行 — Skill harness-verification-loop が担当

---

エラー分類概要

詳細なリカバリフロー・3要素出力例・stop_condition テンプレート・整合性表は references/error-classification.md を参照。

分類	症状	参照
E-01: Build 失敗	dotnet build / python -m py_compile が exit code 非 0	§1 E-01
E-02: Test 失敗	dotnet test / pytest が失敗テストを報告	§1 E-02
E-03: ファイル書き込み失敗	read 確認で空ファイルまたは不正内容を検出	§1 E-03
E-04: API 制限 / タイムアウト	429 / 504 エラーが返る	§1 E-04
E-05: 権限不足	403 / AuthorizationFailed / Access Denied	§1 E-05

---

ガイド一覧（references/）

ファイル	内容
references/error-classification.md	§1 エラー分類 E-01〜E-05 の全リカバリフロー＋3要素出力例、§2 stop_condition テンプレート、§3 整合性表

Related Skills

Skill	関係	説明
harness-verification-loop	前提	検証パイプライン失敗後のリカバリ手順を本Skillが提供
harness-safety-guard	前提	CRITICAL検出時の stop_condition テンプレートを本Skillが提供
large-output-chunking	関連	ファイル書き込み失敗（E-03）時のチャンク分割手順と連携