القائمة
针对 COLA 架构项目的架构方案设计，基于已有的 COLA 架构、技术栈和规范，设计符合项目约束的新功能或模块的架构方案。关注与现有系统的集成、核心流程设计、数据模型和关键实现细节。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
在后端项目中设计或修改接口、DTO、错误码、鉴权、幂等、分页、批量操作和前后端联调契约时使用。适用于后端 profile，输出清晰的接口边界、兼容风险和验证路径。
将后端技术方案拆解为接口、应用服务、领域/业务逻辑、数据访问、消息/定时任务、迁移脚本和测试任务时使用。用于补充通用 implementation-planning 的后端归组口径。
分析后端接口、数据库访问、RPC/HTTP 调用、批处理、消息消费、事务和缓存相关性能风险时使用。强调证据、数据规模、低风险优化和回滚方案。
前端接入接口、修复提交失败、核对列表/详情/保存字段、处理类型漂移或空值风险时使用。输出契约不一致点、收敛方案和回归建议。
排查并修复前端渲染、状态、表单、表格、路由、API 映射、异步时序和性能回归问题时使用。要求可复现、可定位、可验证、最小修复。
在既有前端项目中新增或扩展页面、表单、列表、弹窗、批量操作、导入导出和权限交互时使用。强调先理解调用链、复用现有结构、最小改动落地。
| name | cola-architecture |
| displayName | COLA 架构方案设计 |
| description | 针对 COLA 架构项目的架构方案设计，基于已有的 COLA 架构、技术栈和规范，设计符合项目约束的新功能或模块的架构方案。关注与现有系统的集成、核心流程设计、数据模型和关键实现细节。 |
| triggers | ["架构方案","架构设计","系统设计","COLA设计"] |
| autoTrigger | true |
| version | 1.0.2 |
当用户提出 COLA 架构项目的新功能或模块需求时，基于已有的 COLA 架构体系、技术栈和项目规范，引导并生成一份结构完整、符合约束的架构方案设计文档。
最重要的规则：必须严格遵守项目的现有技术栈、架构规范和约束条件。当你无法从对话上下文或已提供信息中推断出某个模版部分的内容时，你必须主动、明确地向用户提问，等待用户补充。
[待补充：具体缺失信息]。在执行本 skill 之前，先检查项目的技术栈声明：
AGENTS.md 文件techStack 字段或"技术栈"章节cola-java：继续执行本 skillcola-java：跳过本 skill，提示：
当前项目的技术栈为 {techStack}，COLA 架构方案设计 skill 不适用。将使用通用
tech-designskill 进行方案设计。
AGENTS.md 不存在：退回到通用 tech-design skill，并建议用户先执行 /init 初始化项目画像SV-xxxxx-architecture.md（关联需求编号）docs/design/ 目录补充规则：核心章节必须保留；标记为"如涉及""如需"的章节，仅在当前需求确实涉及时展开，不涉及时可整节省略。
adapter 层新增：
- controller/web/模块名/XxxController.java（前端页面，路径 /web/）
- controller/api/模块名/XxxApiController.java（对外接口，路径 /api/）
- controller/center/模块名/XxxCenterController.java（内部服务，路径 /center/）
- consumer/模块名/XxxConsumer.java（MQ 消费者，如涉及）
- scheduler/模块名/XxxScheduler.java（定时任务，如涉及）
application 层新增：
- executor/模块名/cmd/XxxCmdExe.java（命令执行器）
- executor/模块名/qry/XxxQryExe.java（查询执行器）
- service/模块名/XxxService.java（服务编排）
- convertor/模块名/XxxConvertor.java（MapStruct 转换器，如需）
client 层新增：
- 模块名/api/IXxxApi.java（API 接口定义）
- 模块名/command/XxxCmd.java / XxxQry.java（Command / Query DTO）
- 模块名/dto/XxxDTO.java（返回 DTO）
infrastructure 层新增/修改：
- gateway/模块名/IXxxGateway.java（Gateway 接口）
- gateway/模块名/impl/XxxGateway.java（Gateway 实现，@DS + ServiceRepository）
- repository/模块名/IXxxRepository.java（MyBatis Mapper 接口）
- dataobject/模块名/XxxDO.java（数据库实体）
- convertor/模块名/XxxConvertor.java（MapStruct DO↔DTO 转换器，如需）
- mongodb/gateway/模块名/XxxMongoGateway.java（MongoDB Gateway，如涉及）
- mongodb/dataobject/模块名/XxxMongoDO.java（MongoDB 数据对象，如涉及）
- es/模块名/XxxEsGateway.java（Elasticsearch Gateway，如涉及）
说明使用哪个数据源（db-mysql-auto-choose / db-sharding / db-sqlserver-write），Gateway 的 @DS 注解值。
说明分表策略（amazon-site-code / year-month-code / hash-code 等）、分片列、分片数量。
说明缓存范围（CacheScope.REMOTE / LOCAL / BOTH）、过期策略、缓存 key 规则。