/mini-program-architecture-skill — 小程序工程架构
把已经确认的产品语义映射为可实现、可验证、可迁移和可回滚的工程方案。架构服务于产品约束,不改变产品语义来迁就技术方案。
进入条件与边界
- 需要一份稳定的产品规格、明确功能边界,或现有项目的只读事实图。
- 已有项目先读取规则、当前源码与配置、Git 状态和必须保护的用户改动;优先延续已经有效的工程模式。
- 若目标用户、主流程或关键数据规则仍有实质冲突,退回产品决策点,不用架构选择掩盖歧义。
- 不直接实现代码,不决定未确认的按钮、奖励、付费、权限理由或业务状态。
架构流程
- 列出输入事实、产品不变量、质量目标、约束、未知项和不在本轮范围内的内容。
- 将页面职责映射为页面、组件、领域服务、平台适配层和外部依赖,明确每层所有权。
- 为关键事实指定唯一规范状态源,说明派生状态、生命周期、刷新时机与跨页同步。
- 定义数据模型、标识、版本、校验、读写边界和敏感字段;说明本地、云端或第三方的权威关系。
- 定义 API 或云函数契约、认证与权限、错误分类、超时、重试、降级和可观察证据。
- 针对重复请求、离线恢复、多端写入和异步回调,明确缓存、并发、幂等与一致性策略。
- 若涉及存量数据或接口,写出兼容、迁移、灰度、回滚条件和失败后的恢复路径。
- 比较至少一个可行替代方案,记录选择理由、代价和需要重新评估的触发条件。
- 使用 架构工作流 自检,并按 架构决策记录模板 输出 ADR 与实施交接。
最低输出
- 架构范围、事实、产品不变量、质量目标与未知项。
- 页面/组件/服务/平台层边界及依赖方向。
- 状态源、数据模型、接口、权限与失败策略。
- 缓存、并发、幂等、一致性、迁移和回滚方案。
- 外部依赖风险、可观察性和对应产品验收行为。
- ADR:选择、替代方案、代价、验证方式与重新评估条件。
停止条件
关键产品语义未确认、当前项目存在无法保护的未知改动、核心外部能力不可核验,或数据迁移没有可接受回滚路径时,停止并报告具体缺口。不要用“实现时再说”隐藏高影响决策。
独立与套件协作
独立安装时,本 Skill 可基于给定规格完成架构设计。位于完整套件中时,遵守共享工程门禁和证据状态;只接收阶段产物、输出 ADR 和实施边界,不调用其他组件脚本。