SuperAPI AI 工具集

think-first

编程与开发

查看项目

更新于 11-10 11:25

技能介绍

think-first 是一个面向 Convex 项目的开发工作流技能,核心主张是在第一次编辑前放慢约三十秒,先想清楚再动手,以避免后续返工。

用途与目标 它用于约束 AI 编码助手在修改 Convex 项目时的行为,要求先定位根因再写代码,并把改动限制在需求所必需的范围内。

主要能力与规则

  1. 反思先行:读懂现有代码而非猜测,识别缺失、错误或不完整之处,列出两到三种可能原因,收窄到最可能的一到两项并说明理由,清晰后才继续。任何不清楚之处应提出一个聚焦问题并停下。
  2. 置信度门槛:对所需改动置信度低于 98% 时不写代码,改为继续阅读、提问或提出方案;技能说明该数值可按项目需要调整。
  3. Convex 专项规则:依赖记忆前先查阅 Convex 官方文档;用普通对象调用 mutation,并保持表单字段与文档字段同名;无需当前文档时直接 patch;在服务端校验所有权,通过 ctx.auth 比较 owner 或经 owner 字段索引读取,不信任参数中传入的 owner id;用提前返回使 mutation 幂等;用时间戳字段或 _creationTime 排序新条目;用 Promise.all 处理独立读取,并保持每次 mutation 读写范围狭窄以降低 OCC 冲突。
  4. 范围控制:只改需求需要的文件,必要时改 schema,改动落地后同步 changelog.md、files.md 和 task.md,日期用 git log --date=short 获取真实历史;不改需求未提及的 UI、布局、设计、颜色、文案、管理后台区块、前端组件或功能,不主动删除内容。
  5. UI 规范:所有弹窗、提示、模态、警告、toast 和确认使用站点设计系统,不用浏览器默认样式,并遵循 Vercel Web Interface Guidelines。
  6. 文档与 Git:除非被要求,不创建 README、CONTRIBUTING、SUMMARY 或 USAGE_GUIDELINES 文件,回复中简短总结即可,文档和应用中不加 emoji;执行可能丢弃工作的 git 命令前先加载 git-safety,先 git status,丢弃前先 git diff,未经用户确认不运行 reset --hard、checkout -- .、clean -fd 或 stash drop。
  7. 检查清单:首次编辑前确认能说出根因、考虑过至少两种修复并说明选择理由、达到置信度门槛、明确改动与不改动的文件、保留未提及的 UI 与功能、查阅相关文档、已就不清楚之处提问;宣布完成前确认修复经过验证、无需求外改动、非平凡改动已同步文档。

使用方式 该技能以文档形式提供工作流指令,供 AI 编码助手在 Convex 项目中遵循。资料未提供具体安装命令或集成方式。

适用场景 适用于使用 Convex 的开发者希望 AI 助手减少误改、准确定位根因、控制变更范围并遵守 Convex 最佳实践的场景。

限制 资料主要给出针对 Convex 的编码约束,未提供安装方式、具体工具形态或收费信息;置信度数值与受保护区域需按项目自行调整和补充。