pi-package-authoring について
Pi パッケージの作成方法とリソース解決の仕組みを扱うスキルです。Pi のドキュメントとソースを参照し、構成、優先順位、安全上の注意点を示します。
主な機能
- 01パッケージマニフェストの指針
- 02標準ディレクトリ構成の指針
- 03リソース優先順位の分析
- 04パッケージのセキュリティ上の注意
活用シーン
- 01Pi パッケージマニフェストの作成
- 02パッケージリソースの優先関係の確認
- 03サードパーティパッケージのリスク確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ romiluz13/ pi-agent-skills --skill pi-package-authoringインストール後、Claude Code で/pi-package-authoringを入力して読み込まれたか確認します。
同梱ファイルreferences/CORPUS.md
詳細
Pi パッケージの作成
根拠
pi-mono/packages/coding-agent/docs/packages.md— マニフェスト、インストールコマンド、構成。pi-mono/packages/coding-agent/README.md— Pi Packages のセクション(pi install、package.jsonのpiキー、キーワード)。pi-mono/packages/coding-agent/src/core/package-manager.ts—resourcePrecedenceRank(パッケージ由来のリソースはユーザー/プロジェクト由来のリソースより後にソートされます)。
不変条件
- パッケージはローカルディレクトリと同じリソース解決パイプラインを通じて統合されます。パッケージ由来のメタデータは、ユーザー/プロジェクトの自動パスより後の順位になります。
pi-mono/packages/coding-agent/src/core/package-manager.tsのresourcePrecedenceRankを参照してください。 - サードパーティ製パッケージはコードを実行し、スキルは任意のアクションを指示できます。セキュリティに関する注意事項は、
docs/packages.mdと coding-agent の README に記載されています。
ワークフロー
- パッケージを定義する:
docs/packages.md/README のpackage.jsonの例に沿い、標準的なディレクトリ(skills/、extensions/など)がこれらのドキュメントと一致していることを確認します。 - 上書きの挙動を予測する:パッケージマネージャーの優先順位と、
loadSkillsの「名前が最初に一致したものを採用する」動作(pi-mono/packages/coding-agent/src/core/skills.ts)を組み合わせて判断します。
アンチパターン
docs/packages.md/README に記載されていない CLI フラグを作り出さないでください。
コメント
Markdown 対応