Power Apps Code Apps・Dataverse・Power Automate・Copilot Studio を VS Code + GitHub Copilot / Claude Code で開発するための、実践的な開発標準リポジトリです。 Code Apps 自体は React / Vue などの SPA フレームワークに対応していますが、このリポジトリの実装標準は TypeScript + React + Tailwind CSS + shadcn/ui を前提にしています。
- Power Platform 向けコードファースト開発標準(
.github/skills/*/references/) - GitHub Copilot / Claude Code 用のカスタムエージェント / スキル(
.github/,.claude/) - Code Apps のスターター UI コンポーネント(
src/components/) - Power Automate / Copilot Studio 連携の実装パターン
.env.exampleを含むプロジェクト初期化テンプレート
Tip
サンプル実装はあくまでリファレンスです。業務要件に合わせて src/pages/ やスキル内スクリプトを置き換えて利用してください。
git clone https://github.com/geekfujiwara/CodeAppsDevelopmentStandard . && npm installNote
. へ clone するため、空ディレクトリで実行してください。既存ファイルがある場所で実行すると上書きリスクがあります。
npm install では postinstall で 環境事前チェック (preflight) を実行し、Node.js / npm / Python(python or py -3)/ pip / npx power-apps / pac を確認します。
Python と pip が利用可能な場合は、spec-to-markdown 用 .venv の作成と requirements.txt の導入まで自動で試行します。未導入ツールがある場合は、次に実行すべきコマンドを表示します。
セットアップ後は、GitHub Copilot または Claude Code のカスタムエージェントに「実現したいこと」をそのまま伝えて開発を進めます。
# 事前チェックのみ(不足がある場合は exit 1)
npm run check:env
# 事前チェック + Python bootstrap を再実行
npm run setup不足時の対応:
- Python 未検出: Python 3.10+ を導入して
python --versionまたはpy -3 --versionを通す - pip 未検出:
python -m ensurepip --upgrade(またはpy -3 -m ensurepip --upgrade) pac未検出:npm install -g @microsoft/power-apps-cli後、pac auth create --environment {ENVIRONMENT_ID}npx power-apps未検出:npm installを再実行し@microsoft/power-apps依存を確認
- この開発標準の実装・運用ルールは、GitHub Copilot / Claude Code で共通利用するスキル(
.github/skills/)に定義されています。 - 利用者は手順書を読み込んで操作するのではなく、カスタムエージェントに要件を伝えて進める前提です。
- GitHub Copilot の入力例(バッククオート不要): @GeekPowerCode 在庫管理アプリを Dataverse + Code Apps で作りたい
- Claude Code の入力例: GeekPowerCode エージェントを選択して「在庫管理アプリを Dataverse + Code Apps で作りたい」
- 既存仕様書がある場合の入力例: spec-to-markdown を実行して
- 既定以外の場所を使う場合の入力例: /home/.../input の仕様書を requirements markdown に変換して
Note
Microsoft Learn の現行 Code Apps 概要に合わせ、このリポジトリでは Code Apps は SPA をホストする機能 として扱います。
公式の推奨 CLI は npx power-apps 系に移行中で、pac code は将来廃止予定です。本リポジトリ内で pac code push を併記している箇所は、既知のテナント解決問題に対する暫定ワークアラウンドです。
.
├── .github/
│ ├── agents/ # Copilot カスタムエージェント定義
│ └── skills/ # 製品単位で統合された 11 スキル
│ ├── architecture/ # アーキテクチャ設計
│ ├── standard/ # 共通基盤(認証・アイコン・メールテンプレート)
│ ├── dataverse/ # テーブル設計・構築・セキュリティロール
│ ├── code-apps/ # Code Apps 開発(UI 設計・CSP・メール送信含む)
│ ├── power-pages/ # Power Pages コードサイト開発・デプロイ
│ ├── generative-page/ # Generative Pages 開発
│ ├── model-driven-app/ # モデル駆動型アプリ構築
│ ├── copilot-studio/ # エージェント構築・トリガー・ニュース配信
│ ├── power-automate/ # クラウドフロー作成・デプロイ
│ ├── ai-builder/ # AI プロンプト作成
│ └── spec-to-markdown/ # 仕様書→要件 markdown 変換
├── .claude/
│ └── agents/ # Claude Code カスタムエージェント定義
├── src/
│ ├── components/ # 再利用 UI コンポーネント
│ ├── pages/ # サンプルページ実装
│ ├── providers/ # Context / Provider 群
│ ├── hooks/ # カスタムフック
│ ├── lib/ # 共通ユーティリティ
│ └── types/ # 型定義
├── scripts/ # 環境チェック・ブートストラップ
├── plugins/ # Power Apps Vite プラグイン
├── styles/ # Tailwind スタイル
├── .env.example # 環境変数テンプレート
├── SAMPLES.md # サンプル実装の置き換えガイド
└── README.md
- .github/skills/standard/references/power-platform-development-standard.md
- .github/skills/dataverse/references/dataverse-guide.md
- .github/skills/code-apps/references/connector-reference.md
- .github/skills/code-apps/references/advanced-patterns.md
- SAMPLES.md
- GitHub Copilot では
.github/agents/と.github/skills/が認識されます - Claude Code では
.claude/agents/を利用して同じスキル群(.github/skills/)を参照できます GeekPowerCodeに実現したい内容を伝えるだけで、必要なスキルが選択されて開発タスクを進められます- このリポジトリの開発標準はスキルとして定義済みのため、マニュアル手順ベースではなくエージェント駆動で利用します
スキルの一覧・説明・推奨開発フローは スキルカタログ(.github/skills/README.md) で一元管理しています。スキルの追加・変更時はそちらを更新してください。
MIT License。詳細は LICENSE を参照してください。