Pi Agent: Skills 技能系统

技能 = 提示词模板 + 工具列表 + 配置参数 + 示例

示例：
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 "审查 main.py"
pi-agent run --skill translate --lang ja "翻译这段文字"

name: api_designer
description: "REST API 设计专家"
version: "1.0"

system_prompt: |
  你是一个 REST API 设计专家。
  遵循以下原则：
  1. 使用名词复数作为资源路径
  2. 用 HTTP 方法表达操作语义
  3. 返回合适的 HTTP 状态码
  4. 设计一致的错误响应格式

tools:
  - file_reader
  - search

parameters:
  temperature: 0.3
  max_tokens: 4096

examples:
  - input: "设计用户管理 API"
    output: |
      POST /users - 创建用户
      GET /users - 获取用户列表
      GET /users/{id} - 获取单个用户
      PUT /users/{id} - 更新用户
      DELETE /users/{id} - 删除用户

from pi_agent import Agent, Skill

api_skill = Skill(
    name="api_designer",
    description="REST API 设计专家",
    system_prompt="你是 REST API 设计专家，遵循最佳实践设计 API",
    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="设计一个博客系统的 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"
    description: "源语言"
  target_lang:
    type: string
    required: true
    description: "目标语言"
  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