Pet-Game 工作流 Skill
本 Skill 定义了 Pet-Game 小程序项目的版本控制和工作流规范。 AI 助手在进行任何文件修改前必须遵守以下规则。
1. 版本控制系统概述
备份文件结构
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
2. 强制备份规则（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 必须自觉遵守，不能等主人提醒
- 违规后果：主人会生气 😡
3. AI 工作流程
标准流程
- 收到文件修改任务
- 立即执行备份：
python .qtools\backup_wrapper.py backup <相对路径> [元素名] - 等待备份成功（确认输出 "Backup saved" 或类似信息）
- 修改文件
- 如果修改 >3 次，备份脚本会自动建元素快照
- Git commit 后执行清理：
python .qtools\backup_wrapper.py clean
禁止行为 ❌
- 跳过备份直接修改文件
- 等主人提醒才备份
- 忘记在 git commit 后执行清理
- 同一元素调整超过 3 次但不建元素快照
4. 触发条件
本 Skill 在以下场景自动触发：
- 任何修改
pet-game/目录下的文件（WXML/WXSS/JS/JSON/MD 等） - 任何 Git commit 操作后
- 任何元素位置调整、样式修改、功能变更
5. 相关文件
- 备份脚本：
.qtools/backup_wrapper.py - 备份区：
.backups/ - 元素快照：
.backups/ELEMENT-SNAPSHOTS.md - 项目根目录：
C:\Users\marsz\.qclaw\workspace\pet-game
6. 注意事项
- 每次修改前必须备份，这是最高优先级规则
- 备份脚本会自动处理时间窗口和元素追踪
- Git commit 后必须执行���理
- 如果不确定是否需要备份，默认执行备份
- 禁止跳过任何备份步骤
⚠️ 警告：不遵守本规则将导致主人不满。AI 必须自觉执行备份！