linctl — 零摩擦、幂等友好的 Go 后端脚手架工具。两条命令，一次生成，重跑安全。
| 特性 | 说明 |
|---|---|
| 零摩擦上手 | linctl new 生成完整 Go 后端服务骨架（三层架构 / DDD 风格），无需手写样板代码 |
| 幂等重跑 | linctl add 重复执行不会破坏既有代码（AST 注入基于锚点，跳过已有内容） |
| 自我诊断 | linctl lint 检查项目结构与 AST 完整性；linctl doctor 检查工具链 |
| 纯 Go | 无外部依赖运行时；单二进制，嵌入所有模板 |
go install github.com/clin211/linctl@latest或从源码构建：
git clone https://github.com/clin211/linctl.git
cd linctl
make build # → _output/bin/linctl交互式（终端内逐步问答，类似 Vite）： 直接执行 linctl new（需在真实 TTY 中；管道/CI 请用下面的非交互方式）。
非交互 / CI：
linctl new myblog \
--module github.com/foo/myblog \
--storage memory \
--features healthz \
--yes✔ project plan computed (40 files)
✔ scaffold rendered into ./myblog
📦 Next steps:
cd myblog
make deps
make protoc
make build
cd myblog
linctl add Post # 生成 14 个文件 + 4 处 AST 注入
linctl add Comment # 再次添加；重跑幂等✔ resource: Post
+ 14 files created
✏ 4 files updated via AST
📦 Next steps:
make protoc
go mod tidy
go build ./...
linctl lint # 检查目录结构 + AST 锚点
linctl lint --fix # 自动修复缺失的锚点注释
linctl doctor --offline # 检查工具链（跳过网络检查）| 命令 | 说明 |
|---|---|
linctl new <project> |
生成新项目骨架（三层架构，借鉴 DDD） |
linctl add <Resource>... |
在已有项目中添加全栈业务资源 |
linctl lint [--fix] |
校验项目结构与 AST 锚点完整性 |
linctl doctor [--offline] |
检查本地工具链与运行环境 |
linctl version |
打印版本信息 |
linctl completion <shell> |
生成 shell 补全脚本（bash/zsh/fish/powershell） |
全局 flag：--log-level / --log-format / -C, --chdir / --no-color / --non-interactive / -y, --yes
myblog/
├── cmd/myblog/ # 主入口
├── internal/myblog/
│ ├── handler/ # HTTP handlers (gin)
│ ├── biz/v1/<resource>/ # 业务逻辑层
│ ├── store/ # 数据存储层
│ └── model/ # 数据模型
├── internal/pkg/errno/ # 错误码统一管理
├── pkg/api/<app>/v1/ # Proto 定义 + 占位 Go 类型
└── ...
v2 重构了命令集，不再支持 v1 的 plan/apply 范式；v2 的可执行文件名为 linctl（入口位于仓库根目录）。
| v1 命令 | v2 对应 | 说明 |
|---|---|---|
linctl plan |
linctl add --dry-run |
预览生成计划 |
linctl apply |
linctl add |
执行生成 |
linctl new |
linctl new |
生成项目骨架 |
| — | linctl lint |
v2：AST 完整性检查 |
| — | linctl doctor |
v2：工具链检查 |
详细迁移指引见 docs/features/06-migration-plan.md。
make all # lint + test + build
make test # 单元测试（含 race detector）
make e2e # 端到端测试（new / add / lint / doctor）
make vet # go vet需要 Go >= 1.22。