Portfolio Collection / 作品合集搭建与維護
分散した作品を1つのブラウズ可能なコレクションにまとめ、実際のデータソースを保守可能に保ちます。
1. スコープの確認 / 境界の特定
リクエストをデザインディスカッション、構築、増分更新、修復、またはスケジュールに分類します。ディスカッションのみのリクエストでは実装を行いません。
提供されたリンク/ファイルと既存のアーティファクトを、質問する前に確認します。不明な点のみを確認し、できれば最大3つの質問を1回のバッチで行います：
- コレクション名、オーディエンス、承認されたソース。公開リンク、プライベートソースドキュメント、ユーザーアップロードを区別します。
- 既存のアプリケーション/データソース vs 新規構築。共有メンテナンス、必要な編集可能フィールド、アクセスモデル。
- カテゴリ、ビジュアルリファレンス、必要なタイトル/カバーの動作。定期的な作業の場合、頻度、正確な現地時間、タイムゾーン、更新先を別途取得します。
既存のプロジェクトのスタイルと選択されたスタックを使用します。リファレンスのない新しいコレクションの場合は、コストのかかる実装の前に、控えめなコンテンツファーストのレイアウトを提案します。特定のブランド、プラットフォーム、6カテゴリの分類法、または毎日のスケジュールを押し付けないでください。
2. 利用可能な機能に基づいて実行する / 能力に応じた実行
ホストの関連スキルを発見して読み、そのツールを使用する前に確認します。
- デフォルトでBrowser Useをウェブサイト/フィード収集に使用：観察→ナビゲート→投稿を検査→証拠を記録。正確なツールスキーマを読み、コネクタ名やフラグを推測しないでください。
- プライベートドキュメント/メッセージには、ホストが承認した認証済みコネクタを使用します。明示的に要求された場合、またはユーザーの承認されたスコープ内で必要な場合にのみ、プライベート履歴を検索します。
- インタラクティブなアプリケーションには、ホストのウェブ/アプリビルダーを使用します。共有コレクションには、共有の永続化とサーバーサイドの認可が必要です。ローカルストレージは代用できません。
- 一回限りの静的なショーケースには、ホストのHTMLスキルを使用できます。共有編集や自動収集がないことを説明します。
- 選択されたソースがスプレッドシート、Base、またはデータベースの場合、ホストのスプレッドシート/データベーススキルを使用します。
- スケジュール承認と設定が成功した後でのみ、ホストスケジューラを使用します。書かれたプロンプトはスケジュールされたタスクではありません。
機能が利用できない場合は、独立した作業を完了し、正確に不足している機能を特定します。共有アプリをローカルデモで静かに置き換えないでください。このパッケージはエージェントワークフローであり、スタンドアロンアプリケーションやクローラーではありません。
3. 収集と調整 / 収集、照合、重複排除
構築/更新/修復の場合、references/data-and-maintenance.mdを読んでください。
- 変更を行う前に、実際の現在のデータソースを再度読み、既存のレコードをスナップショットします。未使用のテーブルやソースコピーではなく、実際の読み取り/書き込みパスを見つけます。
- ユーザーが提供した正確なソースリンク、または確認済みの公式アカウントIDを使用します。要求されたソースに対して、別のアカウント、再投稿、または一般的な検索結果を代用しないでください。
- 元のURLをそのまま、真のタイトル、確認済みのカバー、メディアタイプ、可能であれば実際の日付、カテゴリ、証拠を記録します。不確かなフィールドは不明のままにします。
- 記事のカバーは、アバター、装飾的な本文画像、スクリーンショットではなく、記事のカバー/共有メタデータから取得します。実際のプラットフォームビデオカバーを使用します。許可された場合のフォールバックとしてのみビデオフレームを使用します。耐久性のあるアセットを保存し、出所を保持します。
- エントリの表示タイトルを合意されたポリシーに一致させます。記事のタイトルはデフォルトでそのままオリジナルにします。ショートビデオのラベルは、許可された場合にのみ確認済みのソーステキストを要約できます。オリジナルとショートラベルは別々に保持します。説明を音声トランスクリプトと呼んではいけません。
- 確認済みのソースIDで重複排除し、次に同じ作品のクロスプラットフォームバージョンを手動で調整します。1つのエントリに複数のソース/カテゴリを保存し、重複カードは作成しません。
- プライベートオリジナルは要求された場合のみ検索します。候補コンテンツを読み、最終ドラフトとブリーフ、スケジュール、インタビューの概要を区別します。元のドキュメントの権限を保持します。
- 承認されたフィールドレベルの変更のみを適用し、手動編集を保護し、保存された結果を検証します。書き込みがタイムアウトした場合、再試行する前に実際の状態を検査します。
4. コレクションの表示 / コレクションの提示
UI作業の場合、references/presentation-and-access.mdを読んでください。
- 本物のカバー、明確な検索フィールド、ユーザー承認済みのカテゴリを使用します。メディア形式フィルターとトピックカテゴリを分離します。
- 各カードは自然な高さを取ります。混合された横長/縦長のメディアには、本物の最短カラムメーソンリーまたは同等の検証済みレイアウトを使用します。短い記事カードを高いビデオカードに引き伸ばさないでください。
- アスペクト比は、ブリーフまたは元のアセットから導出します。オプションの推奨：ワイド記事は2.35:1、ポートレートビデオは3:4。すべてのプロジェクトで不変ではありません。
- 簡潔なタイトルと必要なアクションを保持します。ユーザーが要求していない概要、日付、指標、バッジを追加しないでください。
- カード本体のクリックで公開作品URLを開きます。別のプライベートオリジナルボタンがソースドキュメントを開きます。そのボタンも「いいね」コントロールもカード本体のリンクをトリガーしないでください。
- 確認された順序を適用します。カテゴリが優先される場合、そのグループと残りを実際の日付で独立して並べ替えます。日付を偽造したり、古い日付をリセットして新しく見せかけたりしないでください。
- 同じデータソースに裏付けられた、シンプルなオーナーメンテナンスエントリを提供します。認識可能なタイトルと選択された編集可能フィールドのみを表示します。
5. 公開利用とプライベート管理の分離 / 公開と管理の分離
すべての管理読み取り/書き込みには、サーバーで検証されたオーナーIDが必要です。隠しボタンやログインした任意のアカウントは認証ではありません。オーナーID/設定を公開クライアントから分離します。匿名の読者は公開された公開フィールドのみを受け取ります。連絡先データとプライベートドキュメントの内容を公開レスポンスに含めないでください。プレゼンテーションリファレンスのアクセステストを参照してください。
公開、インターネット可視性、アプリケーションコードは別々のレイヤーです。公開共有を有効にする前に、正確なスコープを尋ねます。コレクションが公開されたからといって、プライベートオリジナルの権限を決して開かないでください。ホストの承認されたデプロイパスを使用します。公開をユーザーが行う必要がある場合は、確認済みの開発/公開エントリにユーザーを導き、そのアクションの前で停止します。
6. 定期的なメンテナンスのスケジュール / 定期メンテナンス
スケジューリングの場合、references/recurring-update.mdを読んでください。 スケジュールとターゲットを確認し、既存のジョブを解決して重複を避け、実際のスケジューラを使用します。コレクションID、アカウントソース、重複ウィンドウ、保護フィールド、失敗/レポート動作をジョブ命令に含めます。確認済みの書き込みの後にのみ、成功したチェックポイントを記録します。サポートされていないソースや認証ブロックされたソースは、静かにスキップするのではなく報告します。
7. 検証と納品 / 確認と納品
完了を宣言する前に、references/verification.mdを読んでください。オプションのローカルチェッカーは次のとおりです：
python3 scripts/validate_manifest.py path/to/manifest.json
python3 scripts/validate_manifest.py path/to/after.json --baseline path/to/before.json --allow-update cover,original_urls --require-cover-proof
これらのコマンドはローカルの整合性チェックのみを実行し、ページの取得、ライブ画像の読み込みの証明、ユーザーの認証、データベースへの書き込み、または作業のスケジューリングは行いません。マニフェストの形状と証拠ルールについてはリファレンスを読んでください。
実際に追加された数、スキップされた重複候補、リンクされたオリジナル、実際のカバー読み込みカバレッジ、障害要因、プレビューと本番が異なるかどうかを報告します。主張されたすべてのアイテムを検証します。サンプル限定のチェックにはラベルを付けます。ホストの納品メカニズムを使用して現在のアーティファクトを納品します。一時的な証拠、プライベートログ、秘密を再納品しないでください。
オプションプロンプト / 再利用可能なプロンプト
バイリンガルの構築/更新プロンプトには、references/prompts.mdを使用します。ユーザーが承認した値のみを入力します。未解決のマテリアルパラメータは、発明されたデフォルトではなく明確化が必要です。プライベート設定と認証情報は、この再利用可能なパッケージの外部に保持します。