官方 AI Skill

典型工作流程

• 建立新的 intake Form,並在其 Field 完成設定前保持 disabled。
• 在 Key 的 scope 內調整表單欄位,例如新增或重新命名欄位。
• 讀取獲授權 Forms 的未讀 Submissions。
• 查看、編輯、validate 並 publish Form Workflow。
• 執行 Workflow dry test，並解釋各 Step 的結果。
• 檢視失敗的 Workflow Runs，經確認後重試符合條件的工作。

Skill 的 runtime 行為

• 開始工作前會呼叫 capabilities()，並遵守 Key 的 scopes、Form grants、write state 與 rate limits。
• 敏感變更前會先讀取目前狀態；啟用 Form、破壞性操作，以及 Workflow test、publish、restore 與 retry 都需要精確且最新的確認。
• Workflow dry run 不會送出真實 delivery 訊息；其中的 AI Steps 執行時仍會消耗 Compute Points。
• Codex、Claude Code、OpenCode 與 Pi 使用同一份已驗證 Skill bundle；目前未驗證其他 Agent runtimes。

先讀取,再確認

啟用表單、刪除資源與大量 mark-read 絕不會被靜默執行。Skill 會先讀取狀態,再要求明確且精確的確認才執行變更。

安全邊界

• SUBMETO_API_KEY 環境變數只能設定在 Skill 的 server-side 執行環境。
• 絕不將 API Key 貼進聊天、source control、瀏覽器或 mobile 產物。Key 外洩時,請建立替代 Key 並撤銷舊 Key。
• Skill 是 Public API 的受限 wrapper — 無法繞過 scope、Form grant 或確認機制。

與 Public API 的關係

Skill 透過 Public API 之上的 typed client wrapper 與 Submeto 溝通。你的 API Key 需具備正確的 scope 與 Form grant,且 Public API 的能力檢查、分頁上限與確認規則全部適用。

交給你的 Agent 安裝

選擇 Agent 並將 installation prompt 複製到 session。Agent 會自行下載、驗證、安裝與檢查官方 Skill，接著引導你設定 API Key，全程不要求你在聊天中公開 Key。

Install or update the official Submeto Public API Skill for Codex by following https://submeto.com/downloads/submeto-public-api-skill-install.md.

Complete the manifest lookup, immutable archive download, SHA-256 verification, user-level installation, and bundled validation yourself. Do not modify unrelated files. If an existing installation would be replaced, compare versions and ask before replacing it.

After installation, guide me to enable Public API myself in Submeto Dashboard if it is disabled, then help me create a least-privilege Public API Key and configure it as SUBMETO_API_KEY in the runtime's server-side environment. Do not accept the risk notice or call the session-only activation endpoint for me. Never ask me to paste, display, or echo the key in chat, and never store it in a repository. Finally, explain any reload or restart needed and verify the connection through capabilities(). Stop if any download, checksum, archive, or validation check fails.