跳转到主要内容
在仓库中添加一个 SKILL.md,让编程智能体按项目期望的方式调用 Phaseo:相同的基础 URL、密钥变量、端点、批准的模型和日志记录。完成后,你会安装好公开的 Phaseo 技能,在其之上有一个项目技能,以及一个该技能指向的共享客户端模块。 把下面的模型 ID 和预设名称换成你自己的之后,这个技能和模块即可用于生产环境。
1

安装公开的 Phaseo 技能

公开技能涵盖 Gateway、SDK、预设、路由和迁移。从 phaseo.app/docs 安装它们:
把 --agent 改成你的团队使用的智能体。你自己的 SKILL.md 中只保留项目特有的规则。
2

安装 SDK

3

添加一个共享客户端

相比庞大的封装,智能体更能稳定地复用一个小而直观的辅助模块。把客户端放在一个模块里,并在各处导入它:
src/lib/phaseo.ts
你使用的每个接口(例如文本生成、embeddings、图像生成或异步视频)只保留一条调用路径。
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 和示例展示了这些约定在各个工具中的用法。
最后修改于 2026年11月5日