Pet-Game 工作流 Skill#

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

---

1. 版本控制系统概述#

备份文件结构#

text

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

备份脚本使用方法#

bash

# 备份单个文件（修改前必须执行）
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 <相对路径> [元素名]

• 违规后果：主人会生气 😡

• 示例： bash

  # 修改 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

• 示例： bash

  git commit -m "fix: xxx"
  python .qtools\backup_wrapper.py clean
  
  

规则 5：禁止跳过备份#

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

---

3. AI 工作流程#

标准流程#

1. 收到文件修改任务
2. 立即执行备份： python .qtools\backup_wrapper.py backup <相对路径> [元素名]
3. 等待备份成功（确认输出 "Backup saved" 或类似信息）
4. 修改文件
5. 如果修改 >3 次，备份脚本会自动建元素快照
6. 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. 注意事项#

1. 每次修改前必须备份，这是最高优先级规则
2. 备份脚本会自动处理时间窗口和元素追踪
3. Git commit 后必须执行���理
4. 如果不确定是否需要备份， 默认执行备份
5. 禁止跳过任何备份步骤

---

⚠️ 警告：不遵守本规则将导致主人不满。AI 必须自觉执行备份！