| name | input-file-validation |
| description | Custom Agent の入力ファイル（必読ファイル・推奨ファイル）の存在確認と欠損時の デフォルト処理ルールを提供する。Agent が作業開始時に必読ファイル表を検証し、 欠損ファイルに対して TBD 記載で続行する。 USE FOR: input file check, missing file handling, required file validation. DO NOT USE FOR: implementation. WHEN: Agent 作業開始時の入力確認、ファイル欠損時の処理判断。
|
| metadata | {"origin":"user","version":"1.0.0"} |
input-file-validation
目的
Agent が作業開始時に必読ファイル・推奨ファイルの存在を確認し、欠損時の処理を統一する。
基本ルール
必読ファイルの確認手順
- Agent 側で定義された「必読ファイル表」を取得する
- 各ファイルの存在を確認する
- 欠損ファイルがある場合は「欠損時デフォルト処理」を適用する
欠損時デフォルト処理
- 欠損ファイルは
TBD（ファイル未検出: {パス}） と明記する
- 該当セクションは仮定ベースで記述する（推測で埋めない）
- Agent 固有の「停止」「質問」等の処理は Agent 側でオーバーライドする
推奨ファイルの参照判定
- 存在すれば参照し、作業の精度を向上させる
- 存在しなくても作業は進められる
- 存在しない場合はスキップして続行する
Agent 固有のオーバーライド
Agent 側で以下をオーバーライドできる:
- 停止: 必読ファイルが欠損している場合に作業を中断し、ユーザーに通知する
- 質問: 欠損ファイルについてユーザーに確認する（最大1回）
- 続行: デフォルト動作。TBD 記載で続行する
ガイド一覧（references/）
| ファイル | 内容 |
|---|
references/missing-file-handling.md | 欠損時デフォルト処理の詳細・Agent オーバーライドパターン |
入出力例
※ 以下は説明用の架空例です。
例1: 必読ファイルが全て存在する正常ケース
入力: Agent 作業開始時に必読ファイル表を検証する。必読ファイルは以下:
docs/company-business-requirement.mddocs/catalog/service-catalog.md
出力:
docs/company-business-requirement.md — ✅ 存在確認済みdocs/catalog/service-catalog.md — ✅ 存在確認済み- 結果: 全ての必読ファイルが存在するため、作業を続行する
例2: 必読ファイルが欠損しているケース
入力: Agent 作業開始時に必読ファイル表を検証する。必読ファイルのうち docs/catalog/app-catalog.md が存在しない。
出力:
docs/company-business-requirement.md — ✅ 存在確認済みdocs/catalog/app-catalog.md — ❌ TBD（ファイル未検出: docs/catalog/app-catalog.md）- 結果: 欠損ファイルを
TBD（ファイル未検出: docs/catalog/app-catalog.md） と明記し、仮定ベースで作業を続行する
Related Skills
| Skill | 関係 | 説明 |
|---|
agent-common-preamble | 参照元 | 全 Agent 共通 Skills 参照リストから本 Skill が呼び出される |
app-scope-resolution | 併用 | docs/catalog/app-catalog.md の存在確認に本 Skill を利用 |
work-artifacts-layout | 代替 | ファイル作成は work-artifacts-layout が担当 |
