AI web production guide

GitHubでFAQページを管理するには

FAQページのGitHub管理をAIで整理し、CodexでHTML化や公開前チェックへ進める時の考え方をまとめます。

このページはガイドです。AIツールや関連サービスの仕様、画面、料金、提供範囲は変わる可能性があります。

AIに丸投げせず、公開前には人間が内容、リンク、素材権利、秘密情報、公式誤認、スマホ表示を確認してください。

このページで整理すること

FAQページのGitHub管理は、見た目や文章を作るだけでなく、誰に何を伝えるか、どのページへ誘導するか、どの情報を公開してよいかまで含めて考える必要があります。

AIは下書き、整理、比較、チェックリスト化に役立ちます。一方で、実際の公開判断、権利確認、重要情報の扱い、最終的な表現調整は人間が確認します。

AIでできること

  • FAQの質問追加や回答修正を履歴に残す
  • Pull Requestで文言差分を確認する
  • 重要な回答のレビューを挟む
  • 内部リンクやアンカーを確認する
  • Codexで修正した差分を人間が確認する

AIだけに任せないこと

  • AIの出力を確認せず公開判断まで進めること
  • 公式ロゴや公式画像を許可なく使うこと
  • 著作権、商標、肖像権の扱いをAIだけで判断すること
  • APIキー、認証情報、DB情報、秘密鍵、証明書本文を貼ること
  • 広告タグ、robots.txt、ads.txt、サイト確認用のタグを不用意に触ること
  • 検索面の反応、売上、問い合わせ数などの結果を約束する表現を書くこと

作業の流れ

  1. FAQの対象ファイルを確認する
  2. 追加する質問と回答を整理する
  3. PRでdiffを見る
  4. 重要判断につながる回答を人間が確認する
  5. 公開前にリンクと表示を確認する

公開前チェック

  • 公開URLが200 OKか
  • title、meta description、H1が入っているか
  • canonicalが自己URLか
  • robotsがindex,followか
  • noindexが残っていないか
  • 内部リンクが404になっていないか
  • 外部リンクが明確な404ではないか
  • スマホ表示で文字、画像、ボタンが崩れていないか
  • 公式サイトのように見える表現や素材がないか
  • 個人情報、会社情報、秘密情報が入っていないか

著作権・公式誤認・秘密情報の注意

  • このページはガイドであり、各AIツールや関連サービスの仕様、画面、料金、提供範囲は変わる可能性があります。
  • 画像、ロゴ、人物写真、テンプレート、文章を使う時は、利用条件や権利関係を人間が確認します。
  • 医療、法律、金融などの重要判断につながる内容は、AIの回答だけで断定せず、必要に応じて専門家や提供元情報を確認します。
  • Webページへ反映する前に、公開してよい情報だけになっているか確認します。

回答文の担当者を指定するCODEOWNERS

2026年11月18日時点の公式ヘルプでは、CODEOWNERSはリポジトリ内のファイルを担当する個人やチームを指定するファイルです。対象ファイルを変更するPull Requestが作られると、担当者にレビューが自動で依頼されます。配置場所は.github、リポジトリのルート、docsの順で探され、最初に見つかったものが使われます。レビュー依頼に使う設定はPRのベースブランチ側に必要です。担当者にはリポジトリへの書き込み権限が必要で、チームを指定する場合はチームが表示可能で、書き込み権限も持っている必要があります。FAQ本文の担当者を設定しても、その指定だけでマージに承認が必須になるわけではありません。承認を条件にする場合は、保護ブランチの必要レビュー設定と合わせて扱う仕組みです。

出典:GitHub『About code owners』(2026年11月18日確認)https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners

レビューの修正提案を反映する単位

2026年11月18日時点の公式ヘルプでは、Pull Requestのレビューで示されたsuggestionを、そのまま変更として取り込む操作があります。提案を単独で適用する方法に加えて、複数の提案をまとめて一つのコミットへ反映する方法も案内されています。反映にはリポジトリへの書き込み権限が必要です。適用すると、PRの比較側のブランチにコミットが作られます。採用した変更の提案者はコミットの共同作成者になり、適用した人も共同作成者とコミッターとして記録されます。レビューへの対応は、コメントに返信することと、提案されたファイル変更をコミットすることが別の操作です。質問文だけを直す提案と回答文を直す提案が分かれている場合も、採用した変更がどのコミットに入ったかを履歴で追う構造になります。

出典:GitHub『Incorporating feedback in your pull request』(2026年11月18日確認)https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/incorporating-feedback-in-your-pull-request

構造化データは画面に見える内容と合わせる

2026年11月18日時点の公式ヘルプでは、構造化データは、そのページで利用者に見える内容を表す必要があります。利用者から隠された内容だけをマークアップする方法や、ページの主題と関係しない情報を入れる方法はガイドラインに沿いません。構造化データには正確さと最新性も求められ、本文と異なる情報や、古くなって実態に合わない情報は品質上の問題になります。構文が正しくても、Google側の品質要件や機能ごとの条件を満たすかは別の判断です。FAQをHTMLとJSON-LDの両方で持つ構成では、質問と回答を画面側だけ更新すると、二つの表現の内容に差が生じます。本文の変更箇所と構造化データ内の対応箇所を一緒に読む理由は、この内容の一致という要件にあります。技術面の確認にはリッチリザルトテストとURL検査ツールが案内されています。Googleが対応する形式はJSON-LD、Microdata、RDFaで、JSON-LDが推奨形式です。一方、品質要件は自動ツールだけでは簡単に判定できないと説明されています。構文を通過したかという確認と、本文の内容に即しているかという確認は別の範囲です。

出典:Google『General structured data guidelines』(2026年11月18日確認)https://developers.google.com/search/docs/appearance/structured-data/sd-policies

質問が一つの投稿ページとFAQの区別

2026年11月18日時点の公式ヘルプでは、QAPageは一つの質問とその回答を扱うページ向けの構造化データです。利用者が回答を投稿できることが条件で、一つの質問に一つの回答だけをサイト側が用意するページや、FAQのように複数の質問を並べるページには使わないと説明されています。質問、回答、投稿者などのマークアップ対象は、閲覧できる本文の内容に対応する必要があります。質問が載っているという共通点だけでは、QAPageを選ぶ根拠にはなりません。サイト管理者が複数の質問と回答をまとめて編集するFAQと、利用者が一つの質問へ回答を投稿するページでは、データの型を判断するための条件が異なります。既存FAQを増補する場合も、見出し名だけから別の型へ置き換える扱いにはなりません。

出典:Google『Q&A (QAPage) structured data』(2026年11月18日確認)https://developers.google.com/search/docs/appearance/structured-data/qapage

よくある質問

FAQページのGitHub管理はAIだけで完成できますか?

下書きや整理には使えますが、公開判断は人間が行います。FAQページのGitHub管理では、内容、リンク、素材、権利、秘密情報、スマホ表示を確認してから公開します。

Codexとはどう使い分けますか?

文章、素材、設計、管理、安全確認を各サイト側で整理し、HTML/CSSへの反映や公開前チェックはCodex側の母艦ページで確認すると分かりやすくなります。

公開前に一番注意することは何ですか?

公式誤認、著作権や商標の扱い、個人情報、APIキー、認証情報、DB情報、秘密鍵などが含まれていないかを確認することです。