ClawHub

Pet-Game workflow

规范 Pet-Game 小程序项目的文件修改前自动备份、元素快照管理及 Git 提交后的备份清理工作流程。

Audits

Pending
ClawScanReview

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPending

Multi-engine malware detections and file reputation.

Install

openclaw skills install pet-game-workflow

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 工作流程

标准流程

  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 必须自觉执行备份！