用途:为某个数据模型编写风格一致的 REST API 端点,复用现有代码库模式,避免重复代码。
主要能力:先阅读数据库模型、已有处理器、路由模式和共享中间件,优先复用响应辅助函数、分页、校验 schema、鉴权守卫和错误类。定义契约(省略的动词或嵌套路由需与用户确认):GET /resources 列表(分页)、GET /resources/:id 单个或 404、POST /resources 创建返回 201、PUT /resources/:id 全量替换或 404、PATCH /resources/:id 部分更新或 404、DELETE /resources/:id 返回 204 或 404。
使用方式:每个处理器只做一件事——校验、调用 service/repo、响应;不在处理器中直接查数据库,统一走 service 或 repository 层;使用共享错误处理,不重复 try/catch;响应统一为成功 { data }、失败 { error, message };service 层的 404 需传播为一致错误响应;不向客户端暴露内部数据库错误或堆栈。完成后运行 /write-tests 生成测试,并用 npx tsc --noEmit 检查类型、npm test -- --testPathPattern=<resource> 做定向测试。
限制:不添加推测性路由;未要求时跳过过滤、排序和分页;若尚无 service/repository 层,需先用 /refactor-codebase;处理器保持精简,逻辑超过约 30 行应下沉到 service 层。参考 REFERENCE.md 了解响应结构、错误、校验、分页和测试模板。