github-actions-docs

GitHub Actions の質問は記憶だけで答えやすいものです。このスキルを使用して、公式の GitHub ドキュメントに基づいた回答を提供し、一般的な CI/CD アドバイスではなく、最も信頼できるページを返してください。

使用する場面

以下についての質問がある場合、このスキルを使用してください:

• GitHub Actions の概念、用語、または製品の境界
• ワークフロー YAML、トリガー、ジョブ、マトリックス、並行実行、変数、コンテキスト、または式
• GitHub ホスト型ランナー、大規模ランナー、セルフホスト型ランナー、または Actions Runner Controller
• アーティファクト、キャッシュ、再利用可能なワークフロー、ワークフロー テンプレート、またはカスタムアクション
• シークレット、GITHUB_TOKEN、OpenID Connect、アーティファクト認証、またはセキュアなワークフロー パターン
• 環境、デプロイメント保護ルール、デプロイメント履歴、またはデプロイメント例
• Jenkins、CircleCI、GitLab CI/CD、Travis CI、Azure Pipelines、または他の CI システムからの移行
• ユーザーがドキュメント、構文ガイダンス、または公式リファレンスが必要な場合のワークフロー動作のトラブルシューティング

このスキルを使用しないでください:

• 特定の失敗した PR チェック、ワークフロー ログの欠落、または CI 障害の分類。gh-fix-ci を使用してください。
• 一般的な GitHub プルリクエスト、ブランチ、またはリポジトリ操作。github を使用してください。
• CodeQL 固有の設定またはコード スキャン ガイダンス。codeql を使用してください。
• Dependabot の設定、グループ化、または依存関係更新戦略。dependabot を使用してください。

ワークフロー

1. リクエストを分類する

検索前に、質問がどのカテゴリに該当するかを決定してください:

• はじめに、またはチュートリアル
• ワークフローの作成と構文
• ランナーと実行環境
• セキュリティとサプライチェーン
• デプロイメントと環境
• カスタムアクションと公開
• モニタリング、ログ、およびトラブルシューティング
• 移行

クイック スタート ポイントが必要な場合は、references/topic-map.md を読み込んで、最も関連のあるセクションに移動してください。

2. 公式 GitHub ドキュメントで最初に検索する

• docs.github.com を真実の源として扱ってください。
• https://docs.github.com/en/actions 配下のページを優先してください。
• ユーザーの正確な用語と、workflow syntax、OIDC、reusable workflows、self-hosted runners などの焦点を絞った Actions フレーズを使用して検索してください。
• 複数のページが関連性を持つ場合は、2～3 個の候補ページを比較し、ユーザーの質問に最も直接的に答えるものを選択してください。

3. 回答する前に最適なページを開く

• 最も関連性の高いページ、および実用的な場合は正確なセクションを読んでください。
• トピック マップは検索範囲を絞るか、可能性の高い開始ページを示すためにのみ使用してください。
• ページが名前変更、移動、または不完全と思われる場合は、それを明示的に述べ、推測するのではなく最も近い信頼できるページを返してください。

4. ドキュメントベースのガイダンスで回答する

• 平易な言葉で直接的な回答から始めてください。
• ドキュメント ホームページではなく、正確な GitHub ドキュメント リンクを含めてください。
• ユーザーが要求している場合、またはドキュメント ページが例を必要とする場合にのみ、YAML またはステップバイステップの例を提供してください。
• あらゆる推論を明示的にしてください。良い表現:
  • GitHub ドキュメントによると、...
  • 推論: これは～を意味する可能性があります

回答の構成

ユーザーが詳細を要求しない限り、コンパクトな構造を使用してください:

1. 直接的な回答
2. 関連するドキュメント
3. YAML またはステップ (必要な場合のみ)
4. 推論の注記 (複数のドキュメント ページを接続する必要があった場合のみ)

引用文献をそれを裏付ける主張に近づけてください。

検索とルーティングのヒント

• 概念に関する質問の場合は、詳細なリファレンス ページの前に、概要または概念ページを優先してください。
• 構文に関する質問の場合は、ワークフロー構文、イベント、コンテキスト、変数、または式のリファレンス ページを優先してください。
• セキュリティに関する質問の場合は、Secure use、Secrets、GITHUB_TOKEN、OpenID Connect、およびアーティファクト認証ドキュメントを優先してください。
• デプロイメントに関する質問の場合は、クラウド固有の例の前に、環境とデプロイメント保護ドキュメントを優先してください。
• ユーザーが初心者向けのウォークスルーを要求する場合は、生のリファレンス ページではなく、チュートリアルまたはクイックスタートから始めてください。

よくある間違い

• 現在のドキュメントを確認せずに記憶で回答する
• より限定的なページが存在する場合、GitHub Actions ドキュメント ランディング ページにリンクする
• 再利用可能なワークフローと複合アクションを混同する
• OIDC がより適切に文書化されたパスである場合、長期間有効なクラウド認証情報を提案する
• リポジトリ固有の CI デバッグをドキュメント質問として扱い、gh-fix-ci に渡すべき場合に扱う
• codeql または dependabot がより適切に適合する場合、隣接する領域でリクエストを吸収させる

バンドルされたリファレンス

references/topic-map.md は、ドキュメント エントリ ポイントの可能性が高い、コンパクトなインデックスとしてのみ読んでください。意図的に不完全であり、ライブ GitHub ドキュメントの最終的な信頼できる情報源として使用すべきではありません。