standard
Provides a base architecture and utilities for Power Platform development, including auth and env management.
Install
mkdir -p .claude/skills/standard && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/16610" && unzip -o skill.zip -d .claude/skills/standard && rm skill.zipInstalls to .claude/skills/standard
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Power Platform 包括開発標準。共通認証(auth_helper.py)・.env パラメータ・ソリューション運用など全スキル共通の開発基盤を提供する。アイコン生成・HTML メールは横断参照用の共有ユーティリティとして保持。Key capabilities
- →Manage common authentication patterns
- →Configure .env parameters
- →Support Power Platform solution operations
- →Generate icons
- →Provide HTML email templates
How it works
This skill provides a common development base for all Power Platform skills, handling authentication, .env parameters, and solution operations.
Inputs & outputs
When to use standard
- →Configure environment variables for a project
- →Set up authentication helper patterns
- →Generate icons for agents or apps
- →Deploy a Power Platform solution
About this skill
Power Platform 包括開発標準スキル
全スキル共通の開発基盤。このスキルが扱うのは 認証 / .env / ソリューション運用 の 3 テーマのみ。 個別コンポーネントの設計・構築ルールは各専門スキルが持つ(→ スキルカタログ README)。
明示された開発範囲は質問で止めず、実装・デプロイ・E2E検証まで継続する
リポジトリ URL と「クイックスタート」を依頼されたら quickstart.md を優先する。
.github/agents / .github/skills / .gitignore を安全に配置しただけでは停止せず、
利用可能な環境情報取得 → 共通認証・.env・認証キャッシュの再利用検証まで実行する。
依頼・既存設定・資料・リポジトリから実装対象と開発範囲を特定し、認証後に必ず質問して停止する工程は設けない。
要件が十分ならそのまま Step 0〜3 を進め、仮定が必要なら安全な開発既定値を採用して記録する。
本人しか決められない境界事項が残る場合のみ、実行可能な独立作業を続けながら、一度の短い質問にまとめる。
質問の回答待ちを、調査・ローカル実装・テストなど無関係な作業の停止理由にしない。
Step 0〜3 の契約に従い、
ルートの業務資料を spec/input/ へ整理 → spec-builder → architecture・既存テンプレート提案 →
認証キャッシュで既存環境・必要時の Azure を調査 → フル構成の開発デプロイ・実動作検証まで進む。
既知事項、API・CLI・設定から解決できる値、テンプレートやUIの通常選択、通常の実装判断を質問しない。
既知事項や通常の実装判断で AskUserQuestion を繰り返さない。
白紙の業務ヒアリングではなく、資料やワークスペースから事実・仮説を分け、業務改善と AI 活用の推奨を提示して実装する。
業務フローと構成の Mermaid 図をチャットと Markdown の両方へ出す。図は質問ポップアップ内に入れない。
本人の判断が不可欠な事項だけを質問する。認証、開発環境へのデプロイ、テストは明示依頼の範囲内で実施し、
既存の承認境界を超える本番公開・実データ移行・外部送信・権限変更・DLP 変更・破壊的操作だけを個別に止める。
各専門スキルのプレデプロイ・品質テスト・デプロイ後のE2E検証を行い、実際の構成・各 URL・文書を報告する。
必須構成が全て検証済みの場合だけ「全て完了」とし、未検証・承認待ちは明示する。
環境スキャンは接続先等のメタデータ取得であり、DLP / ACP・Code Apps 許可の事前診断とは分ける。
共通認証・承認・既存ファイル保護は省略しない。詳しい実行順と質問境界は E2Eデリバリー契約 に従う。
開発デプロイと費用の共通契約
月額上限の確定を開始条件にしない。 利用者が開発・構築・デプロイを依頼した範囲では、 必要な Azure リソースの作成、モデルのデプロイ、従量課金による動作検証まで進める。 予算額・月額上限・「課金を進めてよいか」を追加質問せず、予算未回答・未確定だけを理由に停止しない。 この契約は各専門スキルにも適用し、認証許可だけを開発依頼と扱うものではない。
- 既存の承認済み資産を優先し、要件・専門スキルが新規作成を求める場合は新規構築する。 要件を満たす最小構成・必要最小限の容量と検証回数を選び、必須の AI・接続・監視等を費用理由で省略しない。
- 作成/再利用するリソース、SKU・モデル・容量、従量/常時課金の別、停止・削除方法を説明・記録する。 説明は回答待ちのゲートにせず、見積もり不能な費用は未確定と明記する。無料・固定月額を保証しない。
- 明示された予算上限・課金禁止、組織の支出制限・ライセンス条件は遵守する。これらの制約を超える変更、 依頼に不要な高額 SKU・予約/専用容量・長期契約の追加は通常開発の承認範囲に含めない。 制約内の代替で要件を満たせない場合は、該当操作だけを止めて必要な判断を確認する。
- 本番・外部公開・破壊的変更・実データ移行・権限付与・管理者同意・private API の hash 承認は別の境界として維持する。 RBAC、Azure Policy、MFA、データ所在、リージョン・モデル提供可否を予算未確定と混同せず、回避しない。
サブリファレンス(必要に応じて参照)
| リファレンス | 内容 |
|---|---|
| 一気通貫クイックスタート | Step 0〜3: 既知の要件を質問で止めず、仕様・テンプレート・環境調査からフル構成の開発デプロイ・実動作検証まで自律実行する。配置は scripts/initialize_workspace.py |
| E2Eデリバリー契約 | 質問を真の承認・権限ブロッカーに限定し、DLP / カスタムコネクタ / Foundry モデル / Code Apps を実環境で連結して検証する共通手順 |
| クイックスタートの異常系 | 配置の競合・権限不足・資料なしの場合の継続方法と恒久対策 |
| Power Platform 開発標準 | 設計原則・Phase 別手順・チェックリストをまとめた全体ガイド |
| インタラクティブ環境セットアップ | PAC CLI + Dataverse API で .env を対話的に構成する手順(プロジェクト開始時に最初に参照) |
| 認証リファレンス | auth_helper.py の詳細実装・認証パターン(Dataverse / Flow / ARM・Azure SQL・Graph・自前 API のスコープ一覧を含む) |
| .env サンプル | 全フェーズ共通の .env テンプレート(各テーマで .env にコピーして値を設定) |
| コネクタ ID カタログ | コネクタの通称(SharePoint / Outlook / SQL 等)→ shared_xxx の対応表。scripts/connector_catalog.py で解決する |
| 環境チェック・障害復旧 | 明示的なチェック依頼時、または開発・デプロイ障害時だけ使用する。通常開発の事前ゲートにしない |
| Dataverse MCP 登録 | VS Code / Copilot から Dataverse を直接操作する MCP サーバー登録手順(upsert_skill 等) |
| ブラウザ自動化方針 | ブラウザ起動前に AskUserQuestion で Edge プロファイルを確認し、回答前は操作しない。ポータル操作は VS Code 統合 Playwright ブラウザ(playwright-browser_navigate / playwright-browser_click / playwright-browser_type / playwright-browser_handle_dialog 等)を使う。Playwright MCP サーバー・Playwright 単体ブラウザのインストール・起動は禁止 |
共有ユーティリティ(複数スキルから参照される横断リファレンス)
以下は単一の専門スキルに属さず複数スキルから参照されるため、共通基盤である standard/references に置いている。各スキルの SKILL.md からリンク済み。
| リファレンス | 主な参照元スキル |
|---|---|
| アイコン作成 | dataverse / copilot-studio / model-driven-app / generative-page |
| HTML メールテンプレート・テンプレートコンポーネント | power-automate / copilot-studio |
| デザイン言語(トークン/配色/UXパターン選定) | code-apps / power-pages / azure |
| デモ用 PDF 生成(reportlab / 日本語 CID フォント) | dataverse / code-apps / mcp-server |
| 地図埋め込み(Google Maps iframe・ホスト別 CSP) | generative-page / code-apps / power-pages |
大前提: 一つのソリューション内に開発
初回に本人が承認したアカウント・Edgeプロファイル・必要時の追加認証許可を
Git除外済み .env の PP_AUTH_* 設定へ記録する。
トークンはOS暗号化キャッシュ、AuthenticationRecordはホームで管理し、.env に保存しない。
auth_helper.get_token() は保存済み許可がある場合に限り、追加認証要求からブラウザー認証へ戻る。
SDK credentialの自動対話は無効のままなので、SDK操作前に共通get_tokenで必要scopeを準備する。
Code Appsのnpm CLIは別キャッシュとして 認証運用 で準備する。
認証許可は業務書き込みやデプロイの許可を兼ねず、CIでは対話を禁止する。
Dataverse テーブル・Code Apps・Power Automate フロー・Copilot Studio エージェントは すべて同一のソリューション内 に含める。
.env の SOLUTION_NAME と PUBLISHER_PREFIX を全フェーズで統一して使用する。
既定の開発契約(全スキル共通)
- SharePoint URL だけでは直接接続の指示と解釈しない。 Code Apps の業務データは Dataverse に移行して利用する。URL は既存仕様・移行元の参照情報であり、
shared_sharepointonlineを自動追加しない。SharePoint の継続利用・直接接続が明示された場合だけ例外とする。 - 移行は dataverse でスキーマを構築し、data-migration で取得済み CSV / JSON のマッピング・承認・投入・照合を行う。URL の受領だけをデータ読み取り・書き込み・削除・同期への承認としない。移行元の変更や削除は行わない。
- 環境チェックを明示的に依頼されない限り、すぐに開発を開始する。 DLP / ACP、Code Apps 許可、マネージド環境、MCP、管理者ロールの網羅確認を先行させず、管理 API が読めないことを開発停止理由にしない。
- 既知の対象環境・ソリューション・認証を再利用し、Code Apps は scaffold → init → ローカル predeploy / build → 対象環境への初回 push を優先する。初回 push はテーブル全件構築・データ移行・ローカライズの完了を待たない。未接続画面はその旨を表示し、データ接続後に改善デプロイする。
- 障害時だけ admin の権限確認付き復旧 へ進む。原因に関係する委任権限・対象範囲を確認し、実行可能な診断・承認済み最小修復・限定リトライを行う。権限なし・不明なら無駄な管理操作をせず管理者へ依頼する。
- これは事前の網羅的な環境診断を省く契約であり、既知の組織ポリシー、デプロイ先の確認、設計・移行・公開・設定変更の承認、ローカル品質チェックは省略しない。
共通の事前確認契約(調査先行・必要な確認だけ)
依頼文・既存 .env・認証プロファイルから分かる事項は再質問せず使う。
Code Apps では上の既定の開発契約を優先し、ローカル開発に不要な管理者確認やライセンス棚卸の回答を待たない。
依頼・既存設定・読み取り API から先に値を確定する。実操作に必要で本人しか決められない事項が残る場合だけ、
独立作業を継続しながら、関連する不足事項を一度の AskUserQuestion にまとめて確認する。
クイックスタートでも認証後の要望確認を必ず質問する必要はない。明示済みの意図でそのまま始め、
不足値は既存設定・資料・テンプレート・API 調査から自律的に解決する。以下の分類ごとの質問や承認を必須にせず、
本人しか決められない事項だけをまとめて確認する。
以下は確認事項の分類であり、全項目の調査完了を一律の着手条件にしない。以降の Step で同じ内容を聞き直さない。
既知の値を再利用し、実操作に必要な不足事項だけ確認する。
1. 対象テナント、Power Platform 環境、Azure サブスクリプションなどの実装先
2. 開発、テスト、本番のどこまで実施するかと、デプロイまたは公開の承認範囲
3. 必要な製品ライセンス、容量、プレビュー参加条件が満たされているか
4. 作成・変更・公開・管理者同意・ロール割り当てを行う担当者と最小権限
5. 対象ソリューション、パブリッシャー、命名、利用者または公開対象
6. 認証方式、接続、シークレットストア、データ分類と外部共有の可否
7. 検証担当者、受け入れ条件、ロールバックまたはクリーンアップ方針
この7分類は確認項目のカタログであり、ユーザーへの質問票ではない。既知の値は再利用し、実際の操作に必要なものだけ自動取得する。 各専門スキルは追加の事前質問を必須にせず、本人しか決められない具体的な承認・選択が残る場合だけ確認する。最低限、次を守る。
- 製品ライセンスとプレビュー制度を別項目として扱う。
- 「管理者権限が必要」とだけ書かず、工程ごとの最小ロールまたは必要な具体的権限を示す。
- 開発者が全ロールを持つと仮定せず、ライセンス、公開、管理者同意、Azure RBAC の担当者を分けて記録する。
Global Administrator、Owner、System Administratorは、より狭いロールで完了できない工程に限定する。- デプロイや公開の前に対象・承認範囲・ローカル品質を確認する。既知の必須条件が未充足ならその操作を停止するが、管理 API による環境診断は明示依頼時・障害時だけとする。
- 検証チェックリストに、実際の対象環境・公開範囲・承認を確認したことを含める。製品固有の公開・プレビュー承認は各スキルに従う。
共通基盤: .env と認証
すべてのデプロイスクリプトは以下の 共通パラメータ と 共通認証 を使用する。 各スキルから個別に認証を設定する必要はない。
.env 共通パラメータ
推奨: インタラクティブセットアップ で pac CLI から対話的に .env を構成する(PAC 認証 → 環境選択 → パブリッシャー/ソリューション選択を AskUserQuestion で進行)。
PAC 認証プロファイルがない場合(PAC CLI 未インストール・auth create 不可)は、Power Apps ポータル > 設定(右上の⚙)> セッション詳細 から以下の値を取得して手動設定する(インタラクティブセットアップの Step 2 参照)。
# === 必須(全フェーズ共通)===
DATAVERSE_URL=https://{org}.crm7.dynamics.com/ # セッション詳細: Instance URL
TENANT_ID={your-tenant-id} # セッション詳細: Tenant ID
SOLUTION_NAME={YourSolutionName}
PUBLISHER_PREFIX={prefix}
# === オプション ===
PAC_AUTH_PROFILE={YourProfileName} # PAC CLI 認証プロファイル名
[email protected] # Power Automate 通知先
BOT_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx # Copilot Studio Bot ID(URL でも可)
セッション詳細の Environment ID は
pac auth create --environment {env-id}でも使用する。
| パラメータ | 用途 | 使用フェーズ |
|---|---|---|
DATAVERSE_URL | Dataverse Web API のベース URL | 全フェーズ |
TENANT_ID | Azure AD テナント ID | 全フェーズ |
ENV_ID | Power Platform 環境 ID | 全フェーズ |
SOLUTION_NAME | ソリューション一意名 | 全フェーズ |
PUBLISHER_PREFIX | テーブル・列のプレフィックス | 全フェーズ |
PAC_AUTH_PROFILE | PAC CLI の認証プロファイル名 | Phase 6 (Code Apps) |
ADMIN_EMAIL | フロー通知先メール | Phase 5 (Power Automate) |
BOT_ID | Copilot Studio Bot ID or URL | Phase 7 (Copilot Studio) |
共通認証: auth_helper.py
./auth_helper.py が全デプロイスクリプトの認証を一元管理する。
同一マシン・同一 OS ユーザー・同一 tenant/client ID のプロジェクト間でキャッシュを共有する 2 層構成。
通常は初回だけブラウザ認証し、以後はサイレント更新する。条件付きアクセスのサインイン頻度・
失効・同意要求で再認証が必要になることはある。有効期間をクライアント側で延長しない。
層1: AuthenticationRecord (~/.power-platform-cli/auth_record_{TENANT_ID}.json)
- アカウント情報(テナント・ユーザー ID)を保存
- ホームディレクトリ配下の固定パスに永続化(プロジェクトフォルダに依存しない)
- そのため、別プロジェクトを新規に開いても再度ブラウザ認証を求められない
層2: TokenCachePersistenceOptions (MSAL OS 資格情報ストア)
- リフレッシュトークン・アクセストークンを永続化(同一マシンで共有)
- 更新トークンが利用可能ならサイレントリフレッシュ(暗号化必須、平文保存へフォールバックしない)
初期セットアップ: get_token(allow_interactive=True) → キャッシュを優先 → 必要時だけブラウザで認証
2回目以降(別プロジェクトでも): キャッシュから自動取得(認証プロンプトなし)
追加認証が必要な場合: AuthenticationRequiredError → キャッシュを保持し、保存済み継続許可または明示許可でブラウザ認証
テナント切替: テナント別の既存キャッシュを使い、他テナントのファイルは削除しない
PAC CLI プロファイルでトークンを取得できない場合は、ローカルブラウザでのインタラクティブ認証
(InteractiveBrowserCredential)を使用する。デバイスコード認証は行わず、初回の認証後はキャッシュから
サイレントにトークンを取得する。
初期セットアップで tenant/client ID ごとに get_token(..., allow_interactive=True) を実行し、
AuthenticationRecord をホームディレクトリの JSON に保存する。トークン自体は JSON に含めず、
OS 資格情報ストアに保存する。以後のスキルは共通 auth_helper.py からキャッシュを再利用し、
個別の認証フローやプロジェクト内の認証 JSON を作らない。
get_credential() も同じ credential を SDK に渡す。`
Content truncated.
When not to use it
- →When designing or building individual components
- →When troubleshooting specific Power Automate or Copilot Studio issues
Limitations
- →This skill only handles authentication, .env, and solution operations.
- →Individual component design rules are held by specialized skills.
How it compares
This skill centralizes common development standards and utilities, preventing individual skills from needing to implement them.
Compared to similar skills
standard side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| standard (this skill) | 0 | 4mo | Review | Intermediate |
| openspec-onboard | 10 | 9mo | Review | Beginner |
| workflow-orchestration-patterns | 10 | 6mo | No flags | Advanced |
| meta-automation-architect | 7 | 12mo | Review | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by geekfujiwara
View all by geekfujiwara →You might also like
openspec-onboard
studyzy
Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
workflow-orchestration-patterns
wshobson
Design durable workflows with Temporal for distributed systems. Covers workflow vs activity separation, saga patterns, state management, and determinism constraints. Use when building long-running processes, distributed transactions, or microservice orchestration.
meta-automation-architect
comzine
Use when user wants to set up comprehensive automation for their project. Generates custom subagents, skills, commands, and hooks tailored to project needs. Creates a multi-agent system with robust communication protocol.
hive-mind-advanced
ruvnet
Advanced Hive Mind collective intelligence system for queen-led multi-agent coordination with consensus mechanisms and persistent memory
openspec-new-change
studyzy
使用实验性的产出物工作流启动一个新的 OpenSpec 变更。当用户想要通过结构化的分步方法创建新功能、修复或修改时使用。
router-first-architecture
parcadei
Router-First Architecture