最佳实践

​

1. 使用自定义知识作为您的项目大脑

• 记录产品愿景,关键用户旅程,核心功能和设计规则
• 定义角色和边界（管理员/用户/投资者等）
• 这些知识会被持续引用并改进未来的编辑

问AI例子:

Generate knowledge for my project at T=0 based on features implemented.

​

2. 提示最佳实践

• 具体:指向页面/模块和预期行为
• 一次只做一件事;分块实施并验证
• 指定请勿触摸区域（请勿触摸…）
• 为了清晰起见,包括屏幕截图/截屏视频

问AI模板:

On page /settings, implement [feature]. Expected: [XYZ].
Please don’t touch component A / layout B / shared logic unless necessary.

​

3. Supabase 和全栈节奏

• 先稳定前端,再连接Supabase
• 在回滚版本之前验证数据库架构兼容性

问人工智能:

Validate SQL schema at T=0 and ensure no breaking changes.

​

4. 使用可编辑设计快速更改 UI

• 副本/color/排版/间距/响应能力的可视化编辑更快,更安全
• Boxify 消耗积分;其他编辑则不然

​

5. 利用版本和差异

• 固定每个已知的良好状态
• 使用版本差异来定位有问题的更改

问人工智能:

Compare version at T–1 to T–0. What changed and what might break?

​

6.使用复刻作为重置选项

• 如果陷入错误循环或沉重的技术债务,请使用 复刻 从干净的基线进行重建
• 在复刻连接的项目之前断开 Supabase

​

7. 小Step,始终可逆

• 将工作分解为最小的可验证增量
• 在每个Step之后,进行回归检查和用户流验证

​

8. 文档和社区

• 阅读文档流程和模板;出现问题时首先搜索
• 在寻求帮助之前整理您的问题和背景

​

9. 安全性和合规性基础知识

• 切勿粘贴秘密;使用后端环境变量/秘密
• 最小权限,环境隔离,预发布安全检查

​

10. 接入复杂第三方 API

1. 打开第三方平台的官方 API 文档页面
2. 复制核心接口说明（包含请求参数、返回字段、签名方式）
3. 在 superun 对话中粘贴文档内容,告诉 AI:“按这份文档实现 xxx 功能”

以下是微信支付统一下单 API 的文档:
[粘贴文档内容]

请按此文档实现支付功能,AppID 和 商户密钥通过后端环境变量注入.

• AI 直接参照正确规范实现,减少猜测和调试次数
• 签名算法、回调验证等细节不容易出错
• 遇到接口升级,只需更新粘贴的文档内容