SuperAPI AI 工具集

dev

编程与开发

查看项目

更新于 11-10 11:25

技能介绍

Dev 是一个面向全栈与 AI 开发者的项目风格技能,主要服务于使用 React、Vite、Bun、TypeScript、Convex、Convex Auth 和 Resend 的项目。它的定位是一份可在安装后按项目实际需求修改的“团队风格”指南,而不是独立工具或框架。

主要能力涵盖以下方面:在编码原则上,要求全程类型安全、不使用 any,保持简洁随意的沟通风格,不用 emoji,把用户当作新开发者并在不明显处用一句话解释原因,不破坏现有功能,不过度工程化。在 Convex 相关实践中,要求在使用 API 前先查阅官方文档,处理 mutations 时直接 patch、在服务端校验所有权、保持幂等、使用时间戳排序、对独立读取使用 Promise.all,并给出了 TypeScript 最佳实践、工作流、查询函数、mutation 函数、函数内认证、Convex Auth、文件存储、向量搜索、官方组件等参考链接。在认证方面,推荐 Convex Auth 及 Convex Auth v2,并说明 Convex Auth 处于 beta 阶段,支持从 CDN 提供的 React Web 应用和 React Native,Next.js 支持仍在开发中。在 React 方面,建议在添加 useEffect 前先阅读官方文档,派生状态应计算而非存储。在邮件方面引用 Resend 文档。在设计系统方面,遵循 Vercel Web Interface Guidelines,使用站点自有设计系统处理模态框、警告和通知,禁止使用 window.confirm、alert、prompt,禁止紫色和 emoji,并明确生产就绪、无占位内容。

使用方式上,该技能以文本风格指南形式提供,安装后需根据项目修改,例如补充调色板、字号层级和间距规则。文档约定包括 files.md(每文件一行)、changelog.md(遵循 Keep a Changelog,日期来自 git log)、task.md(To Do、In Progress、Completed 及 UTC 时间戳),非平凡多步骤工作前在 prds/ 中编写 PRD,变更落地后加载 update-project-docs,不主动创建 README、CONTRIBUTING、SUMMARY 或 USAGE_GUIDELINES。沟通上要求先给答案再解释,重论证而非权威,可提出推测但需标明,结尾引用来源而非行内引用。

适用场景为使用上述技术栈进行全栈 Convex 开发的团队或个人,希望统一编码风格、认证实践、设计规范与文档流程。限制在于:该技能是风格约定而非可执行程序;部分链接和组件需访问外部文档;Convex Auth 的 beta 状态和 Next.js 支持情况需以官方文档为准;调色板、字号和间距等具体规则需用户自行补充。