SuperAPI AI 工具集

app-lifecycle

编程与开发

查看项目

更新于 10-30 06:48

技能介绍

该技能描述了一个 SaaS 产品从想法到生产环境的详细阶段路径,每个阶段都规定了产出物和完成标准(done-when),但不规定具体构建方法——具体做法由各阶段指向的其它技能提供。其核心目标是让代理知道当前处于哪个阶段、该构建什么、不该构建什么、完成意味着什么,以及下一步建议是什么。

用途:

  • 为 SaaS 产品开发提供分阶段的结构化路线图。
  • 帮助产品负责人(owner)和编码代理对齐当前阶段与下一步行动。
  • 定义每个阶段的产出物和完成条件,避免过早构建或遗漏关键步骤。

主要能力:

  • 阶段划分:从阶段 0(简要说明,可选)到阶段 11(下一步建议),覆盖原型、设计、示例数据屏幕、环境搭建、首个真实切片、浏览器验证、发布、前台/角色/套餐、上线、后续发布、能力提议等。
  • 每个阶段明确产出物和完成标准,例如阶段 3 要求负责人在手机和桌面宽度下点击每个屏幕状态;阶段 5 要求不同工作区的两名成员无法看到对方数据等。
  • 支持产品形态声明(工作区模型、计费、匿名公开、嵌入式代理、成员主页路由),并在简要说明阶段声明,后续阶段据此跳过不适用部分。
  • 提供默认选择清单(如每个工作区都是组织、组织管理使用身份提供商的模态框、定价使用计费提供商的表格等),并说明重新开启的条件。
  • 提供能力提议清单,在触发条件满足时由代理提议,例如首次部署后提议正常运行时间监控、首次陌生人注册前提议法律页面等。
  • 定义跨阶段持续要求:测试和文档随变更落地、负责人预览、独立审查、发布时提议安全与性能审计等。
  • 提供文档模板:产品部分、简要说明、计划、决策日志、策略(可选)、阶段简要说明等。

使用方式:

  • 产品负责人可通过输入 /product:start-here(Codex: $product:start-here)获取八步生命周期说明。
  • 阶段 0-1 可选,若已有接受的提案和原型则整体跳过。
  • 计划状态缺失或过期时,当前阶段是第一个完成标准不成立的阶段,需对照代码、部署和门禁检查,而非依赖交接报告。
  • 各阶段深入说明(做好该阶段的样子、负责人的部分、陷阱、承载具体做法的技能)见 references/stages.md。

适用场景:

  • 使用编码代理开发 SaaS 产品,尤其是基于 Next.js(App Router)+ Supabase Postgres + Clerk + Netlify 技术栈,使用 Vitest 和 Playwright 测试的场景。
  • 需要明确产品开发阶段、完成标准和下一步行动的产品团队。
  • 希望将产品负责人决策、代理构建与独立审查分离的协作流程。

限制:

  • 阶段顺序、完成标准和跨阶段规则是通用的,但具体供应商和栈相关部分需按原则替换为自己栈的等价物。
  • 默认选择不是产品已构建的声明,产品需在构建时记录实际连接的内容。
  • 阶段 0-1 为可选;前台之后没有默认阶段,后续阶段内容取决于产品本身。
  • 计费在个人形态下尚未构建和验证,个人产品在有人写出并验证该配方前应声明无计费。
  • 部分能力(如代理 WAF + 源站封存)在选择接受代理的主机前被阻止。
  • 未提供具体价格、收费模式或平台依赖信息。