Pi Agent: Package Management
最終更新：2026-08-31
--- title: "パッケージ管理" description: "Pi Agentのパッケージ管理システムを学び、スキルとツールパッケージのインストール、作成、公開を行います。" order: 17 lang: ja
パッケージはスキルとツールの「配送箱」——パッケージ化すれば、ワンクリックインストール、チーム共有。
1. Pi Agentパッケージとは
パッケージはスキル、ツール、テンプレート、設定の配布可能な単位です：
TEXT
📖 参照専用
パッケージ vs 拡張機能 vs スキル
├── スキル → 単一能力（例：code_review）
├── 拡張機能 → プラグイン（ツール＋スキル＋フック）
└── パッケージ → 配布载体（複数の拡張機能＋スキル＋テンプレート）
2. パッケージコマンド
(1) 検索
BASH
pi-agent pkg search code-review
pi-agent pkg search --category devops
pi-agent pkg search --author alice
(2) インストール
BASH
pi-agent pkg install code-review-tools
pi-agent pkg install devops-toolkit@1.2.0
pi-agent pkg install git+https://github.com/user/my-pkg.git
(3) 管理
BASH
pi-agent pkg list
pi-agent pkg info code-review-tools
pi-agent pkg update
pi-agent pkg update devops-toolkit
pi-agent pkg remove code-review-tools
3. パッケージの作成
(1) パッケージ構造
TEXT
📖 参照専用
my-dev-tools/
├── pkg.yaml
├── tools/
│ ├── git_helper.py
│ └── docker_tool.py
├── skills/
│ ├── code_review.yaml
│ └── deploy.yaml
├── templates/
│ └── commit_msg.yaml
└── tests/
└── test_tools.py
(2) pkg.yaml
YAML
name: my-dev-tools
version: "1.0.0"
description: "開発ツールセット"
author: "Alice"
license: "MIT"
repository: "https://github.com/alice/my-dev-tools"
min_pi_agent_version: "0.8.0"
dependencies:
- git-tools>=1.0.0
tools:
- tools/git_helper.py
- tools/docker_tool.py
skills:
- skills/code_review.yaml
- skills/deploy.yaml
categories:
- development
- devops
tags:
- git
- docker
- code-review
4. バージョン管理
(1) セマンティックバージョニング
TEXT
📖 参照専用
メジャー.マイナー.パッチ
1.0.0 -> 1.0.1 -> 1.1.0 -> 2.0.0
メジャー：互換性のないAPI変更
マイナー：後方互換のある新機能
パッチ：後方互換のあるバグ修正
(2) バージョン制約
YAML
dependencies:
- git-tools>=1.0.0 # 1.0.0以上
- docker-tools~=2.1 # 2.1.x（2.1と互換）
- utils>=1.0,<2.0 # 1.x系列
5. パッケージの公開
BASH
pi-agent pkg validate my-dev-tools
pi-agent pkg test my-dev-tools
pi-agent pkg build my-dev-tools
pi-agent pkg publish my-dev-tools
pi-agent pkg install my-dev-tools
6. パッケージリポジトリ
(1) 公式リポジトリ
BASH
pi-agent pkg search --repo official
(2) サードパーティリポジトリ
YAML
package_repos:
- name: official
url: "https://pkg.pi-agent.dev"
- name: company
url: "https://pkg.internal.company.com"
auth: token
❓ よくある質問
Q パッケージと拡張機能の違いは？
A パッケージは配布の载体、拡張機能はランタイムのプラグインです。1つのパッケージに複数の拡張機能を含められます。パッケージは「配布とバージョニング」、拡張機能は「機能の読み込み」に焦点を当てています。
Q 依存関係の競合は？
A Pi Agentはpipのような依存関係リゾルバーを使用します。自動解決できない場合は手動でのバージョン指定を促されます。
Q 安全なアップデートは？
A マイナーとパッチのアップデートは後方互換です。メジャーアップデートはCHANGELOGの確認が必要です。
📖 まとめ
- パッケージはスキル、ツール、テンプレートの配布可能な単位
- pkg.yamlがメタデータと依存関係を定義
- セマンティックバージョニング；制約構文はpipと同様
- 公式およびプライベートリポジトリをサポート
- 検索、インストール、更新、アンインストール、公開の完全なワークフロー
📝 練習問題
- 基礎（難易度：⭐）: コミュニティパッケージを検索・インストールし、そのスキルを使用してください。
- 中級（難易度：⭐⭐）: 2つのツールと1つのスキルを含むパッケージを作成し、ローカルでテストしてください。
- 上級（難易度：⭐⭐⭐）: プライベートパッケージリポジトリをセットアップし、内部ツールパッケージを公開・インストールしてください。
