用途
deploy-prototype 用于生成一个小型、自包含的原型应用或工具，并通过 Vercel API 将其部署到线上。目标是交付一个“零上下文的人也能在浏览器中打开、10 秒内理解并获得价值”的页面。
主要能力
- 从记忆文件（memory/MEMORY.md）、日志（memory/logs/）、文章（output/articles/）、主题文件（memory/topics/*.md）等来源中扫描并挑选适合做成交互页面的信号。
- 对候选信号按 Leverage（交互版是否优于静态文章）、Concreteness（一句话能否说清规格）、Novelty（近 14 天是否已发布过）三项各 1-5 分评分，总分低于 9/15 则跳过构建。
- 支持通过 ${var} 传入构建简报：空值则自动从近期信号中选择；纯文本按构建简报解释；带类型前缀（如 tool:、viz:、api:、landing:）则用类型影响形态、用 slug 作为部署名称。
- 生成原型文件，默认采用单文件静态 HTML+JS，必要时使用静态 + api/ 函数或 Next.js。
- 写入部署元数据（meta.json）与 Vercel 内联部署载荷（payload.json）。
- 执行预检：文件数 ≤ 20、载荷 JSON ≤ 4MB、slug 格式校验、敏感信息与占位符扫描。
- 通过 ./secretcurl 调用 Vercel API 完成生产环境部署，并回填线上 URL。
- 可选通过 gh 将源码镜像到 GitHub（非致命，失败不影响交付）。
- 通过 ./notify 发送部署结果通知，并记录日志与原型记录。
使用方式
技能按步骤执行：读取上下文、挑选构建目标、确定形态（slug、标语、主要动作、形态）、写入文件到 .pending-deploy/files/、写入 meta.json 与 payload.json、执行预检、保存原型记录到 output/articles/prototype-${today}.md 并追加到 memory/topics/prototypes.md、调用 Vercel API 部署、发送通知、记录日志并以退出模式结束。
部署调用示例（使用 {VERCEL_TOKEN} 占位符，由 ./secretcurl 内部替换）：
HTTP=$(./secretcurl -sS -o .pending-deploy/deploy-resp.json -w '%{http_code}'
-X POST "https://api.vercel.com/v13/deployments"
-H "Authorization: Bearer {VERCEL_TOKEN}"
-H "Content-Type: application/json"
--data @.pending-deploy/payload.json)
可选 GitHub 源码镜像：
if [ -n "${GH_GLOBAL:-}" ]; then
( cd .pending-deploy/files && git init -q && git add -A
&& git -c user.name=aeon -c user.email=aeon@users.noreply.github.com commit -qm "prototype: <slug>"
&& gh repo create "<slug>" --public --source=. --push )
|| echo "::notice::source mirror skipped (non-fatal)"
fi
适用场景
- 将文章、日志或主题中的发现、数据集、结论转化为可交互页面。
- 快速发布小型工具、可视化、API 或落地页原型。
- 需要从近期信号中自动挑选值得做成交互内容并即时上线的场景。
限制
- 原型必须自包含、冷访问 1 秒内加载、移动优先、可分享、使用真实内容、无密钥。
- 文件数上限 20，载荷 JSON 上限 4MB。
- 若 VERCEL_TOKEN 未设置，构建仍完成但跳过部署，退出 DEPLOY_PROTOTYPE_NO_TOKEN。
- 若 Vercel API 调用失败，保留 .pending-deploy/ 供重试，退出 DEPLOY_PROTOTYPE_DEPLOY_FAILED，且不会将记录标记为 Live。
- 若预检失败且无法自动修复，退出 DEPLOY_PROTOTYPE_VALIDATION_FAILED。
- 若没有候选达到质量阈值，退出 DEPLOY_PROTOTYPE_EMPTY。
- 环境变量 VERCEL_TOKEN 与 GH_GLOBAL 均为可选，缺失时技能会优雅降级。
- 不得在部署文件中嵌入任何密钥或令牌。