sillyspec 2.4.0

package/scripts/scan-preprocess.sh

@@ -0,0 +1,378 @@
+#!/bin/bash
+# SillySpec 扫描预处理脚本
+# 用途：在 AI 介入前完成机械性工作，节省 token + 防止上下文爆炸
+# 输出：.sillyspec/codebase/SCAN-RAW.md
+#
+# 用法：
+#   bash scripts/scan-preprocess.sh [目录]
+#   bash scripts/scan-preprocess.sh api      # 只扫 api 目录
+
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR=".sillyspec/codebase"
+OUTPUT_FILE="$OUTPUT_DIR/SCAN-RAW.md"
+
+# ── 排除目录 ──
+
+EXCLUDE_DIRS=(
+  "node_modules" "dist" ".git" "vendor" "build"
+  "__pycache__" ".next" "coverage" ".nuxt" "target"
+  ".idea" ".vscode" ".DS_Store" "bin" "obj"
+  "tmp" "temp" "logs" ".cache" "out"
+)
+
+build_exclude_args() {
+  local args=()
+  for d in "${EXCLUDE_DIRS[@]}"; do
+    args+=(-not -path "*/$d/*" -not -path "*/$d")
+  done
+  echo "${args[@]}"
+}
+
+EXCLUDE_ARGS=$(build_exclude_args)
+
+# ── 统计源文件 ──
+
+echo "🔍 SillySpec 扫描预处理"
+echo "   目标目录: $TARGET_DIR"
+echo ""
+
+# 文件类型分类
+count_files() {
+  local ext="$1" label="$2"
+  local cmd="find \"$TARGET_DIR\" -type f -name \"*.$ext\" $EXCLUDE_ARGS 2>/dev/null | wc -l | tr -d ' '"
+  local n=$(eval "$cmd")
+  if [ "$n" -gt 0 ]; then
+    echo "  $label: $n 个文件"
+  fi
+}
+
+echo "📊 文件统计："
+FILE_COUNT=0
+TOTAL_SIZE=0
+
+# 按语言统计
+JAVA_COUNT=$(find "$TARGET_DIR" -type f -name "*.java" $EXCLUDE_ARGS 2>/dev/null | wc -l | tr -d ' ')
+PY_COUNT=$(find "$TARGET_DIR" -type f -name "*.py" $EXCLUDE_ARGS 2>/dev/null | wc -l | tr -d ' ')
+TS_COUNT=$(find "$TARGET_DIR" -type f \( -name "*.ts" -o -name "*.tsx" \) $EXCLUDE_ARGS 2>/dev/null | wc -l | tr -d ' ')
+JS_COUNT=$(find "$TARGET_DIR" -type f \( -name "*.js" -o -name "*.jsx" \) $EXCLUDE_ARGS 2>/dev/null | wc -l | tr -d ' ')
+GO_COUNT=$(find "$TARGET_DIR" -type f -name "*.go" $EXCLUDE_ARGS 2>/dev/null | wc -l | tr -d ' ')
+RB_COUNT=$(find "$TARGET_DIR" -type f -name "*.rb" $EXCLUDE_ARGS 2>/dev/null | wc -l | tr -d ' ')
+PHP_COUNT=$(find "$TARGET_DIR" -type f -name "*.php" $EXCLUDE_ARGS 2>/dev/null | wc -l | tr -d ' ')
+RS_COUNT=$(find "$TARGET_DIR" -type f -name "*.rs" $EXCLUDE_ARGS 2>/dev/null | wc -l | tr -d ' ')
+VUE_COUNT=$(find "$TARGET_DIR" -type f -name "*.vue" $EXCLUDE_ARGS 2>/dev/null | wc -l | tr -d ' ')
+SQL_COUNT=$(find "$TARGET_DIR" -type f \( -name "*.sql" -o -name "*.prisma" \) $EXCLUDE_ARGS 2>/dev/null | wc -l | tr -d ' ')
+YAML_COUNT=$(find "$TARGET_DIR" -type f \( -name "*.yaml" -o -name "*.yml" \) $EXCLUDE_ARGS 2>/dev/null | wc -l | tr -d ' ')
+XML_COUNT=$(find "$TARGET_DIR" -type f \( -name "*.xml" \) $EXCLUDE_ARGS 2>/dev/null | wc -l | tr -d ' ')
+
+# 配置文件
+CONFIG_COUNT=$(find "$TARGET_DIR" -maxdepth 3 -type f \( -name "package.json" -o -name "pom.xml" -o -name "build.gradle" -o -name "go.mod" -o -name "requirements.txt" -o -name "Cargo.toml" -o -name "composer.json" -o -name "Gemfile" -o -name "*.csproj" \) $EXCLUDE_ARGS 2>/dev/null | wc -l | tr -d ' ')
+
+[ "$JAVA_COUNT" -gt 0 ] && echo "  Java: $JAVA_COUNT"
+[ "$PY_COUNT" -gt 0 ] && echo "  Python: $PY_COUNT"
+[ "$TS_COUNT" -gt 0 ] && echo "  TypeScript: $TS_COUNT"
+[ "$JS_COUNT" -gt 0 ] && echo "  JavaScript: $JS_COUNT"
+[ "$GO_COUNT" -gt 0 ] && echo "  Go: $GO_COUNT"
+[ "$RB_COUNT" -gt 0 ] && echo "  Ruby: $RB_COUNT"
+[ "$PHP_COUNT" -gt 0 ] && echo "  PHP: $PHP_COUNT"
+[ "$RS_COUNT" -gt 0 ] && echo "  Rust: $RS_COUNT"
+[ "$VUE_COUNT" -gt 0 ] && echo "  Vue: $VUE_COUNT"
+[ "$SQL_COUNT" -gt 0 ] && echo "  SQL/Schema: $SQL_COUNT"
+[ "$XML_COUNT" -gt 0 ] && echo "  XML: $XML_COUNT"
+[ "$YAML_COUNT" -gt 0 ] && echo "  YAML: $YAML_COUNT"
+[ "$CONFIG_COUNT" -gt 0 ] && echo "  配置文件: $CONFIG_COUNT"
+
+# 总计
+ALL_SOURCE=$(find "$TARGET_DIR" -type f \( -name "*.java" -o -name "*.py" -o -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" -o -name "*.go" -o -name "*.rb" -o -name "*.php" -o -name "*.rs" -o -name "*.vue" \) $EXCLUDE_ARGS 2>/dev/null)
+FILE_COUNT=$(echo "$ALL_SOURCE" | wc -l | tr -d ' ')
+[ -z "$FILE_COUNT" ] && FILE_COUNT=0
+TOTAL_SIZE=$(echo "$ALL_SOURCE" | xargs cat 2>/dev/null | wc -c | tr -d ' ')
+[ -z "$TOTAL_SIZE" ] && TOTAL_SIZE=0
+
+TOTAL_SIZE_KB=$((TOTAL_SIZE / 1024))
+
+echo ""
+echo "  ────────────────"
+echo "  源文件总计: $FILE_COUNT 个"
+echo "  源码总大小: ${TOTAL_SIZE_KB}KB"
+
+# 时间估算
+if [ "$FILE_COUNT" -lt 50 ]; then
+  EST_TIME="约 30 秒"
+  RISK="低"
+elif [ "$FILE_COUNT" -lt 150 ]; then
+  EST_TIME="约 1-2 分钟"
+  RISK="低"
+elif [ "$FILE_COUNT" -lt 300 ]; then
+  EST_TIME="约 3-5 分钟"
+  RISK="中"
+elif [ "$FILE_COUNT" -lt 500 ]; then
+  EST_TIME="约 5-8 分钟"
+  RISK="中"
+else
+  EST_TIME="约 8-15 分钟"
+  RISK="⚠️ 高（建议指定扫描区域）"
+fi
+
+echo "  预计耗时: $EST_TIME"
+echo "  上下文风险: $RISK"
+
+# ── 目录分布 ──
+
+echo ""
+echo "📁 目录分布（源文件最多的目录）："
+find "$TARGET_DIR" -type f \( -name "*.java" -o -name "*.py" -o -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" -o -name "*.go" -o -name "*.vue" \) $EXCLUDE_ARGS 2>/dev/null \
+  | sed 's|/[^/]*$||' \
+  | sort | uniq -c | sort -rn | head -10 \
+  | while read count dir; do
+    echo "  $count 个文件  $dir"
+  done
+
+# ── 提取结构化信息 ──
+
+mkdir -p "$OUTPUT_DIR"
+
+echo ""
+echo "🔧 提取结构化信息..."
+
+{
+  echo "# SCAN-RAW.md — 扫描预处理结果"
+  echo ""
+  echo "> 由 scripts/scan-preprocess.sh 自动生成，AI 深度扫描时读取此文件。"
+  echo "> 生成时间: $(date '+%Y-%m-%d %H:%M:%S')"
+  echo ""
+  echo "## 项目概况"
+  echo "- 扫描目录: $TARGET_DIR"
+  echo "- 源文件数: $FILE_COUNT"
+  echo "- 源码大小: ${TOTAL_SIZE_KB}KB"
+  echo "- 预计耗时: $EST_TIME"
+  echo ""
+
+  # ── 配置文件内容 ──
+  echo "## 配置文件"
+  echo ""
+  
+  for f in $(find "$TARGET_DIR" -maxdepth 3 -type f \( -name "package.json" -o -name "pom.xml" -o -name "build.gradle" -o -name "build.gradle.kts" -o -name "settings.gradle" -o -name "go.mod" -o -name "requirements.txt" -o -name "pyproject.toml" -o -name "Cargo.toml" -o -name "composer.json" -o -name "Gemfile" -o -name "*.csproj" -o -name "application.yml" -o -name "application.yaml" -o -name "application.properties" \) $EXCLUDE_ARGS 2>/dev/null | head -20); do
+    echo "### $f"
+    echo '```'
+    cat "$f" 2>/dev/null | head -50
+    echo '```'
+    echo ""
+  done
+
+  # ── 目录结构树 ──
+  echo "## 目录结构"
+  echo ""
+  echo '```'
+  find "$TARGET_DIR" -type f -not -path "*/node_modules/*" -not -path "*/.git/*" -not -path "*/dist/*" -not -path "*/vendor/*" -not -path "*/build/*" -not -path "*/__pycache__/*" -not -path "*/.next/*" -not -path "*/target/*" -not -path "*/.idea/*" -not -path "*/.vscode/*" -not -path "*/bin/*" -not -path "*/obj/*" -not -path "*/tmp/*" | head -300 | sed "s|$TARGET_DIR/||" | sort
+  echo '```'
+  echo ""
+
+  # ── import/依赖关系 ──
+  echo "## 依赖关系（import 分析）"
+  echo ""
+
+  # Java imports
+  if [ "$JAVA_COUNT" -gt 0 ]; then
+    echo "### Java imports（出现频率 Top 30）"
+    echo '```'
+    find "$TARGET_DIR" -name "*.java" $EXCLUDE_ARGS 2>/dev/null | xargs grep -h "^import " 2>/dev/null | sed 's/import static //' | sort | uniq -c | sort -rn | head -30
+    echo '```'
+    echo ""
+  fi
+
+  # Python imports
+  if [ "$PY_COUNT" -gt 0 ]; then
+    echo "### Python imports（出现频率 Top 30）"
+    echo '```'
+    find "$TARGET_DIR" -name "*.py" $EXCLUDE_ARGS 2>/dev/null | xargs grep -h "^import \|^from " 2>/dev/null | sort | uniq -c | sort -rn | head -30
+    echo '```'
+    echo ""
+  fi
+
+  # TypeScript/JavaScript imports
+  if [ "$TS_COUNT" -gt 0 ] || [ "$JS_COUNT" -gt 0 ]; then
+    echo "### JS/TS imports（出现频率 Top 30）"
+    echo '```'
+    find "$TARGET_DIR" \( -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" -o -name "*.vue" \) $EXCLUDE_ARGS 2>/dev/null | xargs grep -hE "^\s*(import |require\(|from ['\"])" 2>/dev/null | sed "s/.*from ['\"]//;s/.*require(['\"]//;s/['\").*//" | grep -v "^\." | grep -v "^@" | sort | uniq -c | sort -rn | head -30
+    echo '```'
+    echo ""
+  fi
+
+  # Go imports
+  if [ "$GO_COUNT" -gt 0 ]; then
+    echo "### Go imports（出现频率 Top 30）"
+    echo '```'
+    find "$TARGET_DIR" -name "*.go" $EXCLUDE_ARGS 2>/dev/null | xargs grep -hE '^\s*"[a-zA-Z]' 2>/dev/null | sort | uniq -c | sort -rn | head -30
+    echo '```'
+    echo ""
+  fi
+
+  # ── 类名/函数名提取 ──
+  echo "## 代码结构（类名/函数名）"
+  echo ""
+
+  # Java classes
+  if [ "$JAVA_COUNT" -gt 0 ]; then
+    echo "### Java 类和接口"
+    echo '```'
+    find "$TARGET_DIR" -name "*.java" $EXCLUDE_ARGS 2>/dev/null | xargs grep -hE "^\s*(public|protected|private|)?" | grep -E "(class |interface |enum |@Entity|@Table|@Controller|@Service|@Repository|@RestController|@Mapper|@Component)" | head -50
+    echo '```'
+    echo ""
+  fi
+
+  # Python classes/functions
+  if [ "$PY_COUNT" -gt 0 ]; then
+    echo "### Python 类和函数（Top 50）"
+    echo '```'
+    find "$TARGET_DIR" -name "*.py" $EXCLUDE_ARGS 2>/dev/null | xargs grep -hE "^(class |def |async def )" 2>/dev/null | head -50
+    echo '```'
+    echo ""
+  fi
+
+  # Go structs
+  if [ "$GO_COUNT" -gt 0 ]; then
+    echo "### Go 结构体和接口"
+    echo '```'
+    find "$TARGET_DIR" -name "*.go" -not -path "*/vendor/*" 2>/dev/null | xargs grep -hE "^(type .+ struct|type .+ interface)" 2>/dev/null | head -30
+    echo '```'
+    echo ""
+  fi
+
+  # ── 数据库 Schema 文件位置 ──
+  echo "## 数据库 Schema 文件"
+  echo ""
+
+  SCHEMA_FILES=""
+  # Prisma
+  SCHEMA_FILES+="$(find "$TARGET_DIR" -name "schema.prisma" $EXCLUDE_ARGS 2>/dev/null) "
+  # MyBatis Mapper XML
+  SCHEMA_FILES+="$(find "$TARGET_DIR" -name "*Mapper.xml" $EXCLUDE_ARGS 2>/dev/null) "
+  # SQLAlchemy / Django models
+  SCHEMA_FILES+="$(find "$TARGET_DIR" -name "models.py" $EXCLUDE_ARGS 2>/dev/null) "
+  # TypeORM entities
+  SCHEMA_FILES+="$(find "$TARGET_DIR" -name "*.entity.ts" $EXCLUDE_ARGS 2>/dev/null) "
+  # Mongoose models
+  SCHEMA_FILES+="$(find "$TARGET_DIR" -name "*.model.ts" $EXCLUDE_ARGS 2>/dev/null) "
+  # SQL migrations
+  SCHEMA_FILES+="$(find "$TARGET_DIR" \( -name "*.sql" -o -name "*migration*" \) $EXCLUDE_ARGS 2>/dev/null) "
+  # Java entities
+  SCHEMA_FILES+="$(find "$TARGET_DIR" \( -path "*/entity/*" -o -path "*/model/*" \) -name "*.java" $EXCLUDE_ARGS 2>/dev/null) "
+  # Drizzle schema
+  SCHEMA_FILES+="$(find "$TARGET_DIR" -name "schema.ts" $EXCLUDE_ARGS 2>/dev/null) "
+  # Go GORM models
+  SCHEMA_FILES+="$(find "$TARGET_DIR" -name "models.go" -o -name "model.go" $EXCLUDE_ARGS 2>/dev/null) "
+
+  if [ -n "$SCHEMA_FILES" ]; then
+    echo "$SCHEMA_FILES" | tr ' ' '\n' | grep -v "^$" | while read -r f; do
+      if [ -n "$f" ] && [ -f "$f" ]; then
+        echo "- \`$f\`"
+      fi
+    done
+    echo ""
+  else
+    echo "未检测到数据库 schema 文件。"
+    echo ""
+  fi
+
+  # ── 框架检测 ──
+  echo "## 框架检测"
+  echo ""
+
+  # 检测 Web 框架
+  if find "$TARGET_DIR" -name "*.java" $EXCLUDE_ARGS 2>/dev/null | xargs grep -l "@RestController\|@Controller\|@RequestMapping\|@GetMapping\|@PostMapping" 2>/dev/null | head -1 | grep -q .; then
+    echo "- **Java Web**: Spring Boot (Spring MVC annotations detected)"
+  fi
+  if find "$TARGET_DIR" -name "*.java" $EXCLUDE_ARGS 2>/dev/null | xargs grep -l "mybatis\|MyBatis\|@Mapper\|@Select" 2>/dev/null | head -1 | grep -q .; then
+    echo "- **ORM**: MyBatis / MyBatis-Plus"
+  fi
+  if find "$TARGET_DIR" -name "*.java" $EXCLUDE_ARGS 2>/dev/null | xargs grep -l "@Entity\|@Table\|@Column\|JPA\|javax.persistence\|jakarta.persistence" 2>/dev/null | head -1 | grep -q .; then
+    echo "- **ORM**: JPA / Hibernate"
+  fi
+  if find "$TARGET_DIR" -name "pom.xml" $EXCLUDE_ARGS 2>/dev/null | xargs grep -l "mybatis-plus\|mybatis\|MybatisPlus" 2>/dev/null | head -1 | grep -q .; then
+    echo "- **增强**: MyBatis-Plus"
+  fi
+
+  if find "$TARGET_DIR" $EXCLUDE_ARGS 2>/dev/null | xargs grep -l "flask\|Flask" 2>/dev/null | head -1 | grep -q .; then
+    echo "- **Python Web**: Flask"
+  fi
+  if find "$TARGET_DIR" $EXCLUDE_ARGS 2>/dev/null | xargs grep -l "django\|Django" 2>/dev/null | head -1 | grep -q .; then
+    echo "- **Python Web**: Django"
+  fi
+  if find "$TARGET_DIR" $EXCLUDE_ARGS 2>/dev/null | xargs grep -l "fastapi\|FastAPI" 2>/dev/null | head -1 | grep -q .; then
+    echo "- **Python Web**: FastAPI"
+  fi
+  if find "$TARGET_DIR" -name "*.py" $EXCLUDE_ARGS 2>/dev/null | xargs grep -l "sqlalchemy\|SQLAlchemy" 2>/dev/null | head -1 | grep -q .; then
+    echo "- **ORM**: SQLAlchemy"
+  fi
+
+  if [ -f "$TARGET_DIR/package.json" ]; then
+    if grep -q "vue" "$TARGET_DIR/package.json" 2>/dev/null; then
+      echo "- **Frontend**: Vue.js"
+    fi
+    if grep -q "react\|next" "$TARGET_DIR/package.json" 2>/dev/null; then
+      echo "- **Frontend**: React / Next.js"
+    fi
+    if grep -q "express" "$TARGET_DIR/package.json" 2>/dev/null; then
+      echo "- **Backend**: Express.js"
+    fi
+    if grep -q "nestjs\|NestJS" "$TARGET_DIR/package.json" 2>/dev/null; then
+      echo "- **Backend**: NestJS"
+    fi
+    if grep -q "prisma" "$TARGET_DIR/package.json" 2>/dev/null; then
+      echo "- **ORM**: Prisma"
+    fi
+    if grep -q "typeorm\|TypeORM" "$TARGET_DIR/package.json" 2>/dev/null; then
+      echo "- **ORM**: TypeORM"
+    fi
+  fi
+
+  if [ "$GO_COUNT" -gt 0 ] && find "$TARGET_DIR" $EXCLUDE_ARGS 2>/dev/null | xargs grep -l "gorm.io\|GORM\|gorm.Model" 2>/dev/null | head -1 | grep -q .; then
+    echo "- **ORM**: GORM"
+  fi
+  if [ "$GO_COUNT" -gt 0 ] && find "$TARGET_DIR" $EXCLUDE_ARGS 2>/dev/null | xargs grep -l "gin\|Gin\|gin.Context" 2>/dev/null | head -1 | grep -q .; then
+    echo "- **Web**: Gin"
+  fi
+  if [ "$GO_COUNT" -gt 0 ] && find "$TARGET_DIR" $EXCLUDE_ARGS 2>/dev/null | xargs grep -l "echo\|Echo\|labstack/echo" 2>/dev/null | head -1 | grep -q .; then
+    echo "- **Web**: Echo"
+  fi
+
+  echo ""
+
+  # ── 框架隐形规则相关文件 ──
+  echo "## 框架配置文件（隐形规则扫描参考）"
+  echo ""
+
+  FRAMEWORK_FILES=""
+  FRAMEWORK_FILES+="$(find "$TARGET_DIR" \( -name "*Interceptor*.java" -o -name "*Plugin*.java" -o -name "mybatis-config.xml" \) $EXCLUDE_ARGS 2>/dev/null) "
+  FRAMEWORK_FILES+="$(find "$TARGET_DIR" \( -name "*Auditor*.java" -o -name "*EventListener*.java" \) $EXCLUDE_ARGS 2>/dev/null) "
+  FRAMEWORK_FILES+="$(find "$TARGET_DIR" -name "settings.py" -maxdepth 3 $EXCLUDE_ARGS 2>/dev/null) "
+  FRAMEWORK_FILES+="$(find "$TARGET_DIR" \( -name "*event*.py" -o -name "*listener*.py" -o -name "*mixin*.py" \) $EXCLUDE_ARGS 2>/dev/null) "
+  FRAMEWORK_FILES+="$(find "$TARGET_DIR" \( -name "Base*.java" -o -name "Abstract*.java" \) \( -path "*/entity/*" -o -path "*/model/*" -o -path "*/po/*" \) $EXCLUDE_ARGS 2>/dev/null) "
+  FRAMEWORK_FILES+="$(find "$TARGET_DIR" \( -name "*.rb" \) $EXCLUDE_ARGS 2>/dev/null | xargs grep -l "acts_as_paranoid\|acts_as_tenant" 2>/dev/null) "
+
+  if [ -n "$FRAMEWORK_FILES" ]; then
+    echo "$FRAMEWORK_FILES" | tr ' ' '\n' | grep -v "^$" | while read -r f; do
+      if [ -n "$f" ] && [ -f "$f" ]; then
+        echo "- \`$f\`"
+      fi
+    done
+    echo ""
+  else
+    echo "未检测到框架配置文件。"
+    echo ""
+  fi
+
+  echo "---"
+  echo "预处理完成。AI 深度扫描时读取此文件，不需要再遍历原始源码。"
+
+} > "$OUTPUT_FILE"
+
+echo ""
+echo "✅ 预处理完成"
+echo "   输出文件: $OUTPUT_FILE"
+echo "   文件大小: $(wc -c < "$OUTPUT_FILE" | tr -d ' ') bytes"
+echo ""
+echo "   下一步: /sillyspec:scan --deep"
+echo "   AI 会读取 SCAN-RAW.md 而不是原始源码，大幅节省上下文。"

package/scripts/validate-all.sh

@@ -0,0 +1,50 @@
+#!/bin/bash
+# SillySpec 综合校验
+# 用法：validate-all.sh
+
+echo "========================================="
+echo "  SillySpec 综合校验"
+echo "========================================="
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+ERRORS=0
+
+# 1. 检查 SillySpec 安装
+echo ""
+echo "📦 检查安装状态..."
+if [ -d ".claude/commands/sillyspec" ]; then
+  cmd_count=$(ls .claude/commands/sillyspec/*.md 2>/dev/null | wc -l | tr -d ' ')
+  echo "  ✅ 已安装 $cmd_count 个 commands"
+else
+  echo "  ❌ 未安装 SillySpec commands"
+  ((ERRORS++))
+fi
+
+# 2. 检查当前变更
+echo ""
+echo "📋 检查变更..."
+LATEST=$(ls -d .sillyspec/changes/*/ 2>/dev/null | grep -v archive | tail -1)
+if [ -n "$LATEST" ]; then
+  echo "  📁 当前变更: $LATEST"
+  "$SCRIPT_DIR/validate-proposal.sh" "$LATEST" || ((ERRORS++))
+else
+  echo "  ℹ️ 无活跃变更"
+fi
+
+# 3. 检查代码库文档
+echo ""
+echo "🗂️ 检查代码库文档..."
+if [ -d ".sillyspec/codebase" ]; then
+  "$SCRIPT_DIR/validate-scan.sh" ".sillyspec/codebase" || ((ERRORS++))
+else
+  echo "  ℹ️ 无代码库文档（新项目或未 scan）"
+fi
+
+echo ""
+echo "========================================="
+if [ $ERRORS -eq 0 ]; then
+  echo "  ✅ 全部通过"
+else
+  echo "  ❌ $ERRORS 个问题需要处理"
+fi
+echo "========================================="

package/scripts/validate-plan.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+# SillySpec 校验：plan 阶段输出
+# 用法：validate-plan.sh <change-dir>
+
+CHANGE_DIR="${1:?用法: validate-plan.sh <change-dir>}"
+ERRORS=0
+
+echo "🔍 校验计划 $CHANGE_DIR/tasks.md ..."
+
+if [ ! -f "$CHANGE_DIR/tasks.md" ]; then
+  echo "❌ tasks.md 不存在"
+  exit 1
+fi
+
+# 检查每个 task 是否有文件路径
+task_no_path=0
+while IFS= read -r line; do
+  task_name=$(echo "$line" | sed 's/.*Task [0-9]*: //')
+  # 简单检查：task 行之后 5 行内是否有路径相关关键词
+  echo "  📋 $line"
+done < <(grep '^\- \[ \] Task' "$CHANGE_DIR/tasks.md")
+
+# 检查是否有验证命令
+if grep -q "验证" "$CHANGE_DIR/tasks.md"; then
+  echo "  ✅ 包含验证步骤"
+else
+  echo "  ⚠️ 建议添加验证步骤"
+fi
+
+# 检查是否有 Wave 分组
+if grep -qi "wave\|并行\|依赖" "$CHANGE_DIR/tasks.md"; then
+  echo "  ✅ 包含执行顺序标注"
+else
+  echo "  ⚠️ 建议添加 Wave 分组"
+fi
+
+# 检查文件变更清单一致性
+if [ -f "$CHANGE_DIR/design.md" ]; then
+  design_files=$(grep -c '|' "$CHANGE_DIR/design.md" 2>/dev/null)
+  echo "  ✅ design.md 有 $design_files 行表格"
+fi
+
+echo ""
+echo "✅ 计划校验完成"

package/scripts/validate-proposal.sh

@@ -0,0 +1,87 @@
+#!/bin/bash
+# SillySpec 校验：propose 阶段输出
+# 用法：validate-proposal.sh <change-dir>
+# 示例：validate-proposal.sh .sillyspec/changes/docsite-redesign
+
+CHANGE_DIR="${1:?用法: validate-proposal.sh <change-dir>}"
+ERRORS=0
+
+check_section() {
+  local file="$1" section="$2"
+  if [ -f "$file" ]; then
+    if grep -q "## $section" "$file"; then
+      echo "  ✅ $file: 包含 '$section'"
+    else
+      echo "  ❌ $file: 缺少 '$section'"
+      ((ERRORS++))
+    fi
+  else
+    echo "  ❌ 文件不存在: $file"
+    ((ERRORS++))
+  fi
+}
+
+check_file_exists() {
+  if [ -f "$1" ]; then
+    echo "  ✅ $1 存在"
+  else
+    echo "  ❌ $1 不存在"
+    ((ERRORS++))
+  fi
+}
+
+echo "🔍 校验 $CHANGE_DIR ..."
+
+# proposal.md
+echo ""
+echo "--- proposal.md ---"
+check_section "$CHANGE_DIR/proposal.md" "动机"
+check_section "$CHANGE_DIR/proposal.md" "变更范围"
+check_section "$CHANGE_DIR/proposal.md" "不在范围内"
+check_section "$CHANGE_DIR/proposal.md" "成功标准"
+
+# design.md
+echo ""
+echo "--- design.md ---"
+check_file_exists "$CHANGE_DIR/design.md"
+check_section "$CHANGE_DIR/design.md" "文件变更清单"
+if [ -f "$CHANGE_DIR/design.md" ]; then
+  if grep -q "|" "$CHANGE_DIR/design.md"; then
+    echo "  ✅ design.md: 包含变更表格"
+  else
+    echo "  ❌ design.md: 缺少变更表格"
+    ((ERRORS++))
+  fi
+fi
+
+# tasks.md
+echo ""
+echo "--- tasks.md ---"
+check_file_exists "$CHANGE_DIR/tasks.md"
+if [ -f "$CHANGE_DIR/tasks.md" ]; then
+  task_count=$(grep -c '^\- \[ \] Task' "$CHANGE_DIR/tasks.md" 2>/dev/null)
+  echo "  ✅ tasks.md: $task_count 个 task"
+  if [ "$task_count" -eq 0 ]; then
+    echo "  ❌ tasks.md: 没有 task"
+    ((ERRORS++))
+  fi
+fi
+
+# requirements.md
+echo ""
+echo "--- requirements.md ---"
+if [ -f "$CHANGE_DIR/specs/requirements.md" ]; then
+  check_section "$CHANGE_DIR/specs/requirements.md" "功能需求"
+  check_section "$CHANGE_DIR/specs/requirements.md" "用户场景"
+else
+  check_file_exists "$CHANGE_DIR/specs/requirements.md"
+fi
+
+echo ""
+if [ $ERRORS -eq 0 ]; then
+  echo "✅ 校验通过，无错误"
+  exit 0
+else
+  echo "❌ 校验失败，$ERRORS 个错误"
+  exit 1
+fi

package/scripts/validate-scan.sh

@@ -0,0 +1,90 @@
+#!/bin/bash
+# SillySpec 校验：scan 阶段输出
+# 用法：validate-scan.sh [codebase-dir]
+# 默认检查 .sillyspec/codebase/
+
+CODEBASE_DIR="${1:-.sillyspec/codebase}"
+ERRORS=0
+
+# ── 路径误放检查 ──
+
+MISPLACED=0
+TARGET_DOCS="ARCHITECTURE.md STACK.md STRUCTURE.md CONVENTIONS.md INTEGRATIONS.md TESTING.md CONCERNS.md PROJECT.md SCAN-RAW.md"
+
+for name in $TARGET_DOCS; do
+  for f in $(find . -maxdepth 2 -name "$name" 2>/dev/null | grep -v "^\.\/$CODEBASE_DIR/"); do
+    if [ -f "$f" ]; then
+      echo "  ❌ 误放: $f（应在 $CODEBASE_DIR/ 下）"
+      ((MISPLACED++))
+      ((ERRORS++))
+    fi
+  done
+done
+
+if [ $MISPLACED -gt 0 ]; then
+  echo "  💡 运行 /sillyspec:scan 修正路径，或手动移动到 $CODEBASE_DIR/"
+fi
+
+# ── 文件完整性检查 ──
+
+echo "🔍 校验代码库扫描 $CODEBASE_DIR ..."
+
+if [ ! -d "$CODEBASE_DIR" ]; then
+  echo "  ❌ 目录 $CODEBASE_DIR 不存在"
+  exit 1
+fi
+
+# 深度扫描 7 份
+DEEP_FILES=(
+  "STACK.md"
+  "ARCHITECTURE.md"
+  "STRUCTURE.md"
+  "CONVENTIONS.md"
+  "INTEGRATIONS.md"
+  "TESTING.md"
+  "CONCERNS.md"
+)
+
+# 快速扫描 2 份 + PROJECT.md
+QUICK_FILES=(
+  "STACK.md"
+  "STRUCTURE.md"
+)
+
+# 检查深度扫描文件
+for f in "${DEEP_FILES[@]}"; do
+  if [ -f "$CODEBASE_DIR/$f" ]; then
+    lines=$(wc -l < "$CODEBASE_DIR/$f" | tr -d ' ')
+    if [ "$lines" -gt 3 ]; then
+      echo "  ✅ $f ($lines 行)"
+    else
+      echo "  ⚠️ $f 只有 $lines 行，内容可能不完整"
+      ((ERRORS++))
+    fi
+  else
+    echo "  ⬜ $f 不存在（深度扫描文件）"
+  fi
+done
+
+# 检查 PROJECT.md
+if [ -f ".sillyspec/PROJECT.md" ]; then
+  echo "  ✅ PROJECT.md 存在"
+else
+  echo "  ⚠️ PROJECT.md 不存在（建议生成）"
+fi
+
+# 检查 SCAN-RAW.md
+if [ -f "$CODEBASE_DIR/SCAN-RAW.md" ]; then
+  echo "  ✅ SCAN-RAW.md 存在（预处理数据）"
+fi
+
+# ── 结果 ──
+
+echo ""
+if [ $ERRORS -eq 0 ]; then
+  echo "✅ 扫描校验通过"
+  exit 0
+else
+  echo "❌ 扫描校验失败，$ERRORS 个问题"
+  exit 1
+fi