new-controller

根据 $ARGUMENTS 生成 Controller handler 文件。

公共步骤模板见 skills-spec/01_skill_authoring_guide.md §A-§E。本 Skill 特定内容如下。

第 0 步：拒绝规则与依赖前置

• ⛔ 拒绝（§A.1）：路径命中 BUILD_STATUS.md §0 中 🚫 模块路径（如 admin/{disabled-module}/*）时立即拒绝
• 状态检查（§A.2）：读 BUILD_STATUS.md §5 路由组状态
• 依赖（§A.3）：
  • 对应 service 未实现 → 先调 /new-service 生成
  • Internal 路由组首次生成时，先检查共享文件：controllers/http/internal/render.go（renderInternalResponse）+ validator.go，缺失则按 docs/architecture/render_functions.md 生成

第 1 步：读取设计文档（公共必读见 §B）

• 主文档：docs/api/{audience}_interfaces.md
• 额外必读：docs/architecture/routing.md §4、docs/service/service_design.md（确认 service 方法签名）

第 2 步：选择响应模板

Internal 控制器模板（与外部协议对齐的响应格式）

package {module}

import (
    "{project}/components"
    "{project}/pkg/gin"
    "{project}/service/{service_module}"
)

type {Action}Req struct {
    Field1 string `json:"field1" binding:"required,max=64"`
}

var {svcVar} = &{service_module}.{Service}Service{}

func {Action}(ctx *gin.Context) {
    var req {Action}Req
    if err := ctx.ShouldBindJSON(&req); err != nil {
        renderInternalResponse(ctx, components.NewServiceError({N}, "请求参数错误"), nil)
        return
    }
    resp, err := {svcVar}.{Method}(ctx, &req)
    renderInternalResponse(ctx, err, resp)
}

UserSelf / Admin 控制器模板（标准 errNo/errStr 响应格式）

package {module}

import (
    "{project}/components"
    "{project}/pkg/gin"
    "{project}/pkg/golib/v2/base"
    "{project}/service/{service_module}"
)

type {Action}Req struct {
    Field1 string `json:"field1" binding:"required,max=64"`
}

var {svcVar} = &{service_module}.{Service}Service{}

func {Action}(ctx *gin.Context) {
    var req {Action}Req
    if err := ctx.ShouldBindJSON(&req); err != nil {  // GET 用 ShouldBindQuery
        base.RenderJsonFail(ctx, components.ErrorParamInvalid)
        return
    }
    resp, err := {svcVar}.{Method}(ctx, &req)
    if err != nil {
        base.RenderJsonFail(ctx, err)
        return
    }
    base.RenderJsonSucc(ctx, resp)
}