pma-go

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Use this skill together with

/pma

/pma

controls workflow, approval, and task tracking; this guide defines the implementation baseline after approval.

Keep this entry file lean. Load only the reference packs needed for the task.

请将本指南与

/pma

配合使用。

/pma

负责管控工作流、审批和任务追踪；本指南定义了审批通过后的实现基线。

请保持此入口文件简洁，仅加载任务所需的参考包。

For PMA-managed Go backends, API services, and CLI applications.

Not for embedded targets, library-only modules without binaries, or non-PMA projects.

适用于PMA管理的Go后端、API服务和CLI应用。

不适用于嵌入式目标、无二进制文件的纯库模块，或非PMA项目。

Always load
```
references/baseline.md
```
first.
Load
```
references/config-and-data.md
```
for config layering, validation, sqlc, pgx, GORM, and migrations.
Load
```
references/http-and-runtime.md
```
for handlers, middleware, logging, observability, and shutdown.
Load
```
references/delivery.md
```
for lint, tests, task runners, security review, CI, and Git workflow.

New service or CLI setup:
```
references/baseline.md
```
koanf config, env mapping, DB access, migrations, repository boundaries:
```
references/config-and-data.md
```
HTTP server, response envelopes, auth middleware, slog, tracing, shutdown:
```
references/http-and-runtime.md
```
quality gates, lint, tests, Taskfile, security checklist, CI, PR readiness:
```
references/delivery.md
```

```
references/baseline.md
```
Stack defaults, quality gates, layout, conventions, error model, and code quality standards.
```
references/config-and-data.md
```
Config layering with koanf, validation, sqlc plus pgx, GORM alternative, and migration rules.
```
references/http-and-runtime.md
```
Router structure, handler patterns, middleware, logging, observability, and graceful shutdown.
```
references/delivery.md
```
Lint config, testing, task runner expectations, security checks, CI, and Git conventions.

If the repo already diverges from these defaults, make the divergence explicit and apply it consistently across code, docs, and CI.

```
references/baseline.md
```
技术栈默认配置、质量门禁、项目结构、规约、错误模型和代码质量标准。
```
references/config-and-data.md
```
基于koanf的分层配置、校验、sqlc+pgx、GORM替代方案，以及数据迁移规则。
```
references/http-and-runtime.md
```
路由结构、处理器模式、中间件、日志、可观测性和优雅关停。
```
references/delivery.md
```
代码检查配置、测试、任务执行器要求、安全检查、CI和Git规约。

如果代码库已经偏离这些默认配置，请明确标注差异点，并在代码、文档和CI中统一应用。