SKILL.md,让编程智能体按项目期望的方式调用 Phaseo:相同的基础 URL、密钥变量、端点、批准的模型和日志记录。完成后,你会安装好公开的 Phaseo 技能,在其之上有一个项目技能,以及一个该技能指向的共享客户端模块。
把下面的模型 ID 和预设名称换成你自己的之后,这个技能和模块即可用于生产环境。
1
安装公开的 Phaseo 技能
公开技能涵盖 Gateway、SDK、预设、路由和迁移。从 把
phaseo.app/docs 安装它们:--agent 改成你的团队使用的智能体。你自己的 SKILL.md 中只保留项目特有的规则。2
安装 SDK
3
添加一个共享客户端
相比庞大的封装,智能体更能稳定地复用一个小而直观的辅助模块。把客户端放在一个模块里,并在各处导入它:你使用的每个接口(例如文本生成、embeddings、图像生成或异步视频)只保留一条调用路径。
src/lib/phaseo.ts
4
编写项目技能
在仓库根目录或你的智能体读取的技能文件夹中创建
SKILL.md(例如 .agents/skills/phaseo-project/SKILL.md)。智能体通过 frontmatter 中的 name 和 description 来决定何时加载该技能:SKILL.md
检查是否成功
让你的智能体添加一个小的 Phaseo 功能,例如“用 Phaseo 总结一个工单”。改动应当导入src/lib/phaseo.ts、读取 PHASEO_API_KEY、使用批准的模型或预设,并记录响应 ID。如果没有做到,可能是技能的 description 与请求不匹配:请写上你的团队常用的任务用词。
技能里该写什么
只回答最耗费智能体时间的问题,其他一概不写:
Codex、Vercel AI SDK 和示例展示了这些约定在各个工具中的用法。