用途:面向 TypeScript/Node.js 后端代码的编写、评审与重构,框架中立,可将同一套职责映射到 Fastify、Express、Hono、Workers、队列、CLI、SDK、数据库包与集成模块。
主要能力:以函数式核心/命令式外壳为模型,明确路由、中间件、守卫、服务、仓储、外部系统与类型契约的职责边界;路由/控制器负责传输层(方法、路径、状态码、请求解析与校验、鉴权与守卫、响应映射);服务编排仓储与外部调用并按事实来源排序、处理失败清理;仓储只负责持久化行为(查询、默认值、事务、分页、行解析),不得调用外部 API 或队列;外部系统应经适配器/门面封装并支持依赖注入。强调运行时 schema 在信任边界解析、具名守卫组合、插件按序注册、ESM 与 node: 导入、kebab-case 文件名与职责命名。
使用方式:改动前先读仓库约定(AGENTS.md、package README、测试设置、邻近代码),检查包结构、导入、入口、db/repo、helpers 与测试;优先沿用现有约定;新建 helper、service、schema、repository 前先搜索并合并重复;先确定契约与生成文件的唯一事实来源。
适用场景:API、路由、服务、事务、鉴权、集成模块与后端包的新建或架构清理。
限制:资料未提供版本要求、安装命令、价格与许可信息;未提供具体平台的适配细节与效果数据。