golang-constraints

仓库创建 2026年6月24日最近提交 21 天前SkillHot 收录 21 天前

▸ 精选理由

强调一致性与可维护，避免为测试做多余抽象，适合团队级规范化。

这个 Skill 做什么

为 Go 后端项目提供全生命周期的代码与产出物约束与规范。

为 Go 后端项目提供一套从需求到上线的规范约束，涵盖代码、文档、PRD、设计和 review 等产出。在修改 .go 文件、做架构设计或制定项目规范时用，明确不能过度抽象和不能引入临时兼容方案。特别强调统一三层架构、一致性优先以及测试不能为测试目的随意加 interface 或包裹生产变量，倾向用现有低层注入点做 mock。

▸ 展开 SKILL.md 英文原文

Whole-lifecycle constraints for Go backend projects — spanning coding, docs, PRD, planning, design, and review; a unified three-layer architecture, no over-abstraction, no transitional schemes, tests subordinate to production design (no wrapping production vars or adding interfaces just for tests — when a mock is needed, prefer an existing low-level injection point). ｜ Go 后端项目全生命周期规范约束：贯穿编码、文档、PRD、规划、设计、review；统一三层架构、禁过度抽象、禁过渡方案、测试服从生产设计（禁为测试包装 var 或新增 interface，需要 mock 时优先用已有低层注入点）。 Use when this capability is needed.

开发编程Go规范后端约束通用

Stars

Forks

仓库内 Skill

7 日增星

安装 / 使用

给你的 Agent 一句话（通用）

帮我安装这个 skill：https://raw.githubusercontent.com/tomevault-io/skills-registry/main/0xbb2b--bb-spec--golang-constraints/SKILL.md

或 curl 直取 SKILL.md

curl -fsSL "https://raw.githubusercontent.com/tomevault-io/skills-registry/main/0xbb2b--bb-spec--golang-constraints/SKILL.md"

SKILL.MD 节选查看完整文件 ↗

# Go 项目规范约束

适用于：Go 后端项目从需求到上线全生命周期内 AI 产出的**所有产出物**（代码 / 文档 / PRD / 规划 / 设计 / review）。

## 0. 触发与跳过

**TRIGGER**：编辑 `.go` / `go.mod` / `go.sum`；编写 Go 项目相关文档 / PRD / 规划 / 设计 / review。
**SKIP**：`vendor/`、代码生成物（`*_gen.go`、protobuf）、非 Go 项目。

---

## 一、核心原则

1. 一致性 > 炫技 ｜ 2. 可维护性 > 抽象性 ｜ 3. 显式 > 灵活 ｜ 4. 现有模式 > 新模式 ｜ 5. 需求未明确时不引入额外设计

- **根源方案 > 过渡方案**：禁止"保留旧 X 兼容""新旧并列""暂时保留"等过渡式写法。
- **一份推荐 > 并列多方案**：任何场景只给一个推荐 + 理由。

**通用禁止**：擅自发明新分层 / 接口抽象 / 第三方依赖；为"优雅""通用性""未来扩展"提前抽象；顺手做未被要求的事。

**默认策略**：最简单直接的实现 / 当前仓库已有模式 / 最少抽象层 / 最少文件改动。

---

## 二、分层契约

### 2.1 允许的包

**业务分层**（受 §2.3 职责约束，构成 handler → service → repository 调用链）：`handler` / `service` / `repository` / `model`（或 `entity`）/ `dto`

**支撑包**（不参

via SKILL·HOT · 数据来自 GitHub 公开信息 · 原文版权归作者所有