这是公网只读快照,批注存不进来——要写批注请开本机链接 http://localhost:8010/_root/docs/prd/deployment/deployment-PRD.html?annotate=1

网站发布总闸

owner:session prd-deployment-skill(2026-08-30) 迭代话题:deployment-skill-prd 最后动:2026-08-30

方向

Yummy Future 的"发布/上线"不是一个人的事:Jack 这一侧(由 Claude 经手)走四条路——临时页发到 Cloudflare、给同事的活服务开隧道、官网 yummy-future.com 上生产、门店集群拉新版本; **Hao 和 Rohan 两人还共同运维着整块门店基础设施**(五条门店隧道、店内应用、设备远程升级、 GCP 服务器、订单/收款接口),那是公司真正收钱跑店的面,此前完全不在任何技能的地图上—— 08-29 门禁事故正是 Claude 未经他们俩点头动了这块面。 这份 PRD 把 cloudflare-publish 扩建成发布总闸:Claude 侧四条车道由它机械分流并核对门禁; Hao + Rohan 的面画进同一张图、立死"写动作必须他们点头"的规矩——总闸不指挥他们怎么干活, 只保证任何会话看一张图就知道每块面归谁、动之前要过谁。不新建技能,只扩建这一个。

deployment 这个域目前只有这一份主 PRD,还没有子 PRD——地图留空,等真的拆出子 PRD 时由脚本生成。

建什么

输入:一句"把 X 发布出去"的请求(一张临时页 / 一个活服务 / 官网 / 门店集群)。
输出

什么算好:任何人拿着这份 SKILL.md,不用问人就能判断"我这次发布该敲哪条命令、会被哪几道门拦下来"—— 官网上生产不会再有人手滑敲裸命令。

四条车道(分流图)

三道闸各是什么(建的人照这里找,不用猜): cf_write_gate = 全局钩子 ~/.claude/hooks/cf_write_gate.py(不在本仓库里),拦 Cloudflare 生产写命令,放行手续写在它的拦截消息里; 访问名单双签 = 任何"谁能访问什么"的名单/门禁变更,先把完整名单摆出来, Jack 和 hao@yummyfuture.wiki 两人都点头才许执行,变更后两头验收(该拦的拦住、该进的能进), 正本定义在 ~/.claude/yf-production-assets.md 死规矩第 1 条; ui-test-gate = 同名技能的三道锁(用例签字→自动化跑绿→真浏览器过一遍)。

① 静态页 → 公网固定地址

入口publish.py worker
引擎:Cloudflare Workers 自定义域
:cf_write_gate

② 活服务 → 隧道 + 门禁

入口publish.py up
引擎:cloudflared 隧道 + Access
:cf_write_gate、访问名单双签

③ 官网 → 生产

入口scripts/deploy-netlify.sh
引擎:Netlify
:脚本自带对账+两道冒烟;改了 UI 再加 ui-test-gate

④ 门店集群 → 新版本

入口sshops up BOX
引擎:SSH/Tailscale,release tag
:remote-server-ops 自己的门(本闸只负责把请求分流到它)

⑤ 门店基础设施(Hao + Rohan 共管的面)

范围:五条门店隧道(Palo Alto / Champaign×3 / 济南)、店内应用 (店长台/电视/出品/人工台)、设备远程升级(Mender/机器人/quic)、GCP 服务器、订单/收款接口
入口:他们俩自己的流程——不是本闸的命令,本闸不指挥
:Claude 只读探测随便做;任何写动作必须 Hao 或 Rohan 点头; 涉及"谁能访问什么"再叠名单双签

焦点读:眼睛先落在这五个盒子上,认出要动的东西属于哪一块——前四条照那格的入口命令做, 第五块先去找 Hao/Rohan;卡在哪道门被拦下来,就是本该被拦下来,不是绕过去的理由。

功能 → 检查

#功能怎么算过
F1分流表写进 SKILL.md四条车道的关键词都能在 SKILL.md 里搜到
F2官网上生产道被收编SKILL.md 明确点名唯一入口,并点名裸命令是违规
F3三道闸接线写清楚cf_write_gate、双签、ui-test-gate 三个词都能在 SKILL.md 里搜到
F4跟四个邻居技能互相点名边界双方 SKILL.md 里都提到对方名字
F5重扫过闸,没有未声明的重叠重新跑技能库扫描,发布域一条未声明 OVERLAP 都没有
F6两道打包硬门 + 重新打包两个验证脚本都是 exit 0
F7Hao + Rohan 的面写进 SKILL.md他们俩的名字、门店基础设施清单、"写动作要他们点头"的规矩都能在 SKILL.md 里搜到

不碰