chore(config): 参考 novavis 完善 Agent 配置体系

- AGENTS.md: 新增 §20 工具脚本复用 / §21 分析结论复用 / §22 Flaky 门禁，更新文档配置表 - .pi/: 新增 settings.json、rules/guardrails.md、prompts/{debug,review,ship}-gym-manage.md - .agents/: 新增 Hook 配置与 4 个 Hook 脚本（session-start/pre-agent-check/check-completeness/stop-check）及 protocols/systematic-debugging.md（check-completeness 含接口链缺口检测） - scripts/flaky-scan.sh: vitest shuffle 稳定性扫描（gym-manage-web） - .gitignore: 追踪 AGENTS.md 与 .pi 配置，忽略运行时缓存（todos/taskflows-runs/tokenomy/sessions）
2026-08-04 12:02:12 +08:00
parent 4ba4af2f53
commit 5c65139fd8
14 changed files with 888 additions and 2 deletions
@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+# ============================================================
+# flaky-scan.sh — Vitest 全量 shuffle 稳定性扫描（AGENTS.md §22）
+#
+# 用 --sequence.shuffle 打乱文件与测试执行顺序，暴露顺序依赖型
+# flaky（共享 store 状态 / mock 实现污染 / 全局 stub 残留等）。
+# 目标项目: gym-manage-web（vitest）。通过 --project 可切换。
+#
+# 用法:
+#   bash scripts/flaky-scan.sh                      # gym-manage-web 全量 shuffle 1 次
+#   bash scripts/flaky-scan.sh --runs 3            # 全量 shuffle 3 次
+#   bash scripts/flaky-scan.sh --spec <file>       # 单文件多次 shuffle
+#   bash scripts/flaky-scan.sh --project uniapp    # gym-manage-uniapp（jest，无 shuffle）
+#   bash scripts/flaky-scan.sh --help
+#
+# 退出码: 0 = 全部通过；1 = 存在失败（flaky 或顺序依赖 bug）
+# 失败详情保留在 /tmp/flaky-scan-*.log 供根因定位
+# ============================================================
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+RUNS=1
+SPEC=""
+PROJECT="web"
+SHUFFLE="--sequence.shuffle"
+
+NEXT=""
+for arg in "$@"; do
+  case "$arg" in
+    --runs=*) RUNS="${arg#--runs=}" ;;
+    --spec=*) SPEC="${arg#--spec=}" ;;
+    --project=*) PROJECT="${arg#--project=}" ;;
+    --runs|--spec|--project) NEXT="$arg" ;;
+    --no-shuffle) SHUFFLE="" ;;
+    --help|-h)
+      sed -n '2,16p' "$0" | sed 's/^# \{0,1\}//'
+      exit 0 ;;
+    *)
+      if [ -n "$NEXT" ]; then
+        case "$NEXT" in
+          --runs) RUNS="$arg" ;;
+          --spec) SPEC="$arg" ;;
+          --project) PROJECT="$arg" ;;
+        esac
+        NEXT=""
+      else
+        echo "未知参数: ${arg}（--help 查看用法）" >&2
+        exit 2
+      fi ;;
+  esac
+done
+
+case "$PROJECT" in
+  web)   SUB_PROJ="gym-manage-web" ;;
+  uniapp|coach) SUB_PROJ="gym-manage-${PROJECT}" ;;
+  *) echo "未知项目: ${PROJECT}（web | uniapp | coach）" >&2; exit 2 ;;
+esac
+
+[ -d "${PROJECT_DIR}/${SUB_PROJ}" ] || { echo "子项目不存在: ${SUB_PROJ}" >&2; exit 2; }
+
+echo "============================================"
+echo " Gym Manage Flaky 稳定性扫描"
+echo " 项目: ${SUB_PROJ}"
+echo " 模式: ${SHUFFLE:-无 shuffle} × $RUNS 次${SPEC:+ （${SPEC}）}"
+echo "============================================"
+
+FAILED=0
+for i in $(seq 1 "$RUNS"); do
+  LOG="/tmp/flaky-scan-$i.log"
+  if [ -n "$SPEC" ]; then
+    (cd "${PROJECT_DIR}/${SUB_PROJ}" && NODE_ENV=test npx vitest run $SHUFFLE "$SPEC" > "$LOG" 2>&1)
+  else
+    (cd "${PROJECT_DIR}/${SUB_PROJ}" && NODE_ENV=test npx vitest run $SHUFFLE > "$LOG" 2>&1)
+  fi
+  EXIT=$?
+  SUMMARY=$(grep -E "Tests " "$LOG" | tail -1)
+  if [ "$EXIT" -eq 0 ]; then
+    echo "run $i/$RUNS: ✅ $SUMMARY"
+  else
+    echo "run $i/$RUNS: ❌ exit=$EXIT $SUMMARY"
+    grep -E "^ FAIL" "$LOG" | head -10
+    FAILED=1
+  fi
+done
+
+echo "--------------------------------------------"
+if [ "$FAILED" -eq 0 ]; then
+  echo " 扫描通过：${RUNS} 次运行 0 flaky ✅"
+  exit 0
+else
+  echo " 发现 flaky/顺序依赖（详见 /tmp/flaky-scan-*.log） ❌"
+  exit 1
+fi