pinme-share

PinMe Share

洗練された静的な共有用アーティファクトを作成し、pinme upload でアップロードして、最終的な URL を返します。

使用するタイミング

ユーザーから次の依頼があった場合に、このスキルを使用します。

• PinMe を使って成果を共有または公開する。
• デプロイ済みのプロジェクトリンク、デモ、レポート、アーティファクトをまとめた静的ページを作成する。
• Codex の会話／セッションを要約し、ページとして共有する。
• プロジェクトの引き継ぎ内容を、公開用のランディングページまたは概要ページにまとめる。
• 既存の静的ファイルまたはフォルダーを、簡単に配布できるようアップロードする。

バックエンド、データベース、認証、メール、LLM の機能が必要な場合は、まずメインの pinme スキルと関連する PinMe 統合スキルを使用してください。結果をまとめて公開する段階で、pinme-share を使用します。

基本的なワークフロー

1. 共有する内容を特定します。
   • PinMe／フルスタックプロジェクト：デプロイ済み URL、簡潔な説明、主な機能、技術スタック、利用上の注意点。
   • Codex の会話：目標、決定事項、実装の概要、重要な成果物、次の手順。
   • 静的ファイル／レポート／デモ：タイトル、目的、ファイルの内容またはプレビュー、受け取る人向けの説明。
2. 静的な共有用アーティファクトを作成します。
   • 自己完結した単一の index.html を優先します。
   • リポジトリに既存の出力／共有の慣例がない限り、現在のワークスペース内に share/<slug>/index.html を使用します。
   • 移植性を高めるため、CSS はインラインにします。
   • インタラクションに価値がない限り、JavaScript は不要です。
3. 公開前にサニタイズします。
   • シークレット、トークン、API キー、.env の値、内部専用 URL、非公開のユーザーデータ、無関係なログを削除します。
   • 会話の要約では、ユーザーが逐語的な共有を明示的に求めていない限り、生のトランスクリプトをそのまま載せず、要約します。
   • リンクは明示的にし、クリックできるようにします。
4. PinMe でアップロードします。

   pinme upload share/<slug>
   

5. PinMe が出力した URL を返します。PinMe が複数の URL を出力した場合は、DNS ドメイン、PinMe サブドメイン、短縮 URL、完全なプレビュー URL の順に優先します。ハッシュフラグメントは決して切り詰めないでください。

共有ページの内容

プロジェクトの共有ページには、次の内容を含めます。

• プロジェクト名と一文の説明。
• 最初のアクションとして、主要な起動／デモリンク。
• 何をするものか、誰を対象としているか、なぜ重要か。
• ユーザーに見える動作を中心とした機能一覧。
• 受け取る人に役立つ場合に限り、ビルド／デプロイの詳細。
• 適切な場合に限り、「Codex で作成」などの日付や出所情報。

会話の共有ページには、次の内容を含めます。

• 会話のタイトル。
• 最初の目標または質問。
• 主な背景情報と制約。
• 決定事項。
• 完了した作業または回答の要約。
• 関連する場合は、変更したファイル、実行したコマンド、作成したリンクやアーティファクト。
• 今後の対応事項。

ファイル／レポートの共有ページには、次の内容を含めます。

• わかりやすいタイトルと簡潔な要約。
• ファイルが別にある場合は、アップロード済みアーティファクトへのダウンロード／閲覧リンク。
• 重要な抜粋または生成した要約。
• ソース／背景情報。

HTML ガイドライン

• 汎用的なプレースホルダーではなく、実際に使える共有ページを作成します。
• 最も重要なリンクを最初の画面内に表示します。
• 単体の静的ファイルとして動作する、クリーンでレスポンシブな HTML／CSS を使用します。
• デザインは落ち着いた読みやすいものにします。技術的な引き継ぎに、過度に装飾したマーケティング向けのレイアウトを使わないでください。
• セマンティックなセクション、十分なコントラスト、説明的なリンクテキスト、適切なモバイル向けの余白を使用します。
• ユーザー提供のテキストを HTML に挿入する前にエスケープします。
• コードまたはコマンド出力を表示する場合は、<pre><code> で囲み、短くまとめます。

PinMe アップロードチェックリスト

アップロードの前に、次を確認します。

pinme --version

PinMe が見つからない場合、または古い場合は、メインの pinme スキルに従ってインストールまたは更新します。アップロードには認証が必要です。

pinme login
# or: pinme set-appkey <AppKey>

アップロード例：

pinme upload share/my-project
pinme upload share/conversation-summary
pinme upload ./report.html
pinme upload ./dist

次のものはアップロードしないでください。

• .env、.git、node_modules、ソースツリー、非公開データセット、認証情報を含む生ログ、無関係なビルドキャッシュ。
• シークレットや非公開情報が含まれる可能性のある、生の会話トランスクリプト。ただし、ユーザーが共有する正確な内容を明示的に承認した場合を除きます。

最終回答

ユーザーに次の内容を伝えてください。

• 作成した共有用成果物。
• アップロードによって返された PinMe URL。
• PinMe が認証されていない、または利用できないためアップロードをスキップした場合など、重要な注意事項。

回答は簡潔にしてください。URL が主な成果物です。