用途：帮助在 Netlify 上配置项目，主要通过仓库根目录的 netlify.toml，以及发布目录中的 _headers、_redirects 纯文本文件。netlify.toml 的设置与 Netlify UI 冲突时以文件为准；_headers 和 _redirects 先于 netlify.toml 规则处理。
主要能力：配置 [build] 的 base、publish、command 与 [build.environment]；用 [context.production]、[context.deploy-preview]、[context.branch-deploy]、[context.dev] 及具体分支名区分部署上下文，优先级由宽到窄。配置 [functions] 目录、node_bundler（如 esbuild）、external_node_modules、included_files。定义 [[redirects]] 与 [[headers]]，支持状态码、force、query、conditions（Language、Country、Role）、splat 与代理重写（status 200）。支持签名代理重定向（仅 netlify.toml，signed 字段）。
使用方式：环境变量用 CLI 或 UI 设置，例如 netlify env:set MY_KEY value --secret、netlify env:import .env、netlify env:list --plain --context production > .env、netlify env:unset MY_KEY。忽略构建可写 ignore 命令，如 git diff --quiet $CACHED_COMMIT_REF $COMMIT_REF packages/blog。
限制：netlify.toml 中声明的环境变量在函数或边缘函数运行时不可用，读取为 undefined，仅具 Builds 与 Post processing 作用域；运行时变量需在 UI 或 netlify env:set 设置。客户端前缀变量（VITE_、NEXT_PUBLIC_、PUBLIC_ 等）会内联进客户端包，不能放密钥。.env 不被 Netlify 构建系统读取。[[redirects]] 与 [[headers]] 是全局的，不能按分支或上下文限定。代理重写超时 26 秒，不支持 HTTP 307。自定义头只对 Netlify 自身存储的文件生效。密钥变量为只写、不可读回，且不能有 post processing 作用域。部分能力（共享变量、Basic-Auth、角色重定向、敏感变量策略）限 Pro/Enterprise。
适用场景：Netlify 站点构建与部署配置、SPA 回退、代理与重写、响应头与缓存控制、环境变量与密钥管理、monorepo 子目录构建。跨客户端使用时，Codex 可同步到 $CODEX_HOME/skills/netlify-config 并重启；无 MCP 时依赖本地说明与直接验证。