Recap 統合

Recap ライブラリの統合、設定、または使用時にこのスキルを使用します。

最初に読むべきファイル

以下のファイルから始めてください:

• README.md
• Sources/Recap/Public/RecapScreen.swift
• Sources/Recap/Public/View+Recap.swift
• Sources/Recap/Public/RecapDisplayPolicy.swift
• Sources/Recap/Public/RecapDisplayPolicy.Trigger.swift
• Demo/Demo/Assets/Releases.md
• Demo/Demo/DemoRecapScreen.swift

タスクが特定の型に関わる場合のみ、Sources/Recap/Public/ 内の追加の公開 API ファイルを参照してください。

コアワークフロー

1. タスクが統合、リリース作成、表示ポリシー、またはスクリーンカスタマイズのどれに関するものかを特定します。
2. カスタム実装よりも Recap の公開 API を優先します。
3. README とデモアプリの既存の Recap ネーミングと例に合わせます。
4. 例とリリースコンテンツは、ユーザー向けかつ簡潔に保ちます。

統合ルール

• バンドルされたリリースマークダウンには ReleasesParser(fileName:) を優先します。
• プレゼンテーションのエントリーポイントとして RecapScreen(releases:) を優先します。
• 手書きのバージョン制御よりも RecapDisplayPolicy と RecapDisplayPolicy.Trigger を優先します。
• ユーザーが明示的に .labeled または .compact を強制したい場合を除き、.recapScreenPaginationStyle(.automatic) を優先します。
• 動作をカスタマイズする場合、タスクが明示的にライブラリの変更でない限り、内部実装を編集するのではなく View+Recap モディファイアを使用します。

リリースマークダウンルール

Recap リリースマークダウンファイルを作成または編集する場合:

• 最新のリリースを最初に配置します。
• README.md に記載されたスキーマに従います。
• アプリバージョンごとに 1 つのリリースセクションを使用します。
• コミットスタイルの要約ではなく、ユーザー向けの機能タイトルと説明を使用します。
• コミット数ではなく、製品への影響に基づいてセマンティックな変更タイプ(Major、Minor、Patch) を選択します。
• Demo/Demo/Assets/Releases.md のスタイルと構造を再利用します。

Mac Catalyst ガイダンス

タスクが Mac Catalyst に関わる場合:

• 自動ページネーション、ラベル付きボタン、コンパクトボタンの区別を保持します。
• Catalyst プレゼンテーションを変更する際に、iPhone または iPad の動作を低下させないよう注意してください。

避けるべきこと

• 異なるリリースマークダウン形式を作成しないでください。
• ReleasesParser で十分な場合、リリースを手動で解析しないでください。
• ユーザーが公開 API 外の動作を明示的に必要とする場合を除き、RecapDisplayPolicy をカスタムバージョン比較ロジックで置き換えないでください。