Pi Agent: Package Management

الحزمة مقابل الامتداد مقابل المهارة
├── المهارة    → قدرة واحدة (مثل code_review)
├── الامتداد → إضافة (أدوات + مهارات + خطافات)
└── الحزمة  → ناقل توزيع (امتدادات + مهارات + قوالب متعددة)

pi-agent pkg search code-review
pi-agent pkg search --category devops
pi-agent pkg search --author alice

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

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

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

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

رئيسي.فرعي.تصحيح
1.0.0 -> 1.0.1 -> 1.1.0 -> 2.0.0

رئيسي: تغييرات API غير متوافقة
فرعي: ميزات جديدة متوافقة مع الإصدارات السابقة
تصحيح: إصلاحات أخطاء متوافقة مع الإصدارات السابقة

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

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

pi-agent pkg search --repo official

package_repos:
  - name: official
    url: "https://pkg.pi-agent.dev"
  - name: company
    url: "https://pkg.internal.company.com"
    auth: token