SuperAPI AI 工具集

help

通用与其它

查看项目

更新于 10-16 06:44

技能介绍

这是一个面向全栈 Convex 开发的开发规范与问题解决方法论技能,核心是先反思再动手。

用途:在实现任何方案前,先进行根因分析,避免在未理解问题的情况下写代码。

主要能力与方法:流程为反思(为何当前实现可能不工作)、识别(依据请求判断缺失、不完整或错误之处)、推演(可能的问题来源或需更新之处)、提炼(缩小到 1-2 个最可能根因或方案)、再执行。强调不要假设,不清楚就提问澄清。

Convex 实现准则:使用直接 mutation 调用与普通对象;创建专用 mutation 函数把表单字段映射到数据库字段,表单字段名尽量与数据库字段名一致;直接 patch 而不先读取;用索引查询做归属校验而非 ctx.db.get();让 mutation 具备幂等性并带提前返回;新条目按时间戳排序;用 Promise.all() 并行执行相互独立的操作以避免写冲突。

变更范围:按需更新 Convex schema;只改与原始请求直接相关的必要文件;涉及 changelog.md、changelog 页面或 files.md 时先运行 git log --date=short 核对提交历史,发布日期以真实提交时间为准,不用占位或未来月份;未明确要求不改 UI、布局、设计与配色,不删除任何区块、功能或组件。

UI/UX:弹窗、提示、模态、警告、通知与确认必须沿用站点既有设计系统,禁止用浏览器默认弹窗,并遵循 Vercel 界面指南。

文档策略:除非明确要求,不创建文档文件(README.md、CONTRIBUTING.md、SUMMARY.md、USAGE_GUIDELINES.md 等均禁用);可在回复中给出简短总结。除非被要求,readme 或应用中不用 emoji。

代码置信度:遵循 98% 规则,对要做的事没有 98% 以上把握前不写代码;不确定时提问、不假设、查阅文档、缩小到 1-2 个最可能方案。具体版本、安装方式与收费信息暂未提供。