Claude Code 透過 API 更新中台

Claude Code 可以讀取本機 skill 與 agent 設定，依 API 規格提交到 Agenta。它是操作工具；金鑰對應的專案與權限決定它能修改什麼。

準備

1. 在沙盒建立測試專案及 API Key。
2. 只把金鑰存入本機環境變數或憑證管理工具。
3. 確認目標是 makalot-agent.onlymake.ai。
4. 先讀取目前版本與 schema，再建立修改內容。

寫入介面

動作	API 路徑，前綴為 /api
建立 skill	POST /skills/
提交 skill 新版本	POST /skills/{skill_id}/revisions/commit
讀取 agent schema	GET /workflows/catalog/types/agent-template
提交 agent 設定版本	POST /workflows/revisions/commit

Agent 設定存在 workflow revision 的 data.parameters.agent，包含工作指示、模型、工具及 skills。請依部署版本的 OpenAPI schema 建立 payload，不要把 SKILL.md 原始文字直接當成任意 endpoint 的 JSON。

請讀取這個 skill 資料夾，確認附件與相對路徑。
先讀取 Makalot 沙盒上對應 skill 的目前版本，整理修改差異。
提交新版本時帶 base_revision_id，回報新的版本識別碼。
不要自動更換部門正式使用的 agent 引用。

本次提供 API 操作說明與練習素材，沒有在每位同仁的 Claude Code 安裝自動同步工具。第一階段也可以直接用介面匯入。

參考：Skill 版本 API、Agent 設定。