SuperAPI AI 工具集

grounding-before-coding

编程与开发

查看项目

更新于 10-16 08:01

技能介绍

用途:在写规格、修缺陷或写第一行代码之前,先梳理真实的代码与数据路径,避免基于名称、文档或票据自述状态做假设。要求有 principal-engineering 技能作为前置背景。

主要能力与做法:读实现而非读名字,方法名叫 validate 并不代表它真在校验;为计划中每条承重结论标注 file:line、精确查询结果或命令输出,无法佐证就明说而非默认;不猜仓库约定,命名、依赖装配、错误处理、测试运行方式都可以在几分钟内查明;信任代码而非状态字段,文档或工单的自述状态不算执行状态证据,应结合代码与历史(git log -S <symbol>、在代码树中 grep)裁定;修缺陷前先复现失败;在调用方汇聚处修,编辑前先找出进入该代码的所有路径,共享缺陷就在共享位置加防护,这既是最小改动也覆盖工单未提及的兄弟路径;梳理改动不得破坏的不变量,测试命名、带注释的守卫、硬编码阈值往往标记着历史事故。

适用场景:任何非平凡改动、排查缺陷、陌生代码。

限制:不必读全部代码,只需覆盖改动触达处及外扩一圈,深度按风险定;不能代替询问,代码答不了意图问题(如阈值为何是 7)时查历史或问负责人,无法回答的问题要显式记为假设;同一会话已确认的不必重新落地,落地一次后续引用即可。

常见错误:依据框架文档推想项目代码行为,而项目可能已分叉、包装或误用;只落地正常路径,不变量往往藏在错误路径与边界守卫中;相信此前会话对代码的总结而不打开对应文件;因任务“看起来像”以前做过的就跳过落地。