官方 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.