该技能用于组件分解与逐组件事实补全。cell-design 技能声明存在什么,本技能负责决定分解方式并补全每个组件的 design.json。
用途与流程:平台在保存 cell 时为每个可部署组件生成 specs/design/components/<id>/design.json 脚手架,含 name、type、version、buildpack、appPath、entrypoint、默认 exposure 及 "language": "TBD"。本技能负责判断字段,构建门禁会拒绝未补全的组件。
主要能力:决定 language(顺序为组织技能技术栈默认、需求指定语言、平台默认——后端服务用 Ballerina,Web 应用用 TypeScript),替换 TBD;编写 dependencies;撰写一段 description(单一职责、端口/入口预期、明确不做什么);在组件 design.json 中写入 skillsPinned 数组(使用目录中的精确名称,如 Ballerina API 服务为 ["openapi-conventions", "ballerina"],Web 应用为 ["wireframes", "react-webapp"],网关后服务加 "api-management",登录两侧加 "thunder-authentication")。stories 由平台根据 cell 引用重算,不应在此编写。
组件推导:组件是一个可独立部署单元,而非领域概念。需求出现独立用户界面、不同运行时或伸缩特征、系统其他部分不共享的技术、或明确独立生命周期时才拆分为独立组件。不要按实体、领域概念、分层或基础设施拆分;api-gateway、数据库、队列、认证服务器永远不是组件。组件名用 kebab-case 按职责命名。type 使用固定词汇:后端为 "service",浏览器应用为 "web-application"(必须逐字,不能写 webapp 等)。平台仅安装 service 与 web-application 类型。
依赖:dependencies 与 Interactions 箭头一一对应,kind 有 component、org-service、platform-resource、external 四种,各自有专属字段。编写前先用对应工具发现,不要凭需求措辞臆造名称。外部依赖按复用注册资源、web_search 候选、分类 style、解析契约的顺序处理;有明确信号则解析,无信号且有多个等价选项则给出 candidates,无法识别则留 style-less 条目。
限制:含密钥的依赖应放在服务而非 Web 应用;thunder-app 需在 SPA 与受保护服务上以相同依赖名声明;平台拥有的字段(exposesAPI、componentAgentInstructions、依赖 status/reason、依赖 wiring、stories)不要自行编写。修改 design.json 需整体重发文件,不要用锚定编辑打补丁。