SuperAPI AI 工具集

buildit

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

buildit 的定位是“构建并交付功能”的开发引导者,目标是写出干净、可运行的代码,快速而正确地交付。其核心原则是先能跑通、再写正确、最后优化,且顺序不可颠倒;写代码前先阅读,理解现有模式后再添加;优先最小差异,不重构无关代码;用删除代替注释掉,死代码即噪音。

使用流程分三步。第一步探测技术栈:在写任何代码前,通过 package.json(Node/TypeScript/JavaScript)、pyproject.toml 或 requirements.txt(Python)、go.mod(Go)、Gemfile(Ruby/Rails)、pom.xml 或 build.gradle(Java/Kotlin)、Cargo.toml(Rust)、mix.exs(Elixir)、.csproj 或 .sln(.NET/C#)等文件判断项目类型,并查看 next.config.、vite.config.、config/routes.rb、main.go、manage.py 等框架标记;资料明确强调不要默认假设是 TypeScript 或 Python。第二步选择设计模式:Service Layer(多数 CRUD 应用与 API,Route → Service → Repository → DB)、Repository(数据密集、多数据源)、MVC(Rails、Django、Spring 等传统 Web 应用)、Hexagonal(复杂领域、多集成)、Feature Modules(大型应用、按功能分团队);新项目默认 Service Layer,已有代码库则沿用现有模式。第三步按所选栈实践代码模式。

代码模式要求:每个 UI 组件处理空、加载、错误、已加载四种状态;API 路由在边界校验输入、返回一致结构({ data } 或 { error })、业务逻辑前做鉴权、保持路由轻薄;数据库变更用迁移而非手工 SQL、多表写入用事务、为 WHERE 和 JOIN 涉及的列建索引。安全默认项包括边界校验全部用户输入、每个受保护路由鉴权、参数化查询而非字符串拼接 SQL、密钥放在环境变量而非代码或 Git、全程 HTTPS。完成后运行 /gate 验证 lint、类型、构建与测试通过,再宣布完成。

资料还列出部分技术栈的参考示例,如 TypeScript 用 Zod 在边界校验、Drizzle 或 Prisma 作 ORM;Python 用 Pydantic 或 Django 表单/序列化器、SQLAlchemy 或 Django ORM、pytest、uv 或 Poetry;Go 用手动结构体校验或 go-playground/validator、sqlx/pgx/GORM、net/http 或 chi/gin/echo、testing 包加 testify;Ruby 用 ActiveRecord 校验与 ORM、RSpec 或 Minitest、Sidekiq;Java/Kotlin 用 Bean Validation/Hibernate Validator、Spring Data JPA/Hibernate、JUnit 5 + Mockito。其他技术栈则遵循同样原则:边界校验、业务逻辑放服务层、路由保持轻薄。资料未提供安装方式、收费模式与平台支持等信息。