screen-time-api-engineer

Screen Time API エンジニア

ドキュメント優先の根拠モデルに基づいて、Screen Time API アプリを実装し、堅牢化するためにこのスキルを使用します。

ルール

• 判断には次の根拠の順序を使用します。
  1. Apple の一次ドキュメントと WWDC
  2. ローカルの SDK インターフェイス／ヘッダー
  3. プロジェクトで確認された実装（Project Alpha／Project Beta）
  4. フィールドノート（フォーラム／Medium）
• 情報源が矛盾する場合は、一次情報と SDK の動作を優先します。
• 不確かな結論には推論であることを明記し、注意点を添えます。

SDK のベースライン

• 2026-10-21 に iOS 27.0 SDK（Xcode 27.0、ビルド 27A266a）に照らして根拠を再検証しました。
• iOS 26.2 から 26.5 で Screen Time API が追加されました。追加されたのは、ピッカーのタイトル、データアクセス（EU のみ）、シールドのサブメニュー、トークンの更新、ストアのライフサイクルです。iOS 27.0 では追加はありません。
• アプリのデプロイメントターゲットより新しい API はすべて #available でゲートし、必要な iOS バージョンを明記します。

クイックスタートワークフロー

1. ユーザーの目標カテゴリを特定します。
2. references/guides から該当するリファレンスを開きます。
3. 重要な API に関する主張を references/evidence で照合します。
4. 実装の品質やリグレッションが重要な場合は、references/rundowns を使用します。
5. 情報源と信頼度を明示して出力します。

目標とリファレンスの対応表

• エンタイトルメント、署名、配布承認：
  • references/guides/02-authorization-setup.md
  • references/guides/19-release-and-app-review-checklist.md
• ファミリーアクティビティピッカーとトークンの処理：
  • references/guides/03-familycontrols-selection-and-token-model.md
  • references/guides/04-displaying-activity-labels-and-real-app-icons.md
• シールドのポリシーとストアの動作：
  • references/guides/05-managedsettings-enforcement-patterns.md
  • references/guides/06-web-blocking-and-webdomain-policy.md
• カスタムシールドの UI／アクション：
  • references/guides/07-managedsettingsui-custom-shield-systems.md
  • references/guides/08-shield-actions-and-response-strategies.md
• スケジュール設定とモニターコールバック：
  • references/guides/09-deviceactivity-scheduling-thresholds-and-errors.md
  • references/guides/10-deviceactivity-monitor-extension-playbook.md
• 使用状況分析レポート：
  • references/guides/11-deviceactivity-report-analytics-architecture.md
• ホストアプリでの使用状況データの読み取り（iOS 26.4 以降、EU のみ）：
  • references/guides/02-authorization-setup.md
  • references/guides/11-deviceactivity-report-analytics-architecture.md
• ScreenTime フレームワークによる Web 使用状況の制御／レポート：
  • references/guides/12-screentime-framework-web-usage-reporting.md
• オンボーディングと権限 UX：
  • references/guides/13-onboarding-and-permission-ui-blueprints.md
• エンドツーエンドの実装リファレンス：
  • references/guides/14-app-and-website-blocking-reference-implementation.md
• プロジェクトの詳細分析と比較による堅牢化：
  • references/guides/15-project-alpha-implementation-analysis.md
  • references/guides/16-project-beta-implementation-analysis.md
  • references/rundowns/12-cross-project-rundown.md
• バグの予防、テスト、事前確認：
  • references/guides/17-hardening-checklist-bug-prevention.md
  • references/guides/18-testing-matrix-device-only-edge-cases.md
  • references/guides/21-preflight-rundown.md

根拠ファイル（API コントラクトの検証に使用）

• references/evidence/01-familycontrols-sdk-signatures.md
• references/evidence/02-managedsettings-sdk-signatures.md
• references/evidence/03-managedsettingsui-sdk-signatures.md
• references/evidence/04-deviceactivity-sdk-signatures.md
• references/evidence/05-deviceactivity-report-sdk-signatures.md
• references/evidence/06-screentime-framework-headers.md
• references/evidence/07-claim-reconciliation.md
• references/evidence/00-source-url-inventory.md

出力要件

実装ガイダンスにこのスキルを使用する場合、次の項目を含めます。

1. 選択した API の経路とその理由。
2. リスク／失敗モード。
3. 検証チェックリスト。
4. 信頼度ラベル付きの出典引用。

境界

• プライベート API や、サポートされていないトークン変換手法を推測しないでください。iOS 26.4 のデータアクセス API は、ホストアプリがユーザーのアプリやサイトの背後にあるバンドル ID またはドメインを読み取るために文書化された唯一の方法です。
• 明示的な注意書きなしに、標準仕様／SDK のサポートを超える動作を主張しないでください。
• リリース準備について説明する際は、拡張機能の署名の整合性チェックを省略しないでください。