bagisto-shop-advance-theme-development

Shop Advance 主题开发

打造独具特色的店面，同时保留已安装 Bagisto 电商系统、扩展、内容和运行时契约。遵循 Bagisto 官方惯例，根据目标检出版本核对文档，并在启用前验证行为。

不可妥协的规则

• 行动前，阅读所有适用的仓库指令文件。
• 将已安装的代码／配置视为可执行事实来源；使用与版本匹配的 Bagisto 官方来源了解设计意图。
• 对每个主题代码、显示名称、命名空间、包路径、渠道、区域设置、构建路径、工具版本和命令进行参数化或探查。
• 除非用户和仓库政策授权，否则不得编辑 Bagisto Shop 源码、vendor/、生成的构建产物、依赖项、锁文件或线上渠道状态。
• 优先使用精简的视图覆盖层／包。只有在用户接受其升级影响后，才创建完整分支。
• 从已安装的 Shop 包中推导完整的资源运行时；视图回退机制不代表会继承 Vite／JavaScript／CSS。
• 保留布局运行时职责、渲染事件、控制器变量、路由、表单字段、API 结构、产品类型行为和已启用的扩展。
• 配置编辑必须仅合并内容。绝不删除其他主题／提供程序／自动加载映射，也不得在未说明的情况下更改 shop-default。
• 使用试运行和冲突检查。绝不强制发布、删除、将目录替换为符号链接、植入破坏性数据，或自动覆盖冲突。
• 对复制／衍生的源代码，保留 Bagisto 已安装版本的完整许可证声明；在分发前明确选择主题自己的许可证，并核实所有捆绑资源的再分发条款。
• 将生成式设计建议视为候选方案，而非权威指令。拒绝任何会损害电商信息清晰度、无障碍性、性能、许可合规性、商家控制权、已安装依赖或 Bagisto 运行时契约的建议。
• 设计智能仅使用此技能自带的 bagisto-ui-ux 知识和生成器。运行时不得依赖、探查、导入或调用其他设计技能。
• 将“动态”“由管理员控制”和“所有功能均可使用”视为需要证据支持的声明。盘点每个可见界面和已安装／已启用的电商流程；不得仅凭构建成功或首页截图推断这些声明成立。
• 不得仅因设计工具建议就添加动画库、UI 框架、图标包、远程字体、外部脚本或其他依赖。先探查已安装的功能，并在更改依赖或网络设置前取得授权。
• 在任何渠道选择主题前，先完成构建和验证。明确保留回滚方案。

参考文件——仅加载当前任务所需内容

文件	加载时机
workflow.md	需要完整工作流和完成定义时

必需的子技能： 在宣布任何更改已完成前，使用 bagisto-change-verification。