第五部分,Skills、模板与 Packages

创建与使用 Skills

按照 Agent Skills 标准组织 SKILL.md、脚本与参考资料,并控制发现路径和按需加载。

Skill 的目录与结构

Pi 从全局和项目 Skills 目录发现能力,也能使用其他 harness 的 .agents/skills。每个 Skill 以 SKILL.md 为入口,可附带脚本、参考资料和资源。

description 决定模型是否选择该 Skill。它要具体说明适用任务,不要只写提升质量之类的泛化目标。

markdown
---
name: release-check
description: 发布前检查 Node.js 项目的测试、构建、版本和敏感文件。
---

# Release check

1. 检查 Git 状态。
2. 运行测试和构建。
3. 扫描密钥与未跟踪产物。
4. 输出发布证据。

调用与验证

Skill 可由模型按需加载,也可用 /skill:name 显式调用。运行 /reload 后重新发现修改。

使用正例和反例测试触发,检查脚本权限和外部依赖,并为高风险步骤保留人工批准。

官方资料

本页由 xueai 根据 Pi 官方资料用中文重新组织和讲解。Pi 更新频繁,命令、包名和接口以官方最新文档为准。

Pi 源代码和官方文档采用 MIT License。Copyright (c) 2025 Mario Zechner。本站保留原版权与许可声明,完整文本见 MIT License