用户决定: 以后只 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+)
109 lines
3.7 KiB
Bash
Executable File
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
|