用途：在 Netlify 基础设施上远程运行 AI 编码智能体（Claude、Codex、Gemini），对站点连接的仓库执行开发任务，例如代码审查、安全审计、性能优化、SEO 与无障碍审计、测试生成、文档编写等。
前提：站点需已链接 Netlify 项目（netlify link 或 netlify init），或通过 --project <name> 直接指定项目；需安装并认证 Netlify CLI。任务消耗套餐额度，额度不足或达到 AI 使用上限时 netlify agents:create 会被阻止，这属于账户/套餐状态问题，应告知用户而非绕过。
主要能力与用法：仅通过文档化的 netlify agents:* 命令交互，不得用 curl 调 API、netlify api 或读取本地令牌绕过。创建任务：netlify agents:create "<prompt>" -a <agent>，可用 -p 指定提示、-b 指定基础分支、-m 指定模型、--project 指定项目、--json 输出 JSON。任务异步执行，创建后立即返回，无回调，需用 netlify agents:show <task-id> 或 netlify agents:list 轮询，状态为 new、running、done、error、cancelled。停止任务用 netlify agents:stop <task-id>。所有命令按项目作用域，无团队级列表命令。
运行特性：任务在 Netlify 远程基础设施上运行，只看到已推送的代码，看不到未提交或未推送的本地改动；默认基于生产分支，-b 设置起始分支而非结果写入位置；结果推送到新分支并生成 Deploy Preview，不覆盖原分支。
限制与注意：作为智能体使用时，运行 agents:create 前必须获得用户明确许可，且应给出具体命令、选定单一 agent 及理由；任务无会话上下文，需写完整独立提示；无完成通知，须轮询确认状态后再依据结果。若文档化命令失败，应报告确切错误并停止，不得发明未文档化途径。跨客户端可用于 GitHub Copilot、Claude Code、Codex，Codex 需同步到 $CODEX_HOME/skills/netlify-agent-runner 并重启。无需 MCP，可用本地指令与工具作为回退。