mcpField
R
replica-deploy

replica-deploy

github.com/jakeschincariol云与 DevOps6.3k708 次安装4 周前更新
代码仓库

关于 replica-deploy

replica-deploy 是用于准备和检查仿制应用生产部署的 Skill，生成涵盖上线检查、生产服务、托管、域名、监控和可选移动端发布的清单。部署前须获得用户批准。

主要功能

  1. 01执行部署前检查
  2. 02配置生产服务
  3. 03规划托管和 DNS 记录
  4. 04设置监控与告警
  5. 05准备可选的移动端发布

适用场景

  1. 01上线前检查仿制应用
  2. 02准备生产环境配置
  3. 03连接域名并设置邮件 DNS
  4. 04验证线上应用的核心流程

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jakeschincariol/replica-skill --skill replica-deploy

安装后在 Claude Code 中输入/replica-deploy确认已加载。

附带文件preflight.md

详细介绍

replica-deploy

读取 replica/ 中的所有内容。填写本文件夹中 preflight.md 的检查清单，并写入 replica/deploy.md。

规则

  • 未经用户同意，不得上线。 展示预检结果并征求同意。
  • 由用户购买并登录。 Claude 绝不购买域名、填写银行卡信息、输入密码或粘贴有效密钥。Claude 会写明确切的 DNS 记录、环境变量名称和命令；账户相关步骤由用户完成。
  • 完成品牌替换后才能上线。 全面检查必须通过，不得例外。

第 1 步：预检

运行所有检查，并将结果粘贴到 deploy.md：

npx playwright test                                                  # replica-test
python3 ../replica-diff/parity.py replica/features.csv               # must-haves done
python3 ../replica-brand/sweep.py . --config replica/brand.json      # exit 0: clean
python3 ../replica-launch/listing.py replica/launch/listing.json     # if shipping to stores
npm run build                                                        # production build passes

（路径相对于工具包的安装位置。在 ~/.claude/skills/ 下，这些路径为 ~/.claude/skills/replica-diff/parity.py 等。）

另需手动检查：没有未解决的 S1 或 S2 级 Bug；隐私政策和条款页面已上线（列出所有数据处理方）；如果在欧盟或英国使用非必要 Cookie，则需显示 Cookie 横幅；账户删除功能正常；网站图标、标题和 OG 图片均已替换为你自己的内容。

任何检查失败都必须停止部署。说明失败项及原因。

第 2 步：生产服务

  • 为数据库创建独立的生产项目（绝不使用开发项目），开启备份，由部署流程运行迁移，不要手动运行。
  • 在托管平台设置生产环境变量，并与 .env.example 保持一致。有效密钥只能放在此处。
  • Stripe：切换到实时模式，重新创建产品和价格，添加生产环境 Webhook 端点及其签名密钥，并测试一笔真实交易后退款。
  • OAuth：将生产域名添加到每个提供商的重定向 URI 和授权来源中。需要验证的 Google 权限范围必须通过审核，否则只有测试用户可以登录。
  • 电子邮件：向服务提供商验证发件域名。

第 3 步：托管和域名

默认情况下，Next.js 使用 Vercel（其他情况使用 Netlify、Cloudflare Pages、Fly 或 Render）。连接代码仓库，以便 main 分支触发部署，并为拉取请求生成预览 URL。

用户在任意域名注册商购买域名后，设置以下记录：

记录名称值
A@托管平台的顶级域名 IP（Vercel：可在域名设置中查看）
CNAMEwww托管平台的目标地址（Vercel：cname.vercel-dns.com）
TXT@ 或子域名托管平台提供的验证值（如有要求）

在电子邮件服务提供商处设置电子邮件 DNS：SPF（TXT）、DKIM（CNAME 或 TXT）以及 DMARC 记录，初始值为 v=DMARC1; p=none; rua=mailto:you@yourdomain，报告确认无误后再收紧为 quarantine。否则，确认邮件可能会进入垃圾邮件。

选择一个规范主机名（顶级域名或 www），并将另一个重定向到它。以上托管平台会自动启用 HTTPS；请检查确认。

第 4 步：监控

设置错误跟踪（Sentry 或托管平台自带的功能）、针对首页和核心流程 API 的可用性检查、日志保留、分析（注重隐私的分析工具可以避免显示 Cookie 横幅），并向用户的电子邮件或手机发送提醒。然后亲自在正式网站上走完核心流程，并请用户在手机上操作一次。

第 5 步：移动端（如果有应用）

Expo：运行 eas build，然后运行 eas submit，提交至 TestFlight 和 Google Play 内部测试。原生应用：在 Xcode 中归档并上传至 App Store Connect；将 Gradle 包上传至 Play Console。开发者账户由用户持有（Apple 每年 $99，Google 一次性 $25）。先进行 Beta 测试，再使用 replica-launch 中的应用列表信息提交审核。

输出

在 replica/deploy.md 中记录每项检查及其结果、正式网站 URL、已设置的 DNS 记录，以及首周需关注的事项。克隆版现在已成为使用你品牌名称的应用。

评论

支持 Markdown