name	cola-naming
displayName	COLA 命名规范指导
description	在 COLA 架构项目中，指导新类、接口、方法的命名，确保符合项目已有的命名约定。
triggers	["命名规范","类命名","COLA命名"]
autoTrigger	false
version	1.0.2

COLA 命名规范指导

技能目标

当用户需要在 COLA 架构项目中创建新类、接口或方法时，指导其使用正确的命名约定，与项目已有风格保持一致。

前置检查：技术栈适用性

在执行本 skill 之前，先检查项目的技术栈声明：

读取项目根目录的 AGENTS.md 文件
检查 frontmatter 中的 techStack 字段或"技术栈"章节
如果技术栈为 cola-java：继续执行本 skill
如果技术栈不是 cola-java：跳过本 skill，不应用 COLA 命名规范
如果 AGENTS.md 不存在：跳过本 skill，建议用户先执行 /init

命名规则速查

按层级

层级	类型	命名规则	路径/说明	示例
adapter	API Controller	XxxApiController	`controller/api/模块名/`，URL `/api/`	AiTitleBuildApiController
adapter	页面 Controller	XxxController	`controller/web/模块名/`，URL `/web/`	AmazonStockBlackController
adapter	内部服务入口	XxxCenterController	`controller/center/模块名/`，URL `/center/`	AmazonFbaStockOutViewController
adapter	MQ 消费者	XxxConsumer	`consumer/模块名/`	AdjustPriceStrategyConsumer
adapter	定时任务	XxxScheduler	`scheduler/模块名/`	InventorySyncScheduler
application	命令执行器	XxxCmdExe	`executor/模块名/cmd/`	AdjustPriceBatchCmdExe
application	查询执行器	XxxQryExe	`executor/模块名/qry/`	FbaAsinDataQryExe
application	服务编排	XxxService	`service/模块名/`	OrderService
infrastructure	Gateway 接口	IXxxGateway	`gateway/模块名/`	IAdjustPriceStrategyGateway
infrastructure	Gateway 实现	XxxGateway	`gateway/模块名/impl/`	AdjustPriceStrategyGateway
infrastructure	MyBatis Mapper	IXxxRepository	`repository/模块名/`	IOrderRepository
infrastructure	数据对象	XxxDO	`dataobject/模块名/`	OrderDO
infrastructure	转换器	XxxConvertor	`convertor/模块名/`	OrderConvertor
client	API 接口	IXxxApi	`模块名/api/`	IAmazonFbaVineReasonsApi
client	命令 DTO	XxxCmd / XxxQry	`模块名/command/`	AmazonFbaVineReasonsAddCmd
client	返回 DTO	XxxDTO	`模块名/dto/`	AmazonFbaVineReasonsDTO

通用规则

新增类名先匹配现有职责和目录，再决定后缀
避免使用模糊命名：Manager、Helper、UtilService
方法命名使用动词开头：findXxx、createXxx、updateXxx、deleteXxx
布尔方法使用 isXxx、hasXxx、canXxx
新增顶层 Java 类如需 @author，只读取全局用户配置 ~/.cursor/coding-exoskeleton/user-config.json；修改已有类时不新增或改写作者注释

使用方式

在编码阶段，当需要创建新类时，参照以上规则确定命名。如果现有项目中有偏差（已有类名不符合规范），以项目已有风格为准，保持一致性。

Más de este repositorio

mismo repositorio

backend-api-contract

leikegeek/coding-exoskeleton

在后端项目中设计或修改接口、DTO、错误码、鉴权、幂等、分页、批量操作和前后端联调契约时使用。适用于后端 profile，输出清晰的接口边界、兼容风险和验证路径。

2026-06-013

backend-implementation-planning

leikegeek/coding-exoskeleton

将后端技术方案拆解为接口、应用服务、领域/业务逻辑、数据访问、消息/定时任务、迁移脚本和测试任务时使用。用于补充通用 implementation-planning 的后端归组口径。

2026-06-013

backend-performance-analysis

leikegeek/coding-exoskeleton

分析后端接口、数据库访问、RPC/HTTP 调用、批处理、消息消费、事务和缓存相关性能风险时使用。强调证据、数据规模、低风险优化和回滚方案。

2026-06-013

frontend-api-contract-check

leikegeek/coding-exoskeleton

前端接入接口、修复提交失败、核对列表/详情/保存字段、处理类型漂移或空值风险时使用。输出契约不一致点、收敛方案和回归建议。

2026-06-013

frontend-bug-triage

leikegeek/coding-exoskeleton

排查并修复前端渲染、状态、表单、表格、路由、API 映射、异步时序和性能回归问题时使用。要求可复现、可定位、可验证、最小修复。

2026-06-013

frontend-feature-implementation

leikegeek/coding-exoskeleton

在既有前端项目中新增或扩展页面、表单、列表、弹窗、批量操作、导入导出和权限交互时使用。强调先理解调用链、复用现有结构、最小改动落地。

2026-06-013

COLA 命名规范指导

技能目标

当用户需要在 COLA 架构项目中创建新类、接口或方法时，指导其使用正确的命名约定，与项目已有风格保持一致。

前置检查：技术栈适用性

在执行本 skill 之前，先检查项目的技术栈声明：

读取项目根目录的 AGENTS.md 文件

检查 frontmatter 中的 techStack 字段或"技术栈"章节

如果技术栈为 cola-java：继续执行本 skill

如果技术栈不是 cola-java：跳过本 skill，不应用 COLA 命名规范

如果 AGENTS.md 不存在：跳过本 skill，建议用户先执行 /init

命名规则速查

按层级

层级

类型

命名规则

路径/说明

示例

adapter

API Controller

XxxApiController

controller/api/模块名/，URL /api/

AiTitleBuildApiController

adapter

页面 Controller

XxxController

controller/web/模块名/，URL /web/

AmazonStockBlackController

adapter

内部服务入口

XxxCenterController

controller/center/模块名/，URL /center/

AmazonFbaStockOutViewController

adapter

MQ 消费者

XxxConsumer

consumer/模块名/

AdjustPriceStrategyConsumer

adapter

定时任务

XxxScheduler

scheduler/模块名/

InventorySyncScheduler

application

命令执行器

XxxCmdExe

executor/模块名/cmd/

AdjustPriceBatchCmdExe

application

查询执行器

XxxQryExe

executor/模块名/qry/

FbaAsinDataQryExe

application

服务编排

XxxService

service/模块名/

OrderService

infrastructure

Gateway 接口

IXxxGateway

gateway/模块名/

IAdjustPriceStrategyGateway

infrastructure

Gateway 实现

XxxGateway

gateway/模块名/impl/

AdjustPriceStrategyGateway

infrastructure

MyBatis Mapper

IXxxRepository

repository/模块名/

IOrderRepository

infrastructure

数据对象

XxxDO

dataobject/模块名/

OrderDO

infrastructure

转换器

XxxConvertor

convertor/模块名/

OrderConvertor

client

API 接口

IXxxApi

模块名/api/

IAmazonFbaVineReasonsApi

client

命令 DTO

XxxCmd / XxxQry

模块名/command/

AmazonFbaVineReasonsAddCmd

client

返回 DTO

XxxDTO

模块名/dto/

AmazonFbaVineReasonsDTO

通用规则

新增类名先匹配现有职责和目录，再决定后缀

避免使用模糊命名：Manager、Helper、UtilService

方法命名使用动词开头：findXxx、createXxx、updateXxx、deleteXxx

布尔方法使用 isXxx、hasXxx、canXxx

新增顶层 Java 类如需 @author，只读取全局用户配置 ~/.cursor/coding-exoskeleton/user-config.json；修改已有类时不新增或改写作者注释

使用方式

在编码阶段，当需要创建新类时，参照以上规则确定命名。如果现有项目中有偏差（已有类名不符合规范），以项目已有风格为准，保持一致性。