go-service-template-rest：面向AI辅助开发的Go语言生产级服务模板

本文解析的go-service-template-rest项目，是专为AI辅助编程工作流设计的Go语言REST服务模板，核心提供编排器优先的工作流程、项目级智能体、可移植技能库及完整生产级技术栈，旨在填补AI原生开发仓库在Go语言生态细节上的不足，确保AI助手产出符合Go惯用法、能通过代码审查的生产级代码。

随着Codex、Claude Code等AI编程助手普及，个人开发者工作方式发生变化，但多数AI原生仓库擅长需求分析与任务规划，却在具体编程语言生态（尤其是Go）中力不从心。本项目针对Go后端特殊性，提供从架构设计到代码审查的完整工作流指导，解决这一短板。

编排器优先的工作流

采用显式多阶段工作流（需求摄入→规划→研究→决策→规格定义→编码等），每个阶段有明确输入输出及会话包装器，使AI辅助开发可追踪、可审查。

Go原生指导

深入Go生态细节：正确处理goroutine/channel、Go惯例错误处理、sqlc生成类型安全数据库代码、chi路由器构建HTTP处理链。

项目级智能体与可移植技能

定义专业智能体（架构、API等）提供分析建议；技能为可复用工作流手册，存储于.agents/skills目录，跨项目复用。

OpenAPI优先的HTTP层

以OpenAPI规范为API设计起点，配合chi路由器，保证契约清晰且符合Go惯用处理链模式。

PostgreSQL与sqlc的数据层

选择PostgreSQL+sqlc，sqlc根据SQL生成Go代码，兼顾SQL表达力与编译时类型检查。

可观测性内置

预置日志、指标、追踪集成点，支持生产环境故障排查与性能优化。

CI/CD门禁

包含测试、代码风格检查、构建验证，确保代码质量。

从需求到规格

需求摄入→规划执行策略→并行调用领域智能体研究→综合决策→预规格挑战→规格定义为spec.md并进行澄清。

从设计到实现

技术设计转化为任务方案→分解为tasks.md（含ID、依赖、验证证据）→严格按tasks.md编码。

验证与关闭

需提供命令证据证明完成，不允许创建新规划工件，防止范围蔓延。

项目定义14个专业智能体，覆盖后端开发各维度：

• 架构智能体：模块边界、所有权划分
• API智能体：契约行为与HTTP语义
• 并发智能体：goroutine/channel正确性
• 数据智能体：数据源、模式演进
• 领域智能体：业务不变量
• 可靠性智能体：超时、重试策略
• 安全智能体：认证、租户隔离
• 可观测性智能体：日志、指标设计
• 性能智能体：瓶颈分析
• 质量智能体：代码审查
• QA智能体：测试义务定义 每个智能体职责明确，避免重叠。

适用场景：

1. 个人开发者（用AI工具需保持代码质量）
2. 小型团队（需可复现流程与审查标准）
3. Go学习者（了解生产级服务组织）
4. AI工作流探索者（整合AI到工程流程） 使用建议：从理解workflow-plan.md、spec.md、tasks.md开始，参与完整功能生命周期掌握协作模式。

本项目代表AI辅助开发方向：通过结构化工作流与领域指导放大开发者能力，而非取代判断。为Go社区提供AI时代软件工程实践讨论切入点，未来将随AI工具演进持续发展。