- PowerShell 100%
| docs | ||
| references/knowledge-base | ||
| scripts | ||
| .gitattributes | ||
| .gitignore | ||
| AGENTS.md | ||
| CHANGELOG.md | ||
| README.md | ||
| SKILL.md | ||
ガバメントクラウド AWS 公開Skill
このディレクトリは、利用者がForgejoからcloneしてCodexへ同期する公開Skillリポジトリです。更新基盤、CDK、Lambda、CodeBuild、ハーネスは別リポジトリのgcas-platformで管理します。
Skill本体はルートのSKILL.md、参照資料はreferences/knowledge-base/に配置します。この構成のままSkillディレクトリとして利用できます。
目的
デジタル庁 GCASガイドの公開ページを基に、ガバメントクラウド(AWS編)の設計・構築・移行・運用に関する知識を、Codexから検索・参照しやすい形にまとめたワークディレクトリです。
収録範囲
2026-08-28時点で、指定された次の2ページを起点に取得できる公開AWS文書を収録しています。
一覧ページ自体、AWS利用概要1件、テーマ別技術ガイド19件の計21ページを対象としています。公開ページの本文表示を保存したスナップショットと、回答用に再構成した要約を併置しています。
この範囲は「指定2ページから辿れる公開AWS資料」の完全収録です。GCAS全般ガイド、他CSP(Google Cloud、Azure、OCI、さくらのクラウド)の資料、会員専用ページのテンプレート/IaC/手続き本文は別スコープです。
まず読むファイル
- docs/requirements-definition.md: 自動更新・Forgejo配布・Codex利用・将来拡張の要件定義
- references/knowledge-base/SUMMARY.md: 全体像、主要な設計判断、運用・移行の要点
- references/knowledge-base/FAQ.md: よくある質問への短い回答
- references/knowledge-base/decision-tables.md: ネットワーク、移行、DB、バッチ、監視の選択表
- references/knowledge-base/summaries/guide-cards.md: 21文書の文書別要約
- references/knowledge-base/metadata/source-catalog.md: 出典、公開日、最新改訂日、収録ファイルの対応表
- references/knowledge-base/rag/chunks.jsonl: 検索/RAG投入用のチャンク
- references/knowledge-base/raw/: 公式ページの表示本文スナップショット
Codexでの使い方
ガバメントクラウドに関する質問では、まず references/knowledge-base/SUMMARY.md と references/knowledge-base/FAQ.md を検索し、具体的な根拠確認が必要な場合に references/knowledge-base/raw/ と references/knowledge-base/metadata/source-catalog.md を参照します。検索は次のように行えます。
rg -n -i "検索語" .\references\knowledge-base
Forgejoから取得したSkillは、Windowsでは次のコマンドでグローバルSkillへ同期できます。-RepositoryUrlを指定すると一時ディレクトリへHTTPSで浅いcloneを行い、指定しない場合は現在のclone済みディレクトリを使います。原文ハッシュを検証してから入れ替えるため、取得・検証に失敗した場合は既存のSkillを変更しません。
pwsh -NoProfile -File .\scripts\sync-skill.ps1
# cloneから同期する場合
pwsh -NoProfile -File .\scripts\sync-skill.ps1 `
-RepositoryUrl "https://forgejo.example/owner/government-cloud-aws-knowledge-base.git" `
-Branch main
# 既存cloneをfast-forward限定で更新してから同期する場合
pwsh -NoProfile -File .\scripts\sync-skill.ps1 -Pull
既定の配置先は$CODEX_HOME\skills\government-cloud-aws(環境変数がない場合は%USERPROFILE%\.agents\skills\government-cloud-aws)です。別のCodex設定や検証用ディレクトリへ配置する場合は-TargetRootを指定します。同期先にはSYNC-METADATA.jsonを作成し、branch、commit、スナップショット日、manifest hashを記録します。
WindowsのGitでcore.autocrlf=trueが設定されていてもmanifestのSHA-256が変わらないよう、リポジトリは生成物をLF改行でcheckoutします。同期スクリプトもclone時にcore.autocrlf=falseを設定します。
回答時は、次のルールを守ります。
- この知識ベースのスコープ(公開AWS資料)を明示する。
- 事実、公式文書が示す推奨、利用組織側の判断事項、会員専用資料への依存を区別する。
- 「提供予定」「将来実装」「当時の制約」など、時点依存の記載は現在の仕様と断定しない。
- SCP、アクセス許可セット、テンプレート、リージョン、AWSサービスの提供状況は、実環境・最新公式資料で再確認する。
- AWSリソースを変更する操作は、別途ユーザーの明示承認がない限り実行しない。
更新方針
公式ページの更新を確認した日をスナップショット日として記録し、差分確認後に references/knowledge-base/raw/、要約、references/knowledge-base/rag/chunks.jsonl を更新します。本文に「メンバー専用ページを参照」とある情報は、公開範囲外のため推測で補完しません。
注意
本資料は設計・調査・回答支援用です。個別システムのセキュリティポリシー、法令・政府ガイドライン、調達条件、最新のGCAS通知、契約条件を置き換えるものではありません。