ATP Agent Skills
ATP Agent Skills 是提供給 Codex、Claude Code 與其他支援 SKILL.md 的 agent 使用的公開操作手冊。安裝後,agent 會知道 ATP 的驗證方式、統一模型名稱、API payload、非同步媒體任務與常見錯誤,不需要把上游供應商的介面寫進你的專案(project)。
開始之前#
Skills 是接上之後的那一層,不是接上本身。先把 agent 指向 Gateway,再安裝這些 Skills。
Skills 不會保存你的 API 金鑰
Skills 只有 Markdown 指引。atp- 金鑰仍應放在環境變數或密鑰管理服務,不要寫入 SKILL.md、程式碼或 git。
一行安裝#
安裝全部七個官方 Skills:
Shell
# Codex
curl -fsSL https://atptoken.ai/skills/install.sh | sh -s -- codex
# Claude Code
curl -fsSL https://atptoken.ai/skills/install.sh | sh -s -- claude
# Install for both
curl -fsSL https://atptoken.ai/skills/install.sh | sh -s -- both安裝器預設不覆寫既有檔案。更新官方版本時可明確允許替換:
Shell
curl -fsSL https://atptoken.ai/skills/install.sh | ATP_SKILLS_FORCE=1 sh -s -- codex如果你的安全規範不允許 pipe to shell,先下載、檢視再執行:
Shell
curl -fsSL https://atptoken.ai/skills/install.sh -o /tmp/install-atptoken-skills.sh
less /tmp/install-atptoken-skills.sh
sh /tmp/install-atptoken-skills.sh codexSkills 內容#
直接下載:Gateway · OpenAI · Anthropic · Gemini · Image · Video · Audio。
機器可讀的完整清單在 /skills/manifest.json。
驗證安裝#
Shell
# Codex
find "${CODEX_HOME:-$HOME/.codex}/skills" -maxdepth 2 -name SKILL.md \
-path "*/atptoken-*"
# Claude Code
find "${CLAUDE_HOME:-$HOME/.claude}/skills" -maxdepth 2 -name SKILL.md \
-path "*/atptoken-*"接著在 agent 中要求「使用 ATP 產生一張圖片」或「用 ATP 建立 Wan 影片任務」。agent 應先以同一把專案金鑰呼叫 GET https://api.atptoken.ai/v1/models,再選擇該專案已啟用的模型——也就是 把任何 coding agent 接上 ATP 講的同一個第一步。如果 agent 跳過這一步、自己寫死一個模型名,那就是要糾正的行為。
模型權限仍由專案控管
安裝 Skill 不會自動啟用模型,也不會繞過 allowed models。GET /v1/models 沒有出現的模型不能用;請先到主控台的「資源」調整專案模型。
下一步
這頁有幫助嗎?