用途:在既有标准 Gear/Vara Sails 应用中修改行为时,提供分阶段工作流,避免跳过流程直接改代码或绕过类型化客户端路径。若涉及已发布合约、新部署版本或 V1→V2 演进,需先经 sails-program-evolution 流程。
主要能力与必要用法:按顺序执行——先在 docs/plans/YYYY-MM-DD-<topic>-spec.md 用 idea-to-spec 与 spec-template.md 明确特性;再用 sails-architecture 与 architecture-template.md 规划架构或公共接口;涉及已发布合约、新版本、切换或迁移时先审阅 sails-program-evolution;需要跨 gstd 选 API 时审阅 gear-gstd-api-map;改动异步行为、回复、延迟、预留或等待列表语义时审阅 gear-message-execution;用 task-decomposer 与 task-plan-template.md 拆解任务;涉及同质化代币、铸造/销毁角色、代币记账或原生价值交换时审阅 awesome-sails-vft;通过 sails-rust-implementer 实现 Rust 改动;公共接口变化时先刷新 .idl 并经仓库标准 build.rs 路径重新生成类型化客户端,专用 Rust 客户端 crate 优先用 sails-rs build-helper;经 sails-gtest 运行 gtest;gtest 通过后再用 sails-local-smoke 做冒烟验证。无 gas 或无签名 UX 参见 voucher-and-signless-flows.md,并在规格与架构中定义凭证或会话流程。
限制:不得因“小”特性跳过文档链;不得用原始载荷编码器、手工 SCALE 载荷或 EVM 风格绑定绕过生成客户端路径;gtest 未通过并记录前不得声称完成;本地节点冒烟不能替代 gtest;已发布合约演进、切换或 V1→V2 迁移不得当作普通特性处理。