claude-apprentice 1.0.0

package/templates/memory/frontend-standards.md

@@ -0,0 +1,89 @@
+# 前端开发规范
+
+## 组件开发规范
+
+### 命名规范
+- 组件文件名：PascalCase（如：UserList.vue / UserList.tsx）
+- 组件内变量：camelCase
+- 常量：UPPER_SNAKE_CASE
+
+### 组件结构（Vue 3 Composition API）
+```vue
+<template>
+  <!-- 模板内容 -->
+</template>
+
+<script setup lang="ts">
+import { ref, computed, onMounted } from 'vue'
+
+// 响应式数据
+const list = ref([])
+
+// 计算属性
+const total = computed(() => list.value.length)
+
+// 方法
+function handleSearch() {}
+</script>
+
+<style scoped>
+/* 样式 */
+</style>
+```
+
+### 组件结构（React Hooks）
+```tsx
+import { useState, useEffect, useMemo } from 'react'
+
+export default function UserList() {
+  const [list, setList] = useState([])
+
+  useEffect(() => {}, [])
+
+  return <div>...</div>
+}
+```
+
+## 状态管理规范
+
+### Vue（Pinia）
+```typescript
+// stores/user.ts
+export const useUserStore = defineStore('user', () => {
+  const userInfo = ref(null)
+  function setUser(info) { userInfo.value = info }
+  return { userInfo, setUser }
+})
+```
+
+### React（Zustand / Redux Toolkit）
+```typescript
+// stores/userSlice.ts
+const useUserStore = create((set) => ({
+  userInfo: null,
+  setUser: (info) => set({ userInfo: info }),
+}))
+```
+
+## API 调用规范
+
+```typescript
+// api/user.ts
+import request from '@/utils/request'
+
+export const getUserList = (params: object) => {
+  return request({ url: '/api/users', method: 'get', params })
+}
+```
+
+- API 调用统一走 `api/` 目录模块，不直接写 fetch/axios
+- 必须处理 loading / error / empty 三种状态
+
+## 代码检查工具
+
+- ESLint + Prettier：代码质量和格式化
+- TypeScript：类型安全
+
+---
+
+**最后更新:** 2026-06-01

package/templates/memory/issues.md

@@ -0,0 +1,34 @@
+# 问题记录
+
+## 已解决问题
+
+### 问题1：[问题标题]
+- **发现时间:** YYYY-MM-DD
+- **问题描述:** [详细描述问题现象]
+- **影响范围:** [受影响的功能/模块]
+- **原因分析:** [问题根本原因]
+- **解决方案:** [具体解决方法]
+- **解决时间:** YYYY-MM-DD
+- **相关代码:** [文件路径和行号]
+
+## 待解决问题
+
+### 问题1：[问题标题]
+- **发现时间:** YYYY-MM-DD
+- **问题描述:** [详细描述问题现象]
+- **影响范围:** [受影响的功能/模块]
+- **优先级:** P0/P1/P2/P3
+- **负责人:** [负责人姓名]
+- **预计解决:** YYYY-MM-DD
+
+## 技术债务
+
+### 债务1：[债务描述]
+- **类型:** 代码质量/性能/安全
+- **影响:** [具体影响]
+- **优先级:** P0/P1/P2/P3
+- **预计处理:** YYYY-MM-DD
+
+---
+
+**最后更新:** 2026-05-18

package/templates/memory/learned-lessons.md

@@ -0,0 +1,78 @@
+# 错误驱动的知识积累
+
+> 每一条规则对应一个过去 AI 犯过的错误。Agent 犯错 → 加一条规则 → 以后不再犯同类错误。
+
+## 编码错误
+
+### L-001: AI 先写实现再补测试
+
+- **错误现象：** AI 直接写完整个实现，然后说"接下来补测试"
+- **根因：** 没有强制 TDD 流程，AI 倾向走捷径
+- **规避规则：** workflow 步骤 3 必须先写失败测试，看到红灯再写实现
+- **添加日期:** 2026-05-27
+
+### L-002: AI mock 所有依赖导致测试无意义
+
+- **错误现象：** 测试中 mock 了 Service、DAO、甚至实体类，断言只是在验证 mock 本身
+- **根因：** AI 追求测试通过率，全 mock 最容易通过
+- **规避规则：** 测试中必须有至少一个真实断言（非 mock 返回值），核心逻辑不能全部 mock
+- **添加日期:** 2026-05-27
+
+### L-003: AI 直接修改编译产物或生成文件
+
+- **错误现象：** 修改了 dist/、target/、node_modules/ 下的文件
+- **根因：** AI 不知道哪些是生成文件
+- **规避规则：** 编辑前确认文件不在 .gitignore 中，不修改 build 输出目录
+- **添加日期:** 2026-05-27
+
+## 流程错误
+
+### L-004: 长任务中上下文腐化导致质量下降
+
+- **错误现象：** 对话超过 40% 上下文后，AI 开始兜圈子、幻觉增多、代码质量下降
+- **根因：** 上下文过长，关键信息被淹没
+- **规避规则：** 复杂任务拆分为子任务，每个子任务独立完成；主动开新对话比在旧对话中继续更高效
+- **添加日期:** 2026-05-27
+
+### L-005: 需求靠对话确认，后续上下文丢失后自由发挥
+
+- **错误现象：** 开头说好的约束，执行到一半 AI 忘了，开始自由发挥
+- **根因：** 对话上下文不是可靠的约束载体
+- **规避规则：** 中等+复杂任务必须写 spec 文件，AI 从文件读约束而非聊天记录
+- **添加日期:** 2026-05-27
+
+### L-006: 口头说"应该没问题"就宣布完成
+
+- **错误现象：** AI 说"代码改完了，应该没问题"但没有运行任何验证命令
+- **根因：** 没有强制验证闭环
+- **规避规则：** 完成前必须运行验证命令（构建、测试、lint），贴出当前运行结果作为证据
+- **添加日期:** 2026-05-27
+
+## 架构错误
+
+### L-007: Controller 层写业务逻辑
+
+- **错误现象：** AI 在 Controller 中直接操作 DAO 或写业务判断
+- **根因：** AI 不了解项目分层约束
+- **规避规则：** coding-standards.md 中明确禁止跨层调用，workflow 步骤 3 按层实现
+- **添加日期:** 2026-05-27
+
+## Loop 层错误
+
+### L-008: 扫描类命令的自指噪声
+
+- **错误现象：** `/scan-todos` 在体系目录跑试点,扫到的 12 条匹配全是命令文档自身的 TODO/FIXME 字样,真实待办为 0,报告失真
+- **根因：** 命令文档自己用 `TODO`/`FIXME` 作为说明文字,扫描时没排除命令文件所在目录
+- **规避规则：** 扫描类命令必须排除命令文档所在目录(`.claude/commands/`、`.claude/usage-guides/`),并对剩余结果做"自指过滤"判定(示例/fixture 里的关键字不算真实待办)
+- **沉淀位置：** `commands/scan-todos.md` v2 已加自指过滤规则和情况 A/B 双模板
+- **元教训：** Loop 层试点跑一次就暴露工程问题 — 这正是 Loop 的价值,不是失败
+- **添加日期:** 2026-06-22
+
+---
+
+## 记录规则
+
+- **触发条件：** AI 犯了一个新的、有代表性的错误（非偶然失误）
+- **记录内容：** 错误现象 + 根因 + 规避规则 + 日期
+- **后续动作：** 如果是编码层面 → 考虑更新 rules/；如果是流程层面 → 考虑更新 workflow 步骤
+- **维护者：** 任何发现 AI 重复犯同类错误的人

package/templates/memory/superpowers-config.md

@@ -0,0 +1,46 @@
+# Superpowers 配置
+
+## 启用状态
+
+| 阶段 | Skill | 状态 | 说明 |
+|------|-------|------|------|
+| 入口 | using-superpowers | 始终启用 | 自动判断走哪条流程 |
+| 设计 | brainstorming | 条件启用 | 中等以上复杂度触发 |
+| 规划 | writing-plans | 条件启用 | 复杂任务触发 |
+| 隔离 | using-git-worktrees | 条件启用 | 复杂任务触发 |
+| 执行 | subagent-driven-development | 条件启用 | 复杂任务触发 |
+| 测试 | test-driven-development | 条件启用 | 中等以上复杂度触发 |
+| 调试 | systematic-debugging | 始终启用 | 遇到 bug 自动触发 |
+| 审查 | requesting/receiving-code-review | 条件启用 | 复杂任务触发 |
+| 验证 | verification-before-completion | 始终启用 | 完成前必须验证 |
+| 收尾 | finishing-a-development-branch | 条件启用 | 中等以上触发 |
+
+## JSON 配置块
+
+<!-- superpowers-config
+{
+  "enabled": [
+    "verification-before-completion",
+    "systematic-debugging"
+  ],
+  "disabled": [],
+  "conditional": {
+    "brainstorming": "complexity >= medium",
+    "writing-plans": "complexity >= complex",
+    "test-driven-development": "complexity >= medium",
+    "using-git-worktrees": "complexity >= complex",
+    "subagent-driven-development": "complexity >= complex",
+    "requesting-code-review": "complexity >= complex",
+    "receiving-code-review": "complexity >= complex",
+    "finishing-a-development-branch": "complexity >= medium",
+    "dispatching-parallel-agents": "manual"
+  },
+  "complexity": {
+    "simple": "单文件修改、样式调整、文案修改（< 30 分钟）",
+    "medium": "新组件、新接口、多文件变更（30 分钟 - 2 小时）",
+    "complex": "新功能模块、跨前后端、多表多接口（> 2 小时）"
+  }
+}
+-->
+
+> 修改配置：编辑上方 JSON 注释块。workflow skills 执行时会读取此文件。

package/templates/rules/INDEX.md

@@ -0,0 +1,63 @@
+# Rules 触发条件索引
+
+> 让规则可审计、可优化。每条 rule 在什么条件下触发,一目了然。
+
+## 当前规则
+
+| 规则文件 | 触发条件 | 规则要点 |
+|---------|---------|---------|
+| `coding-standards.md` | `editing any source code file` | 不引入安全漏洞、不超设计、不写多余注释、命名清晰 |
+| `coding-standards.md` | `creating or modifying backend code` | Controller→Service→DAO 分层,统一响应,异常统一处理 |
+| `coding-standards.md` | `creating or modifying frontend code` | PascalCase 命名,API 走 `api/` 模块,处理 loading/error/empty |
+| `git-safety.md` | `running git commands or creating commits` | 不 force push、不 rm -rf、不跳 hooks、不提交密钥 |
+| `superpowers-workflow.md` | `executing any workflow skill` | 没设计不写代码、没测试不写代码、没验证不说完成 |
+| `superpowers-workflow.md` | `encountering a bug or test failure` | 先找根因再修,连续 3 次失败停下来审视架构 |
+
+## 颗粒度设计
+
+当前覆盖五个场景:
+- **后端代码** — 分层、规范
+- **前端代码** — 组件、API 调用
+- **Git 操作** — 安全红线
+- **Workflow 执行** — 开发铁律
+- **调试** — 根因优先
+
+更细的颗粒度(按语言/框架)由 `init.sh` 自动生成的技术栈专属 rules 处理:
+
+| 技术栈 | Rule 文件 |
+|--------|----------|
+| Java/Spring Boot | `spring-boot.md` |
+| Python/FastAPI | `python-api.md` |
+| Vue | `vue-standards.md` |
+| React | `react-standards.md` |
+| Go | `go-standards.md` |
+
+## 是否需要进一步细化?
+
+| 触发场景 | 当前条件 | 评估 |
+|---------|---------|------|
+| 编辑代码(通用) | `editing any source code file` | ✅ 兜底通用,保持 |
+| 后端代码 | `creating or modifying backend code` | ✅ 颗粒度合适 |
+| 前端代码 | `creating or modifying frontend code` | ✅ 颗粒度合适 |
+| Git 操作 | `running git commands or creating commits` | ✅ 颗粒度合适 |
+
+**结论:** 当前颗粒度合适,不需要进一步细化。`editing any source code file` 是兜底通用规则,不该按语言拆(那是技术栈专属 rules 的事)。
+
+## 维护规则
+
+- 新增 rule 时,在 `learned-lessons.md` 记录对应的错误案例
+- 删除 rule 前,确认 `learned-lessons.md` 里对应的错误已不再犯
+- 触发条件改动时,同步更新本索引
+- 加新 rule 前,先查 `bottleneck-navigation.md` 确认瓶颈确实在 Harness 层
+
+## 与其他文档的关系
+
+```
+learned-lessons.md  ←  错误登记(为什么有这条 rule)
+       ↓
+rules/*.md          ←  规则本身(规则是什么)
+       ↓
+INDEX.md            ←  规则索引(什么时候触发)— 本文件
+       ↓
+bottleneck-navigation.md  ←  元认知(该不该加 rule)
+```

package/templates/rules/coding-standards.md

@@ -0,0 +1,25 @@
+<important if="editing any source code file">
+编码标准：
+
+- 不引入安全漏洞（SQL 注入、XSS、命令注入等 OWASP Top 10）
+- 不添加超出任务需求的抽象或功能
+- 不写多余注释，只在 WHY 不明显时注释
+- 命名清晰即可，不写解释 WHAT 的注释
+</important>
+
+<important if="creating or modifying backend code">
+后端分层：
+
+- Controller 层：只接收请求、参数校验，不写业务逻辑
+- Service 层：业务逻辑，可调用 DAO 或其他 Service
+- DAO/Repository 层：数据访问，不含业务逻辑
+- 禁止跨层调用，统一响应格式，异常统一处理
+</important>
+
+<important if="creating or modifying frontend code">
+前端规范：
+
+- 组件文件名 PascalCase，新增前先搜索已有组件
+- API 调用统一通过 `api/` 目录模块，不直接写 fetch/axios
+- 处理 loading / error / empty 三种状态
+</important>

package/templates/rules/git-safety.md

@@ -0,0 +1,9 @@
+<important if="running git commands or creating commits">
+Git 安全规则：
+
+- 不执行 `git push --force`
+- 不执行 `rm -rf`
+- 不跳过 hooks（不使用 --no-verify）
+- 创建新 commit 而非 amend（除非明确要求）
+- 不提交含密钥的文件（.env、credentials 等）
+</important>

package/templates/rules/superpowers-workflow.md

@@ -0,0 +1,15 @@
+<important if="executing any workflow skill">
+Workflow 执行规则：
+
+1. 没设计不写代码 — 先确认文件、范围、方案
+2. 没测试不写代码 — 先写失败测试，再写实现
+3. 没验证不说完成 — 运行验证命令并贴结果
+</important>
+
+<important if="encountering a bug or test failure">
+调试规则：
+
+- 先找根因再修，不靠猜
+- 读堆栈 → 复现 → 追踪数据流 → 假设 → 最小改动验证
+- 连续 3 次失败，停下来审视架构
+</important>

package/templates/scripts/auto-review.sh

@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+#
+# 自动 review 最近一次 commit
+#
+# 用法:
+#   .claude/scripts/auto-review.sh                 # review HEAD
+#   .claude/scripts/auto-review.sh <commit-hash>   # review 指定 commit
+#
+# 配置为 Claude Code PostToolUse hook(异步触发,不阻塞 commit):
+#
+# 在 .claude/settings.json 加:
+#
+#   {
+#     "hooks": {
+#       "PostToolUse": [
+#         {
+#           "matcher": "Bash",
+#           "hooks": [
+#             {
+#               "type": "command",
+#               "command": "bash .claude/scripts/auto-review.sh"
+#             }
+#           ]
+#         }
+#       ]
+#     }
+#   }
+#
+# Hook 触发时,通过 stdin 收到 JSON 载荷(含 tool_name 和 command),
+# 脚本判断是否为 git commit,非 commit 命令直接退出 0。
+#
+# 不想配 hook 时,也可手动调用,或在 Claude Code 对话里说:
+#   "review 上次 commit"
+#
+
+set -euo pipefail
+
+# 从 hook 触发时,判断是不是 git commit
+if [ ! -t 0 ]; then
+  PAYLOAD="$(cat 2>/dev/null || true)"
+  if echo "$PAYLOAD" | grep -q '"tool_name":"Bash"' 2>/dev/null; then
+    if ! echo "$PAYLOAD" | grep -Eq 'git commit' 2>/dev/null; then
+      exit 0
+    fi
+  fi
+fi
+
+# 确定要 review 的 commit
+COMMIT="${1:-HEAD}"
+
+# 确认在 git 仓库内
+if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+  echo "[auto-review] 不在 git 仓库内,跳过" >&2
+  exit 0
+fi
+
+REPO_ROOT="$(git rev-parse --show-toplevel)"
+REPORT_DIR="$REPO_ROOT/.claude/reports"
+mkdir -p "$REPORT_DIR"
+
+# 检查 ocr 是否可用
+if ! command -v ocr >/dev/null 2>&1; then
+  echo "[auto-review] ocr CLI 未安装,跳过自动 review" >&2
+  echo "[auto-review] 备选:在 Claude Code 对话里说 'review 上次 commit'" >&2
+  exit 0
+fi
+
+TIMESTAMP="$(date +%Y%m%d-%H%M%S)"
+REPORT="$REPORT_DIR/auto-review-$TIMESTAMP.md"
+
+echo "[auto-review] Reviewing commit $COMMIT..."
+ocr review "$COMMIT" --output "$REPORT" 2>&1 || {
+  echo "[auto-review] review 失败,请手动检查 $COMMIT" >&2
+  exit 1
+}
+
+echo "[auto-review] 报告已生成: $REPORT"

package/templates/scripts/health-check.sh

@@ -0,0 +1,189 @@
+#!/bin/bash
+#
+# claude-apprentice 健康巡检脚本
+# 用法: .claude/scripts/health-check.sh
+#
+# 检查项：未归档 spec、知识库过时、CLAUDE.md 膨胀、rules 一致性、错题本、报告目录
+#
+
+set -e
+
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+RED='\033[0;31m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+WARN=0
+ERR=0
+
+warn() { echo -e "${YELLOW}[WARN]${NC} $1"; WARN=$((WARN + 1)); }
+err()  { echo -e "${RED}[ERR]${NC} $1"; ERR=$((ERR + 1)); }
+ok()   { echo -e "${GREEN}[OK]${NC} $1"; }
+info() { echo -e "${BLUE}[INFO]${NC} $1"; }
+
+# ── 跨平台日期差计算 ─────────────────────────────────────────────────
+# 用法: days_since "YYYY-MM-DD"
+# 输出: 距今天的天数（失败返回 -1）
+days_since() {
+  local date_str="$1"
+  if command -v python3 >/dev/null 2>&1; then
+    python3 -c "
+from datetime import datetime, date
+try:
+    d = datetime.strptime('$date_str', '%Y-%m-%d').date()
+    print((date.today() - d).days)
+except Exception:
+    print(-1)
+" 2>/dev/null || echo -1
+  elif command -v python >/dev/null 2>&1; then
+    python -c "
+from datetime import datetime, date
+try:
+    d = datetime.strptime('$date_str', '%Y-%m-%d').date()
+    print((date.today() - d).days)
+except Exception:
+    print(-1)
+" 2>/dev/null || echo -1
+  elif [[ "$(uname)" == "Darwin" ]]; then
+    # macOS BSD date
+    local now_ts then_ts
+    now_ts=$(date +%s)
+    then_ts=$(date -j -f "%Y-%m-%d" "$date_str" +%s 2>/dev/null || echo 0)
+    if [ "$then_ts" -gt 0 ]; then
+      echo $(( (now_ts - then_ts) / 86400 ))
+    else
+      echo -1
+    fi
+  else
+    # Linux GNU date
+    local now_ts then_ts
+    now_ts=$(date +%s)
+    then_ts=$(date -d "$date_str" +%s 2>/dev/null || echo 0)
+    if [ "$then_ts" -gt 0 ]; then
+      echo $(( (now_ts - then_ts) / 86400 ))
+    else
+      echo -1
+    fi
+  fi
+}
+
+echo "=== claude-apprentice 健康巡检 ==="
+echo ""
+
+# ===== 1. CLAUDE.md 行数检查 =====
+info "1. CLAUDE.md 膨胀检查"
+if [ -f "CLAUDE.md" ]; then
+    LINES=$(wc -l < CLAUDE.md)
+    if [ "$LINES" -gt 80 ]; then
+        warn "CLAUDE.md 当前 ${LINES} 行，超过 80 行阈值（目标 < 60 行）"
+        echo "  建议：将详细内容移到子文档，CLAUDE.md 只保留目录和核心约束"
+    else
+        ok "CLAUDE.md ${LINES} 行，在合理范围内"
+    fi
+else
+    err "CLAUDE.md 不存在"
+fi
+
+# ===== 2. Active Spec 积压检查 =====
+info "2. Active Spec 积压检查"
+if [ -d ".claude/specs/active" ]; then
+    ACTIVE_COUNT=$(find .claude/specs/active -name "*.md" ! -name "README.md" 2>/dev/null | wc -l | tr -d ' ')
+    if [ "$ACTIVE_COUNT" -gt 3 ]; then
+        warn "specs/active/ 下有 ${ACTIVE_COUNT} 个未归档 spec"
+        echo "  建议：已完成的 spec 应归档到 specs/archived/"
+    elif [ "$ACTIVE_COUNT" -eq 0 ]; then
+        ok "没有未归档的 spec"
+    else
+        ok "specs/active/ 下有 ${ACTIVE_COUNT} 个进行中的 spec"
+    fi
+else
+    warn "specs/active/ 目录不存在"
+fi
+
+# ===== 3. 知识库过时检查 =====
+info "3. 知识库更新时间检查"
+if [ -d ".claude/memory" ]; then
+    for f in architecture.md frontend-standards.md backend-standards.md business-logic.md; do
+        if [ -f ".claude/memory/$f" ]; then
+            LAST_UPDATE=$(grep "最后更新" ".claude/memory/$f" 2>/dev/null | head -1 | grep -oE '[0-9]{4}-[0-9]{2}-[0-9]{2}' || echo "unknown")
+            if [ "$LAST_UPDATE" != "unknown" ] && [ "$LAST_UPDATE" != "待填写" ]; then
+                DAYS_SINCE=$(days_since "$LAST_UPDATE")
+                if [ "$DAYS_SINCE" -ge 0 ] && [ "$DAYS_SINCE" -gt 90 ]; then
+                    warn "memory/$f 已 ${DAYS_SINCE} 天未更新（最后: $LAST_UPDATE）"
+                fi
+            fi
+        fi
+    done
+    ok "知识库时间检查完成"
+else
+    err "memory/ 目录不存在"
+fi
+
+# ===== 4. Rules 一致性检查 =====
+info "4. Rules 一致性检查"
+for rule in coding-standards.md git-safety.md superpowers-workflow.md; do
+    if [ ! -f ".claude/rules/$rule" ]; then
+        err "缺少核心规则文件: rules/$rule"
+    fi
+done
+ok "Rules 一致性检查完成"
+
+# ===== 5. Superpowers 配置位置检查 =====
+info "5. Superpowers 配置位置检查"
+if [ -f ".claude/memory/superpowers-config.md" ]; then
+    ok "superpowers-config.md 在正确位置（memory/）"
+else
+    warn "memory/superpowers-config.md 不存在，Superpowers 配置可能还在 CLAUDE.md 中"
+    echo "  建议：将配置移到 memory/superpowers-config.md，CLAUDE.md 保持精简"
+fi
+
+# ===== 6. Spec 目录结构检查 =====
+info "6. Spec 目录结构检查"
+if [ -d ".claude/specs" ] && [ -f ".claude/specs/SPEC-GUIDE.md" ]; then
+    ok "Spec 目录结构完整（SPEC-GUIDE.md + active/ + archived/）"
+else
+    warn "Spec 目录结构不完整"
+    echo "  建议：确保 specs/SPEC-GUIDE.md、specs/active/、specs/archived/ 都存在"
+fi
+
+# ===== 7. 错误积累检查 =====
+info "7. 错误积累机制检查"
+if [ -f ".claude/memory/learned-lessons.md" ]; then
+    LESSON_COUNT=$(grep -c "^### L-" ".claude/memory/learned-lessons.md" 2>/dev/null || echo 0)
+    ok "learned-lessons.md 存在，已积累 ${LESSON_COUNT} 条教训"
+else
+    warn "learned-lessons.md 不存在"
+    echo "  建议：创建 memory/learned-lessons.md 记录 AI 常犯错误和规避规则"
+fi
+
+# ===== 8. Reports 目录检查 =====
+info "8. Reports 输出目录检查"
+if [ -d ".claude/reports" ]; then
+    REPORT_COUNT=$(find .claude/reports -name "*.md" -o -name "*.xlsx" 2>/dev/null | wc -l | tr -d ' ')
+    ok "reports/ 目录存在，已有 ${REPORT_COUNT} 份报告"
+else
+    warn "reports/ 目录不存在"
+    echo "  建议：运行 init.sh 补全，或手动 mkdir -p .claude/reports"
+fi
+
+# ===== 9. 流程定义文件检查 =====
+info "9. 流程定义文件检查"
+if [ -f ".claude/workflow/WORKFLOW-GUIDE.md" ]; then
+    ok "workflow/WORKFLOW-GUIDE.md 存在"
+else
+    warn "缺少 workflow/WORKFLOW-GUIDE.md"
+    echo "  建议：运行 init.sh 补全，或手动创建流程定义文件"
+fi
+
+# ===== 汇总 =====
+echo ""
+echo "========================================"
+if [ "$ERR" -gt 0 ]; then
+    echo -e "${RED}发现 ${ERR} 个错误，${WARN} 个警告${NC}"
+elif [ "$WARN" -gt 0 ]; then
+    echo -e "${YELLOW}发现 ${WARN} 个警告，0 个错误${NC}"
+else
+    echo -e "${GREEN}所有检查通过！体系健康状态良好。${NC}"
+fi
+echo "========================================"