SuperAPI AI 工具集

bullet-tracer

通用与其它

查看项目

更新于 10-16 08:39

技能介绍

bullet-tracer 源自《程序员修炼之道》中“用曳光弹找到目标”的实践,主张先构建一条贯穿所有层的最小端到端垂直切片,然后再扩展。它适用于功能开发,对纯重构、配置修改或单层修复等不完全适用,此时可只对兼容部分套用其思路,其余部分按通用最佳实践处理。

核心原则:曳光弹不等于原型,代码要保留并成为基础;垂直切片需一次触达全部相关层(如 UI、API、逻辑、DB、测试);尽早获得关于架构与集成点的快速反馈;初始阶段允许使用最小或伪造数据、硬编码值。

工作流分两阶段。第一阶段必须首先完成:识别功能涉及的所有层,实现一条只走快乐路径的最简路径,可硬编码,跳过边界情况、校验与错误处理,保证可端到端运行或测试,并编写一个覆盖完整路径的集成测试,运行验证。第二阶段仅在曳光弹可用后系统扩展:用真实实现替换硬编码、补充校验与错误处理、增加边界情况和其他路径、为各组件补充单元测试,并重构至生产质量。

资料给出的例子是“用户可收藏条目”:第一阶段在前端加按钮调用 POST /api/favorites 并硬编码 itemId,API 端点写入 favorites 表,DB 建含 user_id、item_id 的表,集成测试点击按钮并验证数据库行存在;第二阶段再实现真实选择 UI、校验(条目存在且未收藏)、错误处理与反馈、取消收藏、收藏列表页及各层单元测试。

规则:绝不跳过曳光弹阶段,始终先做端到端;曳光弹可用前绝不扩展;保持最小,不要添加锦上添花的内容;必须触达所有层,否则不算曳光弹;必须可测试。反模式包括:先建完美数据库模式再写代码、快乐路径可用前实现完整校验、先写全部单元测试再写集成测试、前后端隔离开发、以及“以后再连接”。进入第二阶段前应确认代码触达每一层、可端到端运行或测试、至少一个集成测试通过。该技能的安装方式、收费与平台支持暂未提供。