SuperAPI AI 工具集

full-stack-playbook

编程与开发

查看项目

更新于 10-15 21:40

技能介绍

用途:full-stack-playbook 用于指导全栈 Web 应用任务的执行,适用于 CRUD 应用、仪表盘、电商站点等具有明确前端与后端分层的项目。

主要能力:

  1. 里程碑策略采用垂直切片,而非水平分层。好的里程碑如 user-auth、product-catalog、checkout,每个都应让应用处于可测试、用户可完成完整流程的状态;差的里程碑如 all-api-endpoints、frontend-pages,因无法独立测试而不推荐。
  2. 先建立 walking skeleton:用最薄实现覆盖全部用户可见面,包括所有计划中的 UI 页面(可为占位)、API 端点(可返回 mock 数据)、CLI 命令(可为 no-op)、基础路由与导航。骨架里程碑应排在最前。
  3. 定义两类 worker:frontend-worker 实现 UI,先写组件/集成测试,并用 agent-browser CLI 做人工浏览器验证,检查布局对齐、z-index、溢出裁剪、间距、缺失状态(hover/focus/disabled/loading/empty/error);backend-worker 实现 API 与服务,先写 API 测试,并实际调用端点验证行为。
  4. 质量执行流程:编排器按里程碑创建实现特性,worker 以 TDD 加人工验证构建,里程碑完成后注入 work-scrutiny-validator 校验交接与 diff 并重跑测试,再决定用户测试需求,由 user-testing 通过浏览器验证用户流程,失败则生成修复特性,循环直至里程碑通过。

使用方式:按手册组织里程碑与特性,遵循各 worker 的工作程序与交接要求,使用 EndFeatureRun 工具提交结构化交接,包含 whatWasImplemented、verification、tests、discoveredIssues 等字段。

适用场景:需要前后端协作的全栈 Web 应用开发任务。

限制与常见陷阱:避免只做后端不做前端、跳过骨架、特性过大、遗漏错误状态、不测试跨特性交互、缺少持久测试基础设施。资料未提供具体安装命令、收费或平台信息。