用途:该技能把 Sphere 框架的开发任务转化为可执行步骤,先识别所属层次(协议/代码生成、运行时包、模板、支撑库),再按标准流程(定义→生成→实现→校验)执行,并严格区分可编辑源文件与生成产物。
主要能力与用法: 新建项目:sphere-cli create --name <project_name> --module <module_path>,随后 cd <project_name>、make gen/all、make run。 API 变更:编辑 proto 后执行 make gen/proto,再实现服务与路由注册并运行。 数据模型变更:编辑 ent schema 后执行 make gen/db,如需再执行 make gen/proto,并执行 make gen/wire 刷新依赖注入。 全量生成:make gen/all。注意 gen/proto 依赖 gen/db,跨仓库时建议保持 gen/db → gen/proto → gen/wire 顺序。
代码边界:api/、internal/pkg/database/ent/、cmd/app/wire_gen.go、swagger/ 属于生成产物,不应手动编辑;proto 文件、schema、service、server web.go、wire.go 及运行配置为可编辑源。
限制与注意事项:sphere-cli 仅支持 create 与 rename;service 命令仅将模板内容打印到标准输出,建议据此手工创建文件。若目标仓库不符合标准布局,不应假定固定路径,需先阅读真实结构再映射流程。代码生成缺失、路由 404、鉴权 401、Wire DI 错误、DB/缓存连接问题等应查阅快速参考文档。