Pet-Game workflow — Pet-Game 工作流程

Pet-Game 工作流 Skill 本 Skill 定义了 Pet-Game 小程序项目的版本控制和工作流规范。 AI 助手在进行任何文件修改前必须遵守以下规则。

• 版本控制系统概述

备份文件结构 pet-game/ ├── .qtools/ # 工具脚本 │ └── backup_wrapper.py # 备份入口脚本 ├── .backups/ # 备份区 │ ├── baselines/ # 基准快照 │ ├── elements/ # 频繁元素快照 │ └── state.json # 版本状态 └── skills/ └── pet-game-workflow/ # 本 Skill └── SKILL.md # 工作流规则

备份脚本使用方法 # 备份单个文件（修改前必须执行） python .qtools\backup_wrapper.py backup <相对路径> [元素名] # 示例 python .qtools\backup_wrapper.py backup subpk-home/pages/home/home.wxml BGM开关 # Git commit 后清理备份 python .qtools\backup_wrapper.py clean

• 强制备份规则（AI 必须遵守）

规则 1：修改前必须备份 ⚠️ 触发条件：任何文件修改（WXML/WXSS/JS/JSON/MD 等） 动作：先执行 python .qtools\backup_wrapper.py backup <相对路径> [元素名] 违规后果：主人会生气 示例： # 修改 home.wxml 前 python .qtools\backup_wrapper.py backup subpk-home/pages/home/home.wxml BGM开关 # 然后才能修改文件

规则 2：时间窗口 规则：5 分钟内同文件只保留第一个备份 实现：backup_wrapper.py 自动检查 .backups\state.json 中的 lastBackupTime AI 无需判断，脚本自动处理

规则 3：元素追踪 规则：同一元素调整超过 3 次 → 自动建元素快照 实现：backup_wrapper.py 自动追踪元素调整次数（基于 [元素名] 参数） AI 无需判断，脚本自动处理

规则 4：Git Commit 后清理 触发条件：执行 git commit 后 动作：执行 python .qtools\backup_wrapper.py clean 示例： git commit -m "fix: xxx" python .qtools\backup_wrapper.py clean

规则 5：禁止跳过备份 禁止行为：跳过备份直接修改文件 AI 必须自觉遵守，不能等主人提醒 违规后果：主人会生气

• AI 工作流程

标准流程 收到文件修改任务 立即执行备份：python .qtools\backup_wrapper.py backup <相对路径> [元素名] 等待备份成功（确认输出 "Backup saved" 或类似信息） 修改文件 如果修改 >3 次，备份脚本会自动建元素快照 Git commit 后执行清理：python .qtools\backup_wrapper.py clean

禁止行为 ❌ 跳过备份直接修改文件 等主人提醒才备份 忘记在 git commit 后执行清理 同一元素调整超过 3 次但不建元素快照

• 触发条件

本 Skill 在以下场景自动触发： 任何修改 pet-game/ 目录下的文件（WXML/WXSS/JS/JSON/MD 等） 任何 Git commit 操作后 任何元素位置调整、样式修改、功能变更

• 相关文件

备份脚本：.qtools/backup_wrapper.py 备份区：.backups/ 元素快照：.backups/ELEMENT-SNAPSHOTS.md 项目根目录：C:\Users\marsz\.qclaw\workspace\pet-game

• 注意事项

每次修改前必须备份，这是最高优先级规则 备份脚本会自动处理时间窗口和元素追踪 Git commit 后必须执行清理 如果不确定是否需要备份，默认执行备份 禁止跳过任何备份步骤 ⚠️ 警告：不遵守本规则将导致主人不满。AI 必须自觉执行备份！