SuperAPI AI 工具集

build

编程与开发

查看项目

更新于 10-16 02:13

技能介绍

用途

该技能用于指导用户借助 AI 编程工具构建产品功能,尤其适合非技术背景的独立创始人。它覆盖从工具选择、规格编写、提示词撰写到测试、反馈和迭代的完整构建流程。

主要能力

工具选择

  • 从零开始?→ Lovable(最快 MVP)
  • 已有代码库?→ Claude Code(上下文最好)
  • 正在学编程?→ Replit(适合学习)
  • 已经会编程?→ Cursor(高级功能)

详细对比见 TOOLS.md。

构建工作流

  • [ ] 从规格开始(使用 scope 技能)
  • [ ] 把规格交给 AI 工具
  • [ ] 测试正常路径 + 边界情况
  • [ ] 针对问题给出具体反馈
  • [ ] 迭代(预计 2-4 轮)
  • [ ] 可用后部署

向 AI 提供规格

Claude Code:

Build this feature: [paste spec]

Codebase: React + TypeScript + Tailwind Reference: src/components/Button.tsx for button patterns

Lovable:

Build: [paste simplified spec focusing on outcome] Make it look like Linear (minimal, clean)

Replit:

Create: [paste spec emphasizing what user sees] Use React. Keep simple.

更多模式见 PROMPTS.md。

分块构建,而非一次完成

非技术创始人最大的错误:把整个规格交给 AI,期望一次完美返回。不会的。AI 工具在聚焦的小块中效果最好。

构建循环:

  1. 选一块(单个功能或流程)
  2. 只给 AI 这一块的清晰规格
  3. 测试——这块能工作吗?
  4. 继续前先修复问题
  5. 选下一块 → 重复

好的块(每块 1-3 小时):

  • 用户注册和登录
  • 显示关键指标的仪表盘
  • 带个人资料编辑的设置页
  • 一个核心工作流(例如“创建发票”)

坏的块(太大):

  • “构建整个应用”
  • “构建带所有集成的仪表盘”
  • “带角色、权限和团队功能的用户管理”

块之间的质量门

构建下一个功能前,检查:上一个功能还能用吗?你能注册、执行核心操作并看到结果吗?AI 工具有时会在添加新功能时破坏已有功能。尽早发现。

何时开启全新会话

在以下情况开启新的聊天/会话:

  • AI 对同一修复尝试 3 次以上仍未成功——上下文已被污染
  • 每次修复一个 bug 就出现新 bug
  • AI 在原地打转(建议已经试过的东西)
  • 完成当前功能后想添加新功能

开启新会话时,给 AI 清晰描述:已有什么、什么能用、接下来需要什么。不要假设它记得。

AI 不会主动添加的东西

AI 构建的项目通常缺少这些。需要明确要求添加:

  • [ ] 错误追踪(Sentry)——以便知道何时出错
  • [ ] 分析代码片段(Plausible、PostHog 或 GA4)——以便知道谁访问
  • [ ] 正确的 404 页面——以免坏链接显示空白
  • [ ] 正确的 500 页面——以免服务器错误显示有帮助的信息
  • [ ] Favicon——以免浏览器标签是空白方块
  • [ ] Meta 标签(title、description、OG image)——以免分享链接时难看
  • [ ] 加载状态——以免用户不知道发生了什么

审查 AI 构建的内容

测试,而不只是运行:

  • [ ] 看起来对吗?
  • [ ] 正常路径能用吗?
  • [ ] 边界情况能用吗?
  • [ ] 移动端能用吗?
  • [ ] 错误信息清晰吗?

给出反馈

差:“这个不能用”

好:“点击‘保存’没反应。预期:显示‘已保存!’消息”

模板:

What I tried: [action] Expected: [outcome] Got: [what happened]

迭代预期

正常:每个功能 2-4 轮

  • 第一次构建:AI 按规格构建,你发现 3-5 个问题
  • 第二次构建:修复这些,你再发现 1-2 个
  • 第三次构建:最终打磨

停止条件:

  • 正常路径能用
  • 边界情况已处理
  • 移动端能用
  • 没有明显 bug

不要为以下迭代:

  • 完美
  • 超出规格的功能
  • 过早优化

常见错误

错误 修复
没有规格 先用 scope 技能
“构建一个仪表盘” 明确上面有什么
跳过边界测试 尝试破坏它
不审查就接受 始终测试
构建中途加功能 先完成当前功能
自己修代码 描述问题,让 AI 修

合理划分工作量

太大:“构建整个应用”

太小:“加一个按钮”

合适:“构建用户认证流程”(1-3 小时)

好的块:

  • 用户登录/注册流程
  • 带 4 个指标的仪表盘
  • 带个人资料编辑的设置页

卡住时

AI 不断破坏东西: → 拆成更小的块,开启新会话

搞不定复杂功能: → 问:“最简单的方式是什么?”接受更简单的方案

每次修复都破坏别的东西: → 停下。问:“有更好的方法吗?”考虑重来

处理已有代码

Add [feature] to existing project.

Stack: [React, Next.js, etc] Patterns: Check src/components for examples Style: Tailwind + custom design system Follow existing code style

提示词模式

引用已有内容:

Build Settings page. Reference Dashboard page layout. Use same Card/Button components.

提供示例:

Pricing page with 3 tiers. Like Linear's pricing - clean, minimal.

指定约束:

Build profile page. Must work offline. Load under 2 seconds. WCAG AA accessible.

更多见 PROMPTS.md。

非技术创始人的审查

检查:

  • 符合规格吗?
  • 按钮能用吗?
  • 表单验证吗?
  • 看起来像设计参考吗?
  • 移动端能用吗?
  • 错误信息清晰吗?

不要检查:

  • 代码整洁度
  • 优化
  • “最佳实践”

AI 负责代码质量。你负责需求。

成功的样子

✅ 功能符合规格

✅ 2-4 次迭代(不是 10+)

✅ 能解释哪里不对

✅ 每周构建更快

适用场景

  • 非技术创始人使用 AI 工具构建 MVP 或产品功能
  • 需要选择 Claude Code、Lovable、Replit、Cursor 等工具
  • 需要编写有效提示词、分块构建、测试和迭代
  • 需要审查 AI 生成的功能并给出具体反馈

限制

  • 该技能本身不提供代码,而是流程指导
  • 具体工具对比、提示词模式等细节在 TOOLS.md 和 PROMPTS.md 中,本资料未提供其内容
  • 不涉及收费、价格、平台或效果保证
  • 未提供安装命令或代码内容