SuperAPI AI 工具集

init-project

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

用途:从内置的冻结模板脚手架出一个全新的 Go 六边形架构 / DDD 微服务。模板是 account-service 架构的空但可运行快照,包含清晰分层、工具链、基础设施接线、.kiro/ 引导文件与 CLAUDE.md,且不含任何业务域。生成的项目可立即构建并提供 GET /health,便于 neo(或 Kiro)无需额外配置即可添加首个域。该技能只创建空骨架,编写域、AC、端点与测试由 neo 技能负责。

主要能力:生成完整服务骨架,包括 cmd/api(组合根)、config、internal/delivery/http/{router,middleware}(含 /health)、internal/adapters/repository/{postgres,redis,cache}、pkg/{clock,idgen,cache/valkey,lib/kafka};工具链含 Makefile、Dockerfile、docker-compose.yaml(postgres + valkey + kafka)、.gitlab-ci.yml、.golangci.yaml、.mockery.yaml、sqlc.yaml 及固定版本 tools/* 模块;代理上下文含 .kiro/steering/*、.kiro/{skills,agents} 与 CLAUDE.md。internal/core/{domain,usecase}、gateways 与 HTTP handlers 由 neo 创建,骨架本身不含。启动路径为尽力而为:即使没有 Postgres / Redis / Kafka,go run ./cmd/api 也能提供 /health(仅警告并继续,不会因缺少基础设施而 panic)。

使用方式:先收集四项信息——模块路径(如 gitlab.awesome-poc-th.com/libero-engineering/core/<svc>)、服务名(kebab-case)、服务 id(大写短 id,用于错误信封 / tracer)、目标目录。确认后运行:python3 <skill-dir>/assets/scaffold.py --target-dir <dir> --module-path <mod> --service-name <name> --service-id <id>。该脚本复制冻结模板、替换三个哨兵值、执行 go mod tidy、git init 与 go build ./...。若因私有模块认证失败,可加 --no-build 重跑,并提示用户在有权限后执行 go mod tidy && go build ./...。随后运行 L1 确定性校验:python3 <skill-dir>/assets/initcheck.py --target-dir <dir> --module-path <mod> --service-name <name> --service-id <id>,所有检查须 PASS。再派发 L2 全新视角验证子代理,按 references/init-verifier.md 的契约独立确认项目确为空且可运行的骨架。最后报告项目位置、可构建并响应 /health,以及下一步 cd <dir> && go run ./cmd/api(curl localhost:8080/health),再用 /neo 添加首个域。

适用场景:需要按组织约定快速起一个空 Go 微服务骨架,并希望后续由 neo / Kiro 添加业务域时无需额外配置。

限制:需要 PATH 上有 Go ≥ 1.26;模板依赖组织私有 common-lib,需为模块主机设置 GOPRIVATE 并具备可用 git 凭据(SSH 或 ~/.netrc),否则 go mod tidy / go build 会因认证失败,此时可用 --no-build 创建项目。内置模板为 assets/template/ 下的冻结快照(哨兵模块路径 example.com/neo/service、名称 neo-service、id NEOSVC),刷新方式见 references/init-project-guide.md。通用引导占位符({{MODULE_PATH}}、<Domain> 等)有意保留未解析,供 neo 按域填写,生成时只替换三个哨兵值。其他收费、平台与效果信息暂未提供。