| name | vibe-coding-production |
| description | 把验证过的 Vibe Coding demo，做成能长期运行、给别人用的正式系统。 当用户说"想上线"、"怎么部署"、"这个 demo 想做成正式的"、"要注意安全吗"、"怎么测试我的项目"， 或者准备把代码开源/公开发布时，使用此 Skill。涵盖开发规范、安全基线、部署、手动验收、文档要求。 这是 vibe-coding-kit 套件里负责"从 demo 到上线"的 Skill。 即使用户没明说"上线"二字，只要 ta 准备把一个能跑的东西交给别人用、或放到服务器/公网上，就应主动用本 Skill。 |
上线准备：从 demo 到正式系统
这是 vibe-coding-kit 里负责"上线"的 Skill。只想验证想法的人用不到它——决定把项目做成能长期运行、给别人用的正式系统时，再来。
前置：先用 vibe-coding-requirements 说清需求、vibe-coding-architecture 选好技术。开发全程配合 vibe-coding-survival 避坑。
每个环节都配了直接发给 AI 的话术和你用来验收的标准——你不需要会写代码，只需会问、会检查。
准入检查（开始本阶段前必做）
本 skill 是流程第三阶段 S3·上线准备。开始前：
- 读
docs/进度账本.md。 确认 S2 架构选型出口门已过（技术栈已选定），且用户明确确认"要做成正式系统、给别人用"。只想跑 demo 的人不进 S3。
- 任一条不满足就别开始：需求/选型没定完，先回 S1/S2；用户只想验证想法，就停在 demo，别硬上线。
- 本阶段步骤对应账本：S3.1 开发规范 → S3.2 安全基线 → S3.3 部署 → S3.4 测试验收 →（
可选）S3.5 文档。每过一步回写账本。
一、开发规范（对应 S3.1）
把下面四段整理成一份"规范说明"，每次让 AI 写代码时贴上，确保风格一致、日后好维护。
1.1 Git 分支策略（最简版）
main 分支 ← 永远是能稳定部署的版本
└── dev 分支 ← 日常开发，AI 写的代码先合到这
└── feat/xxx 分支 ← 每个新功能开一个，做完合回 dev
"每次写新功能时，顺便告诉我：① 该建什么分支名 ② commit message 写什么。"
（完全不用 git 也没关系，但至少要做 vibe-coding-survival 里的"保住能用的版本"——那是 git 的朴素替代。）
1.2 日志规范
"所有关键操作必须打日志，格式统一为 [时间] [级别] [模块] 内容。级别分三级：INFO（正常流程）、WARN（异常但能自动恢复）、ERROR（需我人工处理）。至少记录：请求进入、鉴权结果、数据库操作、外部调用、返回结果。卡密、密码等敏感信息脱敏，只显示前 4 位和后 4 位，中间用 *** 代替。"
1.3 错误处理规范
"所有可能出错的地方都要显式处理。错误信息必须含三要素：① 哪里出错（模块/函数名）② 为什么出错（具体原因）③ 建议怎么解决。绝不要把错误悄悄吞掉（catch 了却什么都不做）。"
1.4 代码风格
"代码注释用中文。每个函数上方注释说明：这函数做什么、输入什么、输出什么。变量名和函数名用英文，但要见名知意。"
二、安全基线（对应 S3.2）
▸ 过门：8 条逐条确认（标"已做"或"不适用"）→ 账本 S3.2 标 ✅。涉及钱/别人隐私的，触发 survival 红线、提示找真人。
逐条把要求提给 AI，再逐条确认它做没做到。
| # | 安全要求 | 对 AI 说的话 |
|---|
| 1 | 鉴权 | "所有接口都要验证身份，没通过的直接拒绝，返回 401。" |
| 2 | 防暴力破解 | "同一 IP 连续失败 N 次后，锁定 M 分钟。" |
| 3 | 输入校验 | "所有用户输入都要校验和清理，防止注入攻击。" |
| 4 | HTTPS | "生产环境必须用 HTTPS。" |
| 5 | 敏感信息保护 | "密钥、密码用环境变量或配置文件读取，绝不写死在代码里。" |
| 6 | 日志脱敏 | "敏感数据在日志里脱敏。" |
| 7 | 最小权限 | "数据库连接用最小必要权限，不要用 root。" |
| 8 | 错误信息 | "对外返回的错误信息不要暴露内部实现细节。" |
开源专属提醒： 把代码公开（push 到 GitHub 等）之前，务必再确认一遍：代码里、配置里、提交历史里，没有任何密钥、密码、token。一旦推到公开仓库，就当全世界都看到了——即使事后删除也来不及，必须立刻作废并更换那个密钥。最稳妥的做法是把密钥放进一个单独的配置文件，并让 AI 帮你把它加进 .gitignore（让 git 永远忽略它）。
注意红线： 涉及真实收付款、存别人的个人信息等，别独自硬上——见 vibe-coding-survival 的「红线」。
三、部署策略（对应 S3.3）
▸ 过门：部署步骤可执行、亲手走通一遍 → 账本 S3.3 标 ✅。
"告诉我完整的部署步骤，每步用一句话说明为什么需要它。包括：① 服务器要装哪些依赖（运行环境、数据库等）② 文件放哪个目录 ③ 配置文件放哪 ④ 怎么启动服务 ⑤ 怎么设置开机自启 ⑥ 怎么看日志 ⑦ 怎么更新版本（停旧启新的流程）。"
输出物： 部署步骤清单。
四、测试验收（对应 S3.4）
▸ 过门：验收清单是 checkbox 格式、每条可验证 → 账本 S3.4 标 ✅。
你不用写测试代码，但要有一份能逐条手动验证的清单。
"给我一份功能验收清单，列出所有场景，我逐条手动验证。包括：① 正常流程的每个步骤 ② 异常情况（无效输入、超时、资源不足）③ 边界情况（空值、极限值）。"
每一条都要你亲手跑通才算过，不是 AI 说过就过（参见 vibe-coding-survival 的"让 AI 证明给你看"）。
输出物： 功能验收清单（可逐条打勾的 Checklist）。
五、文档要求（对应 S3.5 ·可选）
▸ 过门：交付文档齐全 → 账本 S3.5 标 ✅；个人小项目可精简，跳过须留痕。
让 AI 每次写完代码都配套产出说明，免得过几天就忘了哪是哪。
"每次代码修改完成后，给我一份简短说明：① 新增/修改了哪些文件 ② 每个文件做了什么（一句话）③ 怎么验证功能正常 ④ 有什么要注意的（配置改动、新增依赖等）。"
把这些汇总进你的「项目说明书」（模板见仓库 examples/项目说明书-模板.md）。
上线前最终检查清单
出口门（声称 S3 完成前必过）
以下约束来自项目治理配置 harness.json（workflow.stages[S3].exit_gate）和 CLAUDE.md。
在声称"上线准备完成"之前，你必须逐条确认。
全过之后，最后一步：在 docs/进度账本.md 把 S3 标记为「已完成、出口门 ✓」。这是流水线最后一阶段，到此全流程走完。
必须产出的内容
硬性检查
自检完成声明
全部通过后声明：
"✅ S3 出口门通过：安全清单已逐条确认，验收清单可逐条打勾验证，账本 S3 已标完成。全流程走完，可用 vibe-coding-harness 做最终质检。"
