SuperAPI AI 工具集

fullstack-conventions

编程与开发

查看项目

更新于 10-16 06:49

技能介绍

用途:为 fullstack-dev 团队提供统一的编码约定与模式,指导全栈开发实践。

主要能力: 通用:遵循发现阶段确定的现有项目约定;可读性优先于技巧性;函数保持专注且小;严格使用 TypeScript,无正当理由不得使用 any 类型。 前端:使用带 hooks 的函数式 React 组件;为所有组件 props 定义 TypeScript 接口;每个数据获取组件处理加载、错误和空状态;使用语义化 HTML 元素(nav、main、article、section 等);严格遵循项目样式方案;组件文件保持在 200 行以内,超出则拆分。 后端:在 API 边界验证所有输入;使用正确的 HTTP 状态码;返回一致的响应结构 { data, error, meta };控制器保持精简,业务逻辑放在服务层;所有 schema 变更编写数据库迁移;绝不向客户端暴露内部错误。 测试:测试用户可见行为而非实现细节;每个 API 端点至少有一个正常路径和一个错误测试;前端组件需要渲染和关键交互测试;使用项目现有的测试工具和模式。 协作:每个 agent 在既定范围内工作;agent 不应修改职责范围外的文件;前后端在实现前就 API 契约达成一致;所有变更必须遵循现有代码库中的模式。

使用方式:作为团队开发规范参考,在编写前端、后端和测试代码时遵循上述约定。

限制:资料未提供具体安装命令、配置方式或平台支持信息。