Files
claude-config/skills/ssw-loop/scripts/check_required_docs.sh
T
ssw 896208c34a feat(ssw-loop): v2.0+ 只 MD 不 HTML (删老 HTML tmpl + 老 vendor + legacy gate 分支)
用户决定: 以后只 MD 不 HTML. 全清:
- templates/docs/{design,testcase,summary}.html.tmpl (3 老 HTML tmpl)
- templates/html/{style.css,script.js,mermaid.css} (3 老 vendor)
- scripts/scaffold.sh 删 create 老 HTML 步骤 (5.0+ scaffold 流程简化)
- scripts/check_required_docs.sh 删 legacy mode 分支 (只 new mode)

剩余 v2.0+ 8 文件检测: render.html + 7 MD (design/testcase/summary/plan/debug/research/learnings)

jxcj 验证: 关卡 A + 关卡 F 双 PASS (新架构)
testspace / workSystem / dos 影响: 仍用 HTML 的 app 现在 gate A FAIL, 需迁移到 MD (Phase 3+)
2026-07-16 20:21:49 +08:00

109 lines
3.7 KiB
Bash
Executable File

#!/bin/bash
# 关卡 A: 文档完整 (v2.0+: 7 MD + 1 render.html, **只 MD 不 HTML**)
# 用法: bash check_required_docs.sh <app_dir>
#
# 必填文档 (v2.0+ 统一架构):
# - 3 主 MD: design.md / testcase.md / summary.md
# - 1 入口: render.html
# - 4 运营 MD: plan.md / debug.md / research.md / learnings.md
#
# 历史: v1.0 双模式 (新 + 老 HTML 向后兼容), v2.0 删老 HTML, 只 MD
set -e
APP_DIR="${1:?用法: $0 <app_dir>, 例: $0 docs/jxcj}"
MISSING=()
WARN=()
echo "🔍 关卡 A: 检查 8 文件齐全 (v2.0+ 只 MD 不 HTML)"
echo " app_dir: $APP_DIR"
# ============================================================
# 1. 必填文档检测
# ============================================================
echo " [主文档检测]"
for f in design.md testcase.md summary.md; do
if [ ! -f "$APP_DIR/$f" ]; then
MISSING+=("$f")
fi
done
echo " [入口检测]"
if [ ! -f "$APP_DIR/render.html" ]; then
MISSING+=("render.html")
fi
echo " [运营 MD 检测]"
for f in plan.md debug.md research.md learnings.md; do
if [ ! -f "$APP_DIR/$f" ]; then
MISSING+=("$f")
fi
done
# ============================================================
# 2. 缺失文件汇总
# ============================================================
if [ ${#MISSING[@]} -gt 0 ]; then
echo ""
echo "❌ FAIL: 缺失文档: ${MISSING[*]}"
echo ""
echo "修复: bash .claude/skills/ssw-loop/scripts/scaffold.sh $(basename "$APP_DIR")"
exit 1
fi
echo " ✓ 3 主文档 MD 在 (design/testcase/summary)"
echo " ✓ 1 入口 (render.html) 在"
echo " ✓ 4 运营 MD 在 (plan/debug/research/learnings)"
# ============================================================
# 3. 行数下限检测 (避免假产出)
# ============================================================
echo " [行数下限]"
MIN_DESIGN=80
MIN_TESTCASE=40
MIN_SUMMARY=50
MIN_PLAN=30
MIN_DEBUG=20
MIN_RESEARCH=10
MIN_LEARNINGS=30
DESIGN_LINES=$(wc -l < "$APP_DIR/design.md")
TESTCASE_LINES=$(wc -l < "$APP_DIR/testcase.md")
SUMMARY_LINES=$(wc -l < "$APP_DIR/summary.md")
PLAN_LINES=$(wc -l < "$APP_DIR/plan.md")
DEBUG_LINES=$(wc -l < "$APP_DIR/debug.md")
RESEARCH_LINES=$(wc -l < "$APP_DIR/research.md")
LEARNINGS_LINES=$(wc -l < "$APP_DIR/learnings.md")
[ $DESIGN_LINES -lt $MIN_DESIGN ] && WARN+=("design.md $DESIGN_LINES 行 (< $MIN_DESIGN 警戒)")
[ $TESTCASE_LINES -lt $MIN_TESTCASE ] && WARN+=("testcase.md $TESTCASE_LINES 行 (< $MIN_TESTCASE 警戒)")
[ $SUMMARY_LINES -lt $MIN_SUMMARY ] && WARN+=("summary.md $SUMMARY_LINES 行 (< $MIN_SUMMARY 警戒)")
[ $PLAN_LINES -lt $MIN_PLAN ] && WARN+=("plan.md $PLAN_LINES 行 (< $MIN_PLAN 警戒)")
[ $DEBUG_LINES -lt $MIN_DEBUG ] && WARN+=("debug.md $DEBUG_LINES 行 (< $MIN_DEBUG 警戒)")
[ $RESEARCH_LINES -lt $MIN_RESEARCH ] && WARN+=("research.md $RESEARCH_LINES 行 (< $MIN_RESEARCH 警戒)")
[ $LEARNINGS_LINES -lt $MIN_LEARNINGS ] && WARN+=("learnings.md $LEARNINGS_LINES 行 (< $MIN_LEARNINGS 警戒)")
echo " [行数汇总]"
echo " design.md $DESIGN_LINES 行"
echo " testcase.md $TESTCASE_LINES 行"
echo " summary.md $SUMMARY_LINES 行"
echo " plan.md $PLAN_LINES 行"
echo " debug.md $DEBUG_LINES 行"
echo " research.md $RESEARCH_LINES 行"
echo " learnings.md $LEARNINGS_LINES 行"
# ============================================================
# 4. 报告
# ============================================================
if [ ${#WARN[@]} -gt 0 ]; then
echo ""
echo "⚠️ WARN (行数过少, 可能假产出):"
for w in "${WARN[@]}"; do
echo " - $w"
done
exit 2 # WARN 退出码 2
fi
echo ""
echo "✅ PASS: 8 文件齐全, 行数合理 (v2.0+ 只 MD)"
exit 0