mini-program-architecture-skill

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