菜单
Go 后端全生命周期规范——统一三层 handler→service→repository（禁 manager/facade/usecase）；事务只在 service；禁过度抽象、禁单实现 interface、禁过渡方案。触发：编辑 .go/go.mod/go.sum；写 Go 项目的文档/PRD/规划/设计/review。跳过：vendor、代码生成物（*_gen.go/protobuf）、非 Go 项目。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | golang-constraints |
| description | Go 后端全生命周期规范——统一三层 handler→service→repository（禁 manager/facade/usecase）；事务只在 service；禁过度抽象、禁单实现 interface、禁过渡方案。触发：编辑 .go/go.mod/go.sum；写 Go 项目的文档/PRD/规划/设计/review。跳过：vendor、代码生成物（*_gen.go/protobuf）、非 Go 项目。 |
适用于：Go 后端项目从需求到上线全生命周期内 AI 产出的所有产出物（代码 / 文档 / PRD / 规划 / 设计 / review）。
TRIGGER：编辑 .go / go.mod / go.sum；编写 Go 项目相关文档 / PRD / 规划 / 设计 / review。
SKIP：vendor/、代码生成物（*_gen.go、protobuf）、非 Go 项目。
通用禁止：擅自发明新分层 / 接口抽象 / 第三方依赖；为"优雅""通用性""未来扩展"提前抽象；顺手做未被要求的事。
默认策略：最简单直接的实现 / 当前仓库已有模式 / 最少抽象层 / 最少文件改动。
业务分层（受 §2.3 职责约束，构成 handler → service → repository 调用链）：handler / service / repository / model（或 entity）/ dto
支撑包（不参与分层调用链，任何层可用）：config / pkg
禁止擅自引入：manager / facade / adapter / domain / application / controller。usecase 一律禁止。
| 形态 | 定位 | 持有的依赖 | 命名倾向 |
|---|---|---|---|
| 领域 service | 单一领域业务规则 | 只持有本领域 repository | 名词：User / Order |
| 编排 service | 跨领域流程编排 + 事务一致性 | 多个领域 service + TxManager；不持有 repository | 动词：Checkout / Refund |
硬性规则：
TxManager.InTx(ctx, fn) 闭包；事务句柄通过 ctx 传递，不通过方法参数*sql.Tx 等事务句柄；从 ctx 取何时抽编排 service：修改 ≥ 2 个领域数据 / 需跨领域事务一致性 / 语义本身是动词流程。
| 层 | 允许 | 禁止 |
|---|---|---|
| handler | 参数绑定、调用 service、响应转换 | 写业务逻辑、直接访问 repository |
| service（领域） | 本领域业务规则、调用本领域 repository | 持有别领域依赖、写 SQL、依赖框架对象 |
| service（编排） | 持有多个领域 service + TxManager、编排跨领域事务 | 持有 repository、写业务规则 |
| repository | 数据存取、从 ctx 取事务句柄 | 承载业务规则、返回 map[string]any |
优先遵守现有结构；若无则用扁平分层包，业务分层落 internal/、支撑包提到仓库根与 internal 平级：
/config # 配置加载与默认值（仓库内唯一来源）
/pkg # 跨项目可复用的支撑代码（无业务语义）
/internal/{handler,service,repository,dto,model}
同包按领域拆文件（user.go / order.go），不强制拆子包。
为什么 config/pkg 提到根：两者均不参与 handler→service→repository 调用链，且语义上是「跨业务的支撑」而非「业务实现」——放进 internal/ 会让人误以为是某一层的下属包；提到根反而准确表达「任何层可用、不属于任何层」。
命名贯彻 avoid stuttering——包名已表达的语义不在标识符里重复：
| 包形态 | 类型名 | 构造函数 | 方法名 |
|---|---|---|---|
| 扁平分层包（多领域共存） | User / Checkout（不加 Handler/Service 后缀） | NewUser / NewCheckout | 保留领域词：CreateUser / DoCheckout |
独立单领域包（config 等） | Config | New(...) | 省略领域词：Load()（不是 LoadConfig） |
禁止：UserHandler / NewUserService / config.LoadConfig() / user_handler.go。
默认不创建。 仅允许：已有代码依赖 interface 注入 / 需要 mock 且已有低层注入点无法满足 / 仓库内已有 ≥ 2 个落地实现。新增前必须列出 ≥ 2 个已落地实现的文件路径。
New(...)；扁平分层包 → NewXxx(...)（只写领域名）请求链路方法必须以 context.Context 作为第一参数。禁止用 context.Background() 替代上游 ctx、把 Web 框架专属 context 传入 repository、把 ctx 存入 struct。
必须显式处理；仅在补上下文时用 fmt.Errorf("...: %w", err)。禁止 _ 忽略、无意义包装、panic 处理业务错误、多层重复包装。
只记录：关键业务节点 / 外部依赖失败 / 非预期错误。禁止每函数入口打印、正常流程刷屏、记录敏感信息、既返回错误又每层重复打印。
没有明确性能需求时默认不用。优先级：errgroup > sync.Mutex > channel。禁止 handler 中裸起 goroutine。
所有 DB 访问收敛到 repository 层。禁止混入第二套访问风格、service 直接写 SQL。
默认：标准库 → 项目已有依赖 → 不新增。官方库优先（database/sql、net/http 等）；禁止第三方封装替代。确需新增第三方库时，必须先向用户说明理由（标准库 / 已有依赖为何不满足、候选库是什么）并获明确同意，才能写入 import 或 go.mod；用户主动点名的库视为已同意。涉及版本号遵循 version-policy skill。
TestUser_CreateUserfoo_test.go 必须存在同目录同 basename 的 foo.go；禁止 helpers_test.go / extra_test.go / integration_test.go 等游离测试文件。完整规则与例外见 golang-testing §0http.Client、外部 SDK 接口）var timeNow = time.Now）/ 无断言测试 / 只覆盖 happy pathgofmt / 命名简洁明确 / 缩小作用域 / 提前 return 减少嵌套 / 单函数单职责。统一用 any 替代 interface{}。禁止过长函数、过深嵌套、魔法数字。
每次改 import 后立即运行 go mod tidy。禁止手动编辑 go.mod 的 require 块。
唯一指定 lint 工具：golangci-lint。配置落在仓库根 .golangci.yml（或 .golangci.yaml），版本通过 CI 钉死。
go vet 单跑、staticcheck 独立、revive 独立等）——这些 linter 收归 .golangci.yml 的 linters 段统一开关//nolint 无说明）；必要豁免须写明原因：//nolint:gosec // 业务侧 X 场景已校验.golangci.yml；本地直跑 golangci-lint run ./...test 入口下（详见 golang-testing §9），不允许 lint 在测试通道之外的独立 job 里跑——CI 漏跑 lint 等同于零成本破窗应用层生成 UUIDv7：Go 层 uuid.UUID / 接口层 string。handler 层做双向转换，service/repository 只接受 uuid.UUID。
软删除标记用 time.Now().UTC().UnixMicro() 写入 deleted 列。常规查询必须带 WHERE deleted = 0。
created_at / updated_at 由 DB 自动管理。禁止 INSERT/UPDATE 显式写、Service 层手动赋值。写入后必须回读获取 DB 生成值。
MySQL DSN 固定 ?parseTime=true&loc=UTC&time_zone=%27%2B00:00%27。Go 用 time.Now().UTC()，SQL 用 UTC_TIMESTAMP(6)。
以下规则不仅适用于编码，也适用于文档 / PRD / 规划 / 设计 / review：
本地 ultrareview——多代理、对抗验证、只读的 PR 级 review；默认 base=main；并发 5 个 finder（质量/安全/简洁/鲁棒性/文档同步），每条 🔴/🟡 发现交 3 个独立怀疑视角对抗验证、多数决去留；可选追加本次 review 重点，注入每个 finder 优先关注（不替代其他维度）。触发：/review、给当前分支做深度审查、PR 前 ultrareview。跳过：不在 git 仓库、当前分支=base。
产出修订（诊断→定向修正→回归验证）——对 spec→plan→exec 偏差做根因归类：spec-defect / impl-defect / requirement-change；先诊断再修正、改代码必先 Red 测试、最小影响只改必须改的层；已完成 plan 是历史审计快照禁止回改；启动先 worktree 感知定位修复现场（主仓库停在 main 时自动定位到进行中的 worktree）。触发：/revise、有 bug、结果不对、和预期不符、产出需要优化、review 发现违规需修复。跳过：纯新增需求（→/spec→/plan）、还没有 spec/plan/代码可对照。
本地 ultrareview——跨模型、多代理、对抗验证、只读的 PR 级 review（依赖 Workflow 工具，Claude Code ≥2.1.154）；默认 base=main；并发 6 个 finder（质量/安全/简洁/鲁棒性/文档同步/Codex 跨模型），每条 🔴/🟡 发现交 3 个独立怀疑视角对抗验证、多数决去留；可选追加本次 review 重点，注入每个 finder 优先关注（不替代其他维度）。触发：/review、给当前分支做深度审查、PR 前 ultrareview。跳过：无 Workflow 工具、不在 git 仓库、当前分支=base。
产出修订（诊断→定向修正→回归验证）——对 spec→plan→exec 偏差做根因归类：spec-defect / impl-defect / requirement-change；先诊断再修正、改代码必先 Red 测试、最小影响只改必须改的层；已完成 plan 是历史审计快照禁止回改；启动先 worktree 感知定位修复现场（主仓库停在 main 时自动定位到进行中的 worktree）。触发：/revise、有 bug、结果不对、和预期不符、产出需要优化、review 发现违规需修复。跳过：纯新增需求（→/spec→/plan）、还没有 spec/plan/代码可对照。
Git 开发流程纪律——禁 main 直接提交；新任务前扫工作区根，有 workspace 标记走多 repo 工作区，否则 `question` 工具 询问 worktree（默认）或切分支；worktree 一律落 `~/.bb-spec/worktrees/` 下、禁嵌套当前 repo / 禁放 sibling 目录；本地 commit 不立即 push、整功能验证完才推；合并后清理本地+远程。触发：开始改代码、提到开分支、要求 commit/push/开 PR、PR 合并后清理。跳过：纯咨询/阅读、极小打字纠错。
前端技术栈强制约束——默认 Vue 3 + TS + Vite + Tailwind；bun 是默认包管理器（新项目强制），既有项目跟随 lockfile 不迁移。触发：新建前端项目；编辑 package.json/vite.config/tailwind.config/.vue/.ts/.tsx；用户提到前端/vue/vite/tailwind。跳过：纯后端/CLI/工具项目；用户明确说用 React/Nuxt/Svelte 等。