pi-extension-authoring

Pi 拡張機能の作成

すべての回答は、以下の pi-mono/ 内のファイルに基づいてください。

根拠となる情報

1. pi-mono/packages/coding-agent/docs/extensions.md — 機能、ライフサイクル、パターン。
2. pi-mono/packages/coding-agent/examples/extensions/README.md — 実行可能なサンプルの一覧。
3. pi-mono/packages/coding-agent/src/core/resource-loader.ts — extendResources() は既存の lastSkillPaths の後に mergePaths でパスを追加します（後から追加されたパスは、名前が異ならない限り、名前の衝突時に先に追加されたパスに優先されません）。
4. pi-mono/packages/coding-agent/src/core/agent-session.ts — 拡張機能のコマンドとキューに追加されたプロンプトの違い、スキル展開フック。
5. pi-mono/packages/coding-agent/docs/tui.md — @mariozechner/pi-tui を使った拡張機能の TUI コンポーネント統合：Component のレンダリング規約、オーバーレイのパターン、拡張機能のコンテキストでの入力処理。
6. pi-mono/packages/coding-agent/docs/custom-provider.md — プロキシ、OAuth／SSO、カスタム API、カスタムモデル定義のための registerProvider()。

不変条件

• 拡張機能では、ツール、コマンド、テーマ、プロンプト、追加のスキルパスを登録できます。正確な API の範囲はドキュメントとサンプルモジュールで定義されています。記憶に頼らず、まず docs/extensions.md を確認してください。
• 動的なリソース検出のパターンは pi-mono/packages/coding-agent/examples/extensions/ 内（例：サンプル README に記載されている dynamic-resources/）にあります。

ワークフロー

• 新しい拡張機能：docs/extensions.md を読み、最も近い examples/extensions/ のテンプレートをコピーします。その後、pi-mono 内で作業する場合はプロジェクトの AGENTS.md に合わせます。
• 拡張機能からのスキル：resource-loader.ts の extendResources と mergePaths をたどり、ユーザー／プロジェクト／パッケージのスキルとの優先順位を説明します。
• 拡張機能の TUI：拡張機能のコンテキストにおける Component のレンダリング規約について docs/tui.md を読み、ライブラリレベルの API については pi-tui スキルを併せて参照します。
• 拡張機能によるカスタムプロバイダー：registerProvider() の OAuth フローとプロキシのパターンについては、pi-cli-workspace に基づく pi-mono/packages/coding-agent/docs/custom-provider.md を参照してください。

アンチパターン

• コアで MCP をサポートしていると断言しないでください。サポートは拡張機能を通じた任意のものです（coding-agent README の設計方針を参照してください）。