用途:为后端新增或扩展 API 端点,使其具备请求与响应校验、认证授权、稳定错误分类和测试覆盖,是后端功能暴露的默认入口。
主要能力:生成或更新端点处理器、控制器、路由入口;按仓库模式实现输入校验与授权;将错误映射到共享错误分类;补充单元测试或路由边界集成测试。
使用方式:需提供端点意图、契约(方法+路径、请求字段与类型、响应结构与类型)、授权预期(public/authenticated/role-based/resource-based)、预期失败用例,以及可选的仓库配置 <repo>/REPO_PROFILE.json。工作流为:发现仓库端点约定(路由、校验库、错误结构、认证中间件),显式定义契约,默认失败关闭地强制授权,通过模块边界调用领域逻辑,映射错误分类,在最高稳定层添加测试。若引入分支、重试、异步协调或多步行为,建议先用 system/state-machine-mapper 建模或明确豁免。
适用场景:需要快速、规范地暴露后端功能,并保证校验、授权、错误一致性和测试覆盖时。
限制:不实现复杂领域规则(用 backend/domain-logic-module),不改持久化模式(用 backend/persistence-layer-change),不改跨消费者 API 契约(用 api/contract-update),不做横切架构重写。缺少错误分类、授权规则或契约不清晰时,应先补齐相应技能或决策记录。