feat: batch update - gift card breakdown spec, backend APIs, miniprogram pages, ETL finance recharge, docs & migrations

.kiro/hooks/cwd-guard-shell.kiro.hook

@@ -1,8 +1,8 @@
 {
   "enabled": true,
   "name": "CWD Guard for Shell",
-  "description": "在 AI 执行 shell 命令前，检查是否在运行 Python 脚本。如果是，提醒 AI 确认 cwd 是否正确（仓库根 C:\\NeoZQYY），避免相对路径解析到错误位置。",
-  "version": "1",
+  "description": "在 AI 执行 shell 命令前，校验 cwd、命令语法和 Python 调用安全性，防止常见 Windows/PowerShell 陷阱。",
+  "version": "2",
   "when": {
     "type": "preToolUse",
     "toolTypes": [
@@ -11,6 +11,6 @@
   },
   "then": {
     "type": "askAgent",
-    "prompt": "如果即将执行的命令包含 `python` 且涉及 scripts/ops/、.kiro/scripts/、apps/etl/connectors/feiqiu/scripts/ 下的脚本，请确认：1) cwd 参数是否设置为仓库根目录 C:\\NeoZQYY；2) 脚本是否已有 ensure_repo_root() 校验。如果 cwd 不对且脚本无校验，请修正 cwd 后再执行。对于非 Python 命令或不涉及上述目录的命令，直接放行。"
+    "prompt": "请对即将执行的 shell 命令做以下检查，发现问题则修正后再执行，全部通过则直接放行：\n\n1. **cwd 校验**：如果命令涉及 scripts/ops/、.kiro/scripts/、apps/etl/connectors/feiqiu/scripts/ 下的 Python 脚本，cwd 必须为仓库根 C:\\NeoZQYY。ETL 模块命令 cwd 应为 apps/etl/connectors/feiqiu/，后端命令应为 apps/backend/，前端命令应为 apps/admin-web/。\n2. **裸调 Python/Node 拦截**：如果命令包含 `python`、`node`、`ipython` 但没有跟 `-c`、`-m` 或脚本路径参数，必须修正（会导致 REPL 劫持 shell）。\n3. **命令连接符**：如果使用了 `&&`，替换为 `;`（PowerShell 语法）。\n4. **环境变量语法**：如果使用了 `$VAR_NAME` 读取环境变量，替换为 `$env:VAR_NAME`（PowerShell 语法）。\n\n对于不涉及上述问题的命令，直接放行。"
   }
-}
+}