Netlify

核心功能与定位

Netlify CLI 技能提供了一套完整的静态站点 DevOps 自动化方案，核心能力覆盖三大场景：

1. 站点生命周期管理

• 通过 netlify sites:create 程序化创建 Netlify 站点，支持指定 team/account slug 实现多团队协作
• netlify link 建立本地目录与远程站点的映射关系，解决 monorepo 多站点关联问题

2. CI/CD 自动化引擎

• --with-ci 参数一键初始化持续部署流程
• netlify init 对接 GitHub 仓库，自动配置 Webhook 与构建触发器
• 支持 netlify.toml 声明式配置，将构建命令、环境变量、发布目录版本化

3. Monorepo 专业化支持

• 推荐模式：每个子域名对应独立 Netlify 站点，通过 base directory 隔离构建上下文
• 子目录内嵌 netlify.toml 实现配置自治，典型 Hugo 场景示例：

  [build]
    command = "hugo --minify"
    publish = "public"
  [build.environment]
    HUGO_VERSION = "0.155.1"

显著优势

• 声明式配置优先：netlify.toml 将基础设施配置纳入版本控制，符合 GitOps 理念
• 非交互式友好：支持 NETLIFY_AUTH_TOKEN 环境变量注入，适配 CI/CD 流水线
• 环境变量管理：netlify env:set 实现敏感配置与代码分离
• 快速回滚机制：netlify deploy --prod 支持原子化发布与即时回退

潜在局限与风险

• 平台锁定效应：深度绑定 Netlify 生态，迁移至 Vercel/Cloudflare Pages 需重构配置
• 并发构建限制：免费/低阶套餐存在并行构建数上限，大规模 monorepo 可能队列阻塞
• 敏感信息泄露：netlify env:list 以明文输出环境变量，日志中暴露 token 风险需配合 NETLIFY_AUTH_TOKEN 使用
• 交互式流程脆弱性：netlify init 的 GitHub OAuth 流程在 headless 环境可能中断

适用人群

• 技术团队运维人员、全栈开发者
• 管理多品牌/多地区站点的 Hugo/静态站点开发者
• 追求 "git push 即部署" 极简工作流的效率导向用户

安全风险提示

• Token 管理：NETLIFY_AUTH_TOKEN 具备站点创建与部署权限，泄露可导致恶意站点劫持
• 权限边界：--account-slug 若配置错误可能将站点创建至非预期团队
• 构建沙箱逃逸：自定义 command 字段若引入未审计脚本，存在供应链攻击面

核心功能

该 Skill 是 Netlify CLI 的官方封装工具，专注解决 Monorepo 多站点部署 场景：支持在单一代码库中管理多个独立域名站点（如 sites/domain-a.com、sites/domain-b.com），每个子目录可独立配置构建流程与部署策略。

典型用法

1. 快速创建站点：netlify sites:create --name <site> --with-ci
2. 链接本地目录：netlify link 建立项目关联
3. 启用 CI/CD：netlify init 连接 GitHub 仓库
4. 环境变量管理：netlify env:set KEY value 配置站点级变量
5. Hugo 专项优化：内置脚本自动生成子目录 netlify.toml，预置 Hugo 版本与构建命令

显著优点

• Monorepo 原生支持：每个子站点独立配置，避免根目录配置冲突
• 非交互式友好：支持 NETLIFY_AUTH_TOKEN 环境变量注入，适配自动化流水线
• 安全实践规范：无硬编码凭证，认证信息严格通过环境变量传递
• 代码质量高：Bash 脚本采用 set -euo pipefail 健壮模式，含完整参数校验

潜在局限

• 依赖系统级 CLI：需预装官方 netlify-cli，版本兼容性由用户维护
• 路径验证可加强：当前目录参数未完全规范化（存在 .. 遍历低风险）
• T3 来源级别：社区维护项目，非官方背书

适合人群

• 使用 Hugo 构建静态站点的开发者
• 需要统一管理多品牌/多域名站点的技术团队
• 追求 Git 工作流与自动化部署的 DevOps 实践者

常规风险

• 站点名称参数未严格过滤特殊字符（Netlify CLI 自身有校验层）
• 依赖外部工具版本，建议锁定 netlify-cli 最低版本