SuperAPI AI 工具集

sails-program-evolution

设计与创作

查看项目

更新于 10-15 21:50

技能介绍

用途:当工作不再只是实现功能,而需要思考已发布 Sails 合约的版本化、兼容性、切换、ReadOnly 处理、前端/索引器影响或 V1 到 V2 迁移时使用。

主要能力:先对变更分类(增量、破坏性、仅迁移准备、立即迁移);将 Gear/Sails 演进视为 V1 -> V2 -> 切换,而非原地热替换线上合约代码;保持公开路由、回复结构和事件稳定,除非架构明确版本化;明确合约版本、状态与切换行为;若需迁移,拆分 V1、V2 与链下迁移器职责;在实现前记录前端、生成客户端与索引器影响。

使用方式:先阅读 ../../references/contract-interface-evolution.md、../../references/gear-sails-production-patterns.md、../../references/sails-idl-client-pipeline.md 和 ../../references/sails-program-and-service-architecture.md;使用 ../../assets/architecture-template.md 写架构说明,使用 ../../assets/task-plan-template.md 写有序任务计划;输出到 docs/plans/YYYY-MM-DD-<topic>-architecture.md 和 docs/plans/YYYY-MM-DD-<topic>-tasks.md。实现可路由到 ../sails-architecture/SKILL.md、../task-decomposer/SKILL.md、../sails-rust-implementer/SKILL.md、../sails-idl-client/SKILL.md 和 ../sails-local-smoke/SKILL.md。

适用场景:已发布合约需要新增部署版本;公开路由、回复或事件可能变化;切换期间需保持前端或索引器兼容;旧合约可能需要 ReadOnly 或禁用写入;即使暂不实现迁移也需设计未来迁移路径;V1 到 V2 状态迁移在范围内。

限制与护栏:不要把 Gear/Sails 演进描述为原地替换线上合约代码;不要用笼统的“更新合约”措辞掩盖兼容性敏感变更;不要随意更改已发布的公开路由或事件负载;不要仅凭 IDL 重新生成就认为安全上线;不要把 V1、V2 和迁移器职责合并为一个模糊实现步骤。其他具体收费、平台或效果信息暂未提供。