agent-common-preamble

agent-common-preamble

共通ルール

.github/copilot-instructions.md §0 を最優先で遵守する。本 Skill は全 Agent 共通の参照先を集約する。

出力言語ルール（思考プロセスを含む）

• 最終出力だけでなく 思考プロセス（reasoning / chain-of-thought / 内部独白）も日本語で行う こと。
• ツール委譲の意図表明（例: "I need to delegate this task to ..."）、計画の自問自答、推論の途中経過もすべて日本語で記述する。
• 英語の固有名詞・コマンド名・ファイルパス・コード識別子・引用文はそのまま英語で構わない。
• 本ルールは hve オーケストレーターのターミナル出力（○ で始まる Thinking 行）にも適用される。

全 Agent 共通 Skills 参照リスト

• task-questionnaire：コンテキスト収集・質問票作成の詳細手順
• task-dag-planning：DAG計画・見積・分割判定の詳細手順
• work-artifacts-layout：work/ 構造設計・README入口
• large-output-chunking：巨大出力の分割手順
• adversarial-review：敵対的レビューの詳細手順
• harness-verification-loop：コード変更の5段階検証パイプライン
• harness-safety-guard：破壊的操作の事前検知
• harness-error-recovery：エラー発生時の3要素出力
• docs-output-format：docs/ 成果物フォーマットの共通原則
• knowledge-management：knowledge/ の分類・状態判定・更新手順
• knowledge-lookup：タスク実行中に業務要件が不明瞭な場合の knowledge/ 条件付き参照ルール

分割ルール

→ Skill task-dag-planning を参照。

plan.md コミット前バリデーション（全 Agent 必須）

plan.md を作成・更新した場合、コミット前に以下を execute で実行すること:

bash .github/scripts/bash/validate-plan.sh --path {WORK}plan.md

✅ PASS を確認してからコミットする。❌ FAIL の場合はエラーメッセージを確認し、plan.md のメタデータ（冒頭4行の HTML コメント）または ## 分割判定 セクションを修正する。

subissues.md コミット前バリデーション（全 Agent 必須）

subissues.md は Orchestrator がパース (hve/split_fork.py) してサブタスクを fork する。フォーマット違反は即パース失敗で Step を停止させる ため、書き手側で以下の手順を厳守すること。

作成前（必須・順序固定）

1. テンプレートを必ず read する（再発明禁止）: .github/skills/task-dag-planning/references/subissues-template.md
2. 各サブブロックは template の構造をそのまま踏襲する:
   • <!-- subissue -->（マーカー、必須・行頭）
   • <!-- title: <タイトル> -->（必須・空値/REPLACE_ME 禁止）
   • <!-- custom_agent: <Agent 名> -->（必須）
   • <!-- depends_on: <1-indexed カンマ区切り、なければ空> -->（任意・前方参照禁止）
   • ## Sub-N: <タイトル> の Markdown 見出し（<!-- title: --> と内容一致）

⚠️ Markdown 見出し（## Sub-N: ...）だけで <!-- title: --> を省略するとパーサが即失敗する。両方が必須。

作成後（必須）

完了報告前に必ず以下を execute で実行すること:

bash .github/scripts/bash/validate-subissues.sh --path {WORK}subissues.md

PowerShell 環境（Windows）では:

pwsh -NoProfile -File .github/scripts/powershell/validate-subissues.ps1 -Path {WORK}subissues.md

✅ PASS を確認してから完了報告する。❌ FAIL の場合は、欠落している <!-- title: --> 等を補い、Skill task-dag-planning §subissues.md 作成規約に従って修正・再検証する。PASS まで完了報告禁止。

書き込み失敗/巨大出力への対策

→ Skill large-output-chunking を参照。

最終品質レビュー

→ Skill adversarial-review を参照。Agent 固有の「3つの観点」は Agent 側で定義する。

knowledge/ STALENESS CHECK（セッション開始時）

1. knowledge/ 配下の対象ファイル冒頭にある STALENESS メタブロック（sources / blob_sha / generated_at / generator）を確認する
2. 記録された source path の現在 blob SHA とメタブロックの SHA を比較する
3. 不一致がある場合は「stale」と判定し、knowledge ファイルの再生成を優先する
4. 再生成時は work-artifacts-layout §4.1（削除→新規作成）に従い、メタブロックも最新 SHA で再作成する

knowledge/ 条件付き参照（タスク実行中）

タスク実行中に業務要件・仕様・用語が不明瞭な場合は、Skill knowledge-lookup を参照すること。 Agent 固有の ### knowledge/ 参照 セクションで指定された D 番号はそちらを優先する。

入力ファイル確認

→ Skill input-file-validation を参照。Agent 固有の必読ファイルリストは Agent 側で定義する。

APP-ID スコープ解決

→ Skill app-scope-resolution を参照。

重要（AAD-WEB / ASDW-WEB / ADFD / ADFDV 向け）: APP-ID 未指定時に「全 APP 対象」とはしない。 docs/catalog/app-arch-catalog.md の A) サマリ表（全APP横断） を参照し、 workflow に対応する推薦アーキテクチャの APP-ID のみを対象とする。 詳細は Skill app-scope-resolution を参照。

参照資料

• .github/skills/agent-common-preamble/references/agent-playbook.md

Related Skills

Skill	関係	説明
task-questionnaire	参照	コンテキスト収集・質問票作成の詳細手順
task-dag-planning	参照	DAG計画・見積・分割判定の詳細手順
work-artifacts-layout	参照	work/ 構造設計・README入口
large-output-chunking	参照	巨大出力の分割手順
adversarial-review	参照	敵対的レビューの詳細手順
harness-verification-loop	参照	コード変更の5段階検証パイプライン
harness-safety-guard	参照	破壊的操作の事前検知
harness-error-recovery	参照	エラー発生時の3要素出力
docs-output-format	参照	docs/ 成果物フォーマットの共通原則
knowledge-management	参照	knowledge/ 分類・状態判定・ステータス管理
knowledge-lookup	参照	タスク実行中の knowledge/ 条件付き参照ルール
input-file-validation	参照	入力ファイル確認・欠損時処理
app-scope-resolution	参照	APP-ID スコープ解決