Pi Agent: Skills System

المهارة = قالب أوامر + قائمة أدوات + معلمات تكوين + أمثلة

مثال:
مهارة code_review =
  أمر ("أنت خبير مراجعة كود...") +
  أدوات (file_reader, search) +
  تكوين (temperature=0.3, max_tokens=2048)

from pi_agent import Agent

agent = Agent(name="reviewer")
result = agent.run(skill="code_review", code="def add(a,b): return a+b")

pi-agent chat --skill code_review "Review main.py"
pi-agent run --skill translate --lang ja "Translate this text"

name: api_designer
description: "REST API design expert"
version: "1.0"

system_prompt: |
  You are a REST API design expert.
  Follow these principles:
  1. Use plural nouns for resource paths
  2. Express operations with HTTP methods
  3. Return appropriate HTTP status codes
  4. Design consistent error response formats

tools:
  - file_reader
  - search

parameters:
  temperature: 0.3
  max_tokens: 4096

from pi_agent import Agent, Skill

api_skill = Skill(
    name="api_designer",
    description="REST API design expert",
    system_prompt="You are a REST API design expert following best practices",
    tools=["file_reader", "search"],
    parameters={"temperature": 0.3, "max_tokens": 4096}
)

agent = Agent(name="api_guy", skills=[api_skill])
result = agent.run(skill="api_designer", prompt="Design a blog system API")

from pi_agent import Agent, Skill

review_skill = Skill(name="code_review", tools=["file_reader"])
fix_skill = Skill(name="bug_fix", tools=["file_reader", "shell"])
test_skill = Skill(name="test_gen", tools=["file_reader", "shell"])

agent = Agent(
    name="full_stack",
    skills=[review_skill, fix_skill, test_skill]
)

review = agent.run(skill="code_review", code=source_code)
fix = agent.run(skill="bug_fix", code=source_code, issues=review)
tests = agent.run(skill="test_gen", code=fix)

name: translator
parameters:
  temperature: 0.5
  max_tokens: 4096
custom_params:
  source_lang:
    type: string
    default: "en"
  target_lang:
    type: string
    required: true
  style:
    type: string
    default: "formal"
    enum: ["formal", "casual", "technical"]

result = agent.run(
    skill="translator",
    text="Hello World",
    target_lang="ja",
    style="technical"
)

pi-agent skills list
pi-agent skills show code_review
pi-agent skills install community/web-scraper
pi-agent skills create my_skill --tools file_reader,shell