SuperAPI AI 工具集

gear-architecture-planner

通用与其它

查看项目

更新于 10-15 21:50

技能介绍

用途:当已有获批的 Gear 或 Vara 规格说明,需要将其落地为具体的 Gear/Sails 架构笔记时使用;若功能尚未确定或规格未获批,则不应使用。

主要能力:确认规格产物存在且已批准;选择程序构造器与服务边界;梳理状态归属、路由、消息、回复与事件;记录生成 IDL 或生成客户端的影响;记录链下组件、失败路径与明确的非目标。

使用方式:先阅读 references 下的 vara-domain-overview.md、sails-cheatsheet.md、sails-program-and-service-architecture.md、gear-messaging-and-replies.md、sails-idl-client-pipeline.md;若架构选择取决于 gstd 能表达的内容,先查看 ../gear-gstd-api-map/SKILL.md;以 assets/architecture-template.md 作为输出形态,结果写入 docs/plans/YYYY-MM-DD-<topic>-architecture.md。

约束:保持 #[program] 精简,业务逻辑放入服务;明确构造器形态与存储模式;默认以生成客户端或等价的路由前缀编码作为 Sails 消息契约;把 actor 边界与异步流视为设计约束;显式说明远程调用失败策略;不要把架构退化为逐文件编码清单。

适用场景:Gear/Vara 项目的架构设计阶段。限制:仅适用于已批准规格;具体命令、收费与平台信息暂未提供。