SharePoint スキル（Graph API・AAD アプリ登録不要）
Microsoft Graph API で SharePoint を操作する。新規の Entra アプリ登録を行わない。 組織によっては
一般ユーザーにアプリ登録権限が無いことが多く、そのハードルを避けるため、Microsoft 製の well-known
パブリッククライアント（Microsoft Graph PowerShell）への委任同意だけで完結させる。
対応する操作
サイトの更新・削除、グループ非連携のコミュニケーションサイト作成は Graph v1.0 に汎用 API が無く未対応。
詳細・回避策は references/troubleshooting.md を参照。
前提
- standard スキル の
auth_helper.py が使えること（.env に TENANT_ID 設定済み）
- 対象 SharePoint サイトの URL（例:
https://{tenant}.sharepoint.com/sites/{site}）
- 書き込み権限を持つアカウントでサインインできること（
Sites.ReadWrite.All 等の委任スコープは
Admin 同意が必要な場合がある。管理者アカウントでの初回同意を推奨）
なぜ既定の認証クライアントでは失敗するか
auth_helper.py の既定クライアント（Azure CLI 互換）には SharePoint 書き込み系スコープ
（Sites.ReadWrite.All 等）が事前同意されていないため、書き込み系操作（POST/PUT）が
403 Forbidden になる（読み取り専用の GET は通ることが多く紛らわしい）。
新しい Entra アプリを登録すれば権限を自由に設計できるが、組織によってはアプリ登録自体が
一般ユーザーに許可されていないことが多い。そこで、Microsoft が既に multi-tenant で
公開・運用している Microsoft Graph PowerShell のクライアント ID
（14d82eec-204b-4c2f-b7e8-296a70dab67e、全スクリプトの既定値）を使う。これは対象テナントに
新規アプリを登録する必要がなく、初回のみそのクライアントへの委任スコープ同意（管理者同意が
必要な場合あり）を行うだけで済む。
Work IQ のような一部の Microsoft 製 API は、これでも AADSTS65002（第一者アプリ同士の
事前承認が必要）で拒否される。 これは認証方式の問題ではなく、API 提供元が個別に許可した
第一者クライアントしか受け付けない仕様のため、well-known クライアント ID を変えても解決しない。
SharePoint / Graph の一般的なリソースにはこの制限は無いため本スキルの方式が使える
（詳細は references/troubleshooting.md 参照）。
手順
Step 1: リスト（ドキュメントライブラリ）と列を作成する
列を作りたい場合は Microsoft Graph columnDefinition
形式の JSON 配列を用意する（references/sample-columns.json 参照）。
列名を決める際の注意（重要）: SharePoint の非表示システム列と displayName が衝突する名前
（Description / Version / Title / Name / Type 等）は使わない。衝突すると Graph が
内部名を Xxx0 のように自動リネームし、冪等性チェックが効かず実行のたびに重複作成される。
SkillDescription のように接頭辞/接尾辞を付けて回避する。URL を保存する列は hyperlinkOrPicture
型ではなく text 型を使う（後述の理由により hyperlinkOrPicture は本スキルの検証環境で
一貫して 400 になった）。
# 確認のみ
python .github/skills/sharepoint/scripts/create_list.py `
--site-url "https://{tenant}.sharepoint.com/sites/{site}" --list-name "SkillCatalog" --columns "path/to/columns.json"
# 実際に作成
python .github/skills/sharepoint/scripts/create_list.py `
--site-url "https://{tenant}.sharepoint.com/sites/{site}" --list-name "SkillCatalog" --columns "path/to/columns.json" --apply
既存のリスト・列はスキップするため再実行しても安全（冪等）。
Step 2: リストに項目を登録する
注意: create_list_item.py はドキュメントライブラリ（--template documentLibrary）には使えない
（Graph が POST .../items を拒否する。実機で確認済み。references/troubleshooting.md #7 参照）。
表形式データを行として管理したい場合は create_list.py --template genericList で汎用リストを作成すること。
python .github/skills/sharepoint/scripts/create_list_item.py `
--site-url "https://{tenant}.sharepoint.com/sites/{site}" --list-name "MyGenericList" `
--fields "path/to/fields.json"
--fields は PowerShell の引用符ネストで壊れやすいため、JSON はファイルに書いて渡すことを推奨する
（例: {"Title": "Widget", "Color": "Purple"}）。列名は create_list.py で作成した内部名（name）を使う。
Step 3: ファイルをアップロードする
python .github/skills/sharepoint/scripts/upload_file.py `
--site-url "https://{tenant}.sharepoint.com/sites/{site}" `
--local-path "./skill-image.png" --remote-path "SkillCatalog/skill-image.png"
既定ドキュメントライブラリ（サイトの drive = 通常 "Documents"）を起点にした相対パスを指定する。
250MB を超えるファイルは分割アップロードセッションが必要で本スキル未対応。
Step 4: ページを作成する
python .github/skills/sharepoint/scripts/create_page.py `
--site-url "https://{tenant}.sharepoint.com/sites/{site}" `
--page-name "skill-catalog.aspx" --title "スキルカタログ" --html "<p>紹介文</p>" --publish
--publish を付けると作成直後に公開する。
Step 5（間接的・制約あり）: サイトを作成する
Graph v1.0 に「新規 SharePoint サイトを直接作成する」汎用 API は無い。M365 グループを作成し、
その副作用としてプロビジョニングされる連携チームサイトを取得する方式を使う。
# 確認のみ
python .github/skills/sharepoint/scripts/create_site.py --display-name "Skill Catalog" --mail-nickname skillcatalogpoc
# 実際に作成（テナントに新しい M365 グループが追加されるため実行前に必ずユーザーに確認する）
python .github/skills/sharepoint/scripts/create_site.py --display-name "Skill Catalog" --mail-nickname skillcatalogpoc --apply
サイト作成はテナントのディレクトリに新しい M365 グループを追加する操作。 他の操作（リスト・
ファイル・ページ）よりも影響範囲が大きいため、--apply 実行前に必ずユーザーに確認すること。
参照