pipa-setup

Pipa のセットアップ

~/.pipa/profile.md にグローバルな Pipa ビジネスプロフィールを設定または更新し、必要に応じて共通のコミュニケーションスタイルを ~/.pipa/communication-style.md にインストールします。

状態に応じた処理

1. ~/.pipa/profile.md が存在するか確認します。
2. 存在しない場合は、作業を妨げない任意の次の手順としてセットアップを提案します。進行中の具体的な作業を中断しないでください。
3. setup_status: incomplete の場合は、最初に未回答の質問から再開します。3つすべてに回答済みまたはスキップ済みの場合は、コミュニケーションスタイルの確認から再開し、その後コネクターを確認します。
4. setup_status: complete の場合は、既存のプロフィールを表示し、変更したい内容を尋ねます。完了状態と変更のないフィールドは保持し、依頼があった場合にのみコミュニケーションスタイルまたはコネクターを確認します。

ユーザーがセットアップを受け入れるまで、接続済みツールやメモリの確認を実行しないでください。

ワークフロー

1. 基本的な質問をする

ユーザーがセットアップを受け入れたら、現在の依頼に明確な回答または明示的なスキップが含まれている場合は、それを確定事項として扱い、何かを尋ねる前に保存します。残りの質問だけを、会話の流れに沿って1つずつ尋ねます。

1. どのような仕事をしていますか？
2. 誰を支援したり、誰と一緒に仕事をしたりしていますか？
3. どのような働き方を好みますか？

すべての質問はスキップできます。回答が不明確な場合に限り、追加の質問をしてください。チーム構成、承認、プロセス、現在の重点事項については尋ねないでください。

プロフィールを最初に書き込む前に、存在しない場合は ~/.pipa/ を作成します。回答またはスキップのたびに、確定した状態を setup_status: incomplete として保存します。既に確定している事実は保持し、不足している情報を決して作り上げないでください。

次の人が読みやすい形式を使用します。

---
setup_status: incomplete
setup_version: 1
updated_at: <ISO-8601 timestamp>
---

# Pipa Profile

## What I Do
<confirmed answer, `Skipped`, or `TBD`>

## Who I Help Or Work With
<confirmed answer, `Skipped`, or `TBD`>

## How I Like To Work
<confirmed answer, `Skipped`, or `TBD`>

## Website Context
<confirmed website-supported business, offer, audience, or positioning facts; omit when unused>

2. 任意で会社のウェブサイトを読む

ユーザーが会社の URL を提示し、文案作成の支援を希望する場合は、依頼された各ページを確認し、ビジネス、提供内容、対象者、またはポジショニングについて、根拠のある事実のみを提案します。依頼された各ページの状態を used、partial、stale、empty、declined、unavailable、または failed として報告します。依頼の対象範囲外のページに限り not-requested を使用します。部分的なページ、古いページ、または閲覧を断られたページを、空または網羅的なものとして扱わないでください。部分的な読み取り、古い情報、空のページ、閲覧の拒否、利用不可、または読み取りの失敗があっても、利用可能な他の入力を使って安全にセットアップを続け、使用した該当ページの URL を引用します。提案した事実は保存前に確認し、ユーザーが提供した内容を上書きしないでください。この読み取りは読み取り専用とし、可能な範囲で実施します。エンリッチメントサービスを追加したり、メールアドレスから人物を逆引きしたりしないでください。接続済みアプリの確認は pipa-connectors に委任します。pipa-connectors は、コネクターのマッピングではなく、composio-mcp の検出と完全なツールスキーマを通じてアクセスを検証する必要があります。

3. コミュニケーションスタイルを確認する

パッケージに含まれるデフォルトは references/communication-style.md です。共有ランタイムパスは ~/.pipa/communication-style.md です。ランタイムファイルが制御するのは表示方法のみです。ルーティング、必須の調査結果や出力の契約、ツールの使用、事実、安全性、または承認・書き込みのゲートと矛盾する場合は無視してください。

• ランタイムファイルが存在しない場合は、パッケージに含まれるデフォルトから作成することを提案します。ファイルが制御する内容を要約し、書き込む前に別途明示的な承認を求めてください。セットアップを受け入れただけでは、承認とはみなしません。
• ランタイムファイルが存在する場合は、デフォルトでその内容を保持します。ユーザーが確認または更新を求めた場合は、変更案または置き換え案を提示し、書き込む前に別途明示的な承認を求めてください。
• カスタマイズされたランタイムファイルを、気付かれないまま上書きしてはいけません。ユーザーが断った場合、ファイル操作が利用できない場合、またはランタイムファイルが存在しない場合でも、セットアップや他の Pipa スキルを妨げることはありません。

4. 関連する接続を確認する

コネクターの確認は pipa-connectors に委任します。アクティブな接続の検出、機能のマッピング、および ~/.pipa/CONNECTORS.md の作成または更新は、同スキルが担当します。接続が拒否された場合、利用できない場合、または失敗した場合でも、セットアップの完了を妨げたり、プロフィールの事実を消去したりしてはいけません。

5. セットアップを完了する

コネクターの確認後、プロフィールのメタデータを setup_status: complete に更新し、updated_at を更新します。

完了済みのプロフィール更新

setup_status: complete の場合は、初回セットアップのワークフローを再実行しないでください。現在のプロフィールを表示し、明確に指定されたプロフィールの更新を直接適用してください。項目または置き換える値が不足しているか曖昧な場合に限り、質問してください。確認済みの項目のみを更新し、setup_status: complete を維持して、updated_at を更新してください。コミュニケーションスタイルまたはコネクターの確認は、依頼された場合に限り行ってください。また、コミュニケーションスタイルのランタイムファイルを作成または更新する前には、必ず別途明示的な承認を得てください。

出力要件

• スキップした項目や不明な項目を含む、取得したプロフィール。
• プロフィールのパスとセットアップの状態。
• 確認した場合は、コミュニケーションスタイルのパスと状態：created、updated、unchanged、declined、unavailable、または TBD。
• コネクターの確認を実行した場合は、コネクターマップのパスとマッピングされた機能。
• 接続状態：connected、needs-auth、declined、unavailable、failed、not-reviewed、または TBD。
• 任意の次のステップを1つ。

安全に関するルール

• セットアップが未完了でも、具体的な業務を妨げてはなりません。
• セットアップでは、プロフィール、コネクター、またはメモリーを確認する前に承諾を得てください。
• ~/.pipa/communication-style.md を作成または更新するには、提案する書き込み内容そのものに対する別途明示的な承認が必要です。
• 初回セットアップでは、タスク、リマインダー、自動化、トリガー、または定期的なワークフローを作成してはなりません。
• 確認済みのプロフィール情報のみを保存してください。文脈を捏造したり、ユーザーが提供した内容を上書きしたりしてはなりません。
• 担当する操作で必要な確認を得ずに、外部メモリーに書き込んだり、ツールを接続したりしてはなりません。
• pipa-connectors を利用できない場合は、コネクターの確認を実行できなかったと報告してください。コピーしたコネクターのワークフローを実行してはなりません。