SuperAPI AI 工具集

skill-creator

智能体与模型

查看项目

更新于 10-15 21:39

技能介绍

用途:Skill Creator 帮助为 Pi 智能体创建、审查和改进技能(skill)。技能是一个文件夹,内含必需的 SKILL.md(frontmatter 加指令),可选 scripts/(可执行代码)、references/(按需加载的文档)、assets/(输出用模板、字体、图标)。技能不是代码,而是结构化指令。Pi 实现 Agent Skills 标准,技能可跨 Pi、Claude Code 和 Anthropic API 使用。

主要能力:覆盖技能全生命周期——理解用例、规划内容、脚手架、编写 SKILL.md、校验、迭代;并提供审查模式,按触发、结构、内容质量、Pi 兼容性清单评估已有技能,以 🔴 严重、🟡 重要、🔵 次要、✅ 良好分级报告。

使用方式:先用 bash scripts/init-skill.sh <skill-name> [target-directory] 生成目录结构(默认目标为当前工作目录)。SKILL.md 的 frontmatter 中 name 为 kebab-case、小写、最长 64 字符且须与文件夹同名,不得含 claude 或 anthropic;description 必填、最长 1024 字符、不含 XML 尖括号,需写明做什么、何时用及触发短语,它是默认唯一加载的内容。正文建议少于 500 行或约 5000 词,采用工作流、任务型、参考型或能力型结构,使用祈使句、具体路径与命令,并包含常见错误处理。细节放入 references/ 按需加载,脚本可执行而不读入上下文。完成后运行 python3 scripts/validate.py <path/to/skill-folder> 校验 frontmatter、命名、描述质量、文件结构、失效引用与行数。

适用场景:需要为智能体沉淀专用工作流、领域知识或可复用脚本时。技能发现位置包括全局 ~/.pi/agent/skills/、~/.agents/skills/,项目 .pi/skills/、.agents/skills/,settings.json 的 skills 数组,CLI 的 --skill <path>,以及包内 skills/ 目录或 package.json 的 pi.skills;交互模式下注册为 /skill:name 命令。

限制:资料未提供收费、价格、平台支持范围或效果数据;技能文件夹内不应放 README.md 或多余文档,所有文档应写入 SKILL.md 或 references/。