#!/bin/bash # 教材品質チェック統合スクリプト # すべてのチェックを実行し、最終結果をまとめる # 引数: ファイルパス(複数可)またはディレクトリパス SCRIPT_DIR="$(dirname "$0")" FAILED=0 FILES=() ROOTS=() if [ $# -eq 0 ]; then echo "❌ エラー: ファイルパスまたはディレクトリを指定してください" echo "使用法: bash scripts/curriculum-qa/check_quality.sh material/30days-curriculum/dayXX_xxx.md" echo " bash scripts/curriculum-qa/check_quality.sh material/30days-curriculum/" exit 1 fi # 引数を展開: ディレクトリなら配下の教材md(day/appendix)を収集、ファイルはそのまま追加 # 目次・ロードマップ等のナビ文書は日次教材の構造チェック(Agenda/表/スクショ)の # 対象外なので、ディレクトリ一括では day/appendix のみを見る。 # 注: CIのGate2は dayXX_*.md のみを対象にしており、ここ(day+appendix)より狭い。 # 命名規則を外れた md(day1_x.md 等)が無検査のまま通過しないよう、 # 許可パターン外のファイルが存在したら FAIL するガードを併設する。 for arg in "$@"; do if [ -d "$arg" ]; then # ガード: 許可パターン {day[0-9][0-9]_*, appendix_*, 00_*, 00-1_*} 以外の md を検出 UNEXPECTED=$(find "$arg" -type f -name "*.md" \ ! -name "day[0-9][0-9]_*.md" \ ! -name "appendix_*.md" \ ! -name "00_*.md" \ ! -name "00-1_*.md" | sort) if [ -n "$UNEXPECTED" ]; then echo "❌ エラー: 命名規則外の md ファイルを検出しました(品質ゲートの対象外になるため許可できません):" echo "$UNEXPECTED" echo " day ファイルは day[0-9][0-9]_*.md 形式に、付録は appendix_*.md 形式にリネームしてください" exit 1 fi while IFS= read -r f; do FILES+=("$f") done < <(find "$arg" -type f \( -name "day[0-9][0-9]_*.md" -o -name "appendix_*.md" \) | sort) ROOTS+=("$arg") elif [ -f "$arg" ]; then FILES+=("$arg") ROOTS+=("$(dirname "$arg")") else echo "❌ エラー: ファイルが見つかりません: $arg" exit 1 fi done if [ ${#FILES[@]} -eq 0 ]; then echo "❌ エラー: 対象ファイルが見つかりませんでした" exit 1 fi run_checks_for_file() { local TARGET_FILE="$1" local FILE_FAILED=0 echo "" echo "🔍 品質チェック開始: $TARGET_FILE" echo "" # 1. 視覚化チェック(表・スクショ・Mermaid図) echo "==========================================" echo "📊 Step 1: 視覚化チェック" echo "==========================================" if [ ! -f "$SCRIPT_DIR/check_visualization.py" ]; then echo "❌ Step 1 FAIL (スクリプト欠落: check_visualization.py)" FILE_FAILED=1 elif python3 "$SCRIPT_DIR/check_visualization.py" "$TARGET_FILE"; then echo "✅ Step 1 PASS" else echo "❌ Step 1 FAIL" FILE_FAILED=1 fi # 2. コードブロック長さチェック(25行以下) echo "" echo "==========================================" echo "📏 Step 2: コードブロック長さチェック" echo "==========================================" if [ ! -f "$SCRIPT_DIR/check_step_length.py" ]; then echo "❌ Step 2 FAIL (スクリプト欠落: check_step_length.py)" FILE_FAILED=1 elif python3 "$SCRIPT_DIR/check_step_length.py" "$TARGET_FILE"; then echo "✅ Step 2 PASS" else echo "❌ Step 2 FAIL" FILE_FAILED=1 fi # 3. ステップ連続性チェック(省略なし) echo "" echo "==========================================" echo "🔗 Step 3: ステップ連続性チェック" echo "==========================================" if [ ! -f "$SCRIPT_DIR/check_no_skip.py" ]; then echo "❌ Step 3 FAIL (スクリプト欠落: check_no_skip.py)" FILE_FAILED=1 elif python3 "$SCRIPT_DIR/check_no_skip.py" "$TARGET_FILE"; then echo "✅ Step 3 PASS" else echo "❌ Step 3 FAIL" FILE_FAILED=1 fi # 4. 禁止ワードチェック echo "" echo "==========================================" echo "🚫 Step 4: 禁止ワードチェック" echo "==========================================" FORBIDDEN_WORDS=("同様に" "残りも" "以下略" "簡単です" "同じように") FOUND_FORBIDDEN=0 for word in "${FORBIDDEN_WORDS[@]}"; do if grep -q "$word" "$TARGET_FILE"; then echo "❌ 禁止ワード発見: '$word'" grep -n "$word" "$TARGET_FILE" | head -5 FOUND_FORBIDDEN=1 fi done if [ $FOUND_FORBIDDEN -eq 0 ]; then echo "✅ 禁止ワードなし" echo "✅ Step 4 PASS" else echo "❌ Step 4 FAIL" FILE_FAILED=1 fi # 5. 技術スタックチェック(shadcn/ui必須、MUI禁止) echo "" echo "==========================================" echo "🛠️ Step 5: 技術スタックチェック" echo "==========================================" if [ ! -f "$SCRIPT_DIR/check_tech_stack.py" ]; then echo "❌ Step 5 FAIL (スクリプト欠落: check_tech_stack.py)" FILE_FAILED=1 elif python3 "$SCRIPT_DIR/check_tech_stack.py" "$TARGET_FILE"; then echo "✅ Step 5 PASS" else echo "❌ Step 5 FAIL" FILE_FAILED=1 fi # 6. コード完全性チェック(filepath:コメント、省略禁止) echo "" echo "==========================================" echo "📝 Step 6: コード完全性チェック" echo "==========================================" if [ ! -f "$SCRIPT_DIR/check_code_completeness.py" ]; then echo "❌ Step 6 FAIL (スクリプト欠落: check_code_completeness.py)" FILE_FAILED=1 elif python3 "$SCRIPT_DIR/check_code_completeness.py" "$TARGET_FILE"; then echo "✅ Step 6 PASS" else echo "❌ Step 6 FAIL" FILE_FAILED=1 fi # 7. 文体チェック(敬体一貫・AI構文ゼロ・関西弁混入ゼロ) echo "" echo "==========================================" echo "🗣️ Step 7: 文体チェック" echo "==========================================" if [ ! -f "$SCRIPT_DIR/check_tone.py" ]; then echo "❌ Step 7 FAIL (スクリプト欠落: check_tone.py)" FILE_FAILED=1 elif python3 "$SCRIPT_DIR/check_tone.py" "$TARGET_FILE"; then echo "✅ Step 7 PASS" else echo "❌ Step 7 FAIL" FILE_FAILED=1 fi # 8. 理解度チェック(専門用語・確認ポイント) echo "" echo "==========================================" echo "🎓 Step 8: 理解度チェック" echo "==========================================" if [ ! -f "$SCRIPT_DIR/check_comprehension.py" ]; then echo "❌ Step 8 FAIL (スクリプト欠落: check_comprehension.py)" FILE_FAILED=1 elif python3 "$SCRIPT_DIR/check_comprehension.py" "$TARGET_FILE"; then echo "✅ Step 8 PASS" else echo "❌ Step 8 FAIL" FILE_FAILED=1 fi return $FILE_FAILED } # corpus 全体を一度に見る検査。CI の Gate 4 と同じ顔ぶれをここでも走らせる。 # # ここを入れる前は、手元が緑でも CI が赤くなることがあった。Gate 4 は # 「day13 の語を直した結果 day20 と表記が割れた」型の破損を見るので、 # 1ファイル単位のチェックだけでは原理的に観測できない。手元の判定が # CI の判定を予測しないと、赤くなるのはPRを出したあとになる。 # # 1ファイルだけを渡された場合も、そのファイルが置かれているディレクトリを # corpus とみなして走らせる。範囲を狭めると、また同じずれが戻ってくる。 CORPUS_CHECKS=( check_variants check_step_time check_anchor check_procedure_order check_step_ref check_tag_balance check_unclosed_screen check_false_success check_zip_reference check_unused_image check_jsx_marker check_ja_line_break check_ja_latin_space check_why check_terms check_crossref check_setext_heading check_quiz check_scaffold_src_sync check_version_split check_complete_code check_fence_roles check_complete_section_fences run_writing_lint ) # 検査そのものの退行テスト。Gate 4 は本体とセットでこれも走らせる。 SELF_TESTS=( test_markdown_scan test_check_crossref test_check_variants test_check_step_time test_check_anchor test_check_procedure_order test_check_step_ref test_sale_package test_build_zip test_check_tag_balance test_check_unclosed_screen test_check_false_success test_check_zip_reference test_check_unused_image test_check_jsx_marker test_check_ja_line_break test_check_ja_latin_space test_check_scaffold_alignment test_check_why test_check_tone test_check_code_completeness test_check_comprehension test_check_no_skip test_check_step_length test_check_tech_stack test_check_terms test_check_visualization test_check_setext_heading test_check_quiz test_filepath_marker test_build_day_snapshots test_shoot_screenshots test_check_scaffold_src_sync test_check_version_split test_check_complete_code test_check_fence_roles test_check_complete_section_fences test_run_writing_lint ) run_corpus_checks() { local corpus_failed=0 echo "" echo "==========================================" echo "🧪 Gate 4 相当: 検査そのものの退行テスト" echo "==========================================" for t in "${SELF_TESTS[@]}"; do if [ ! -f "$SCRIPT_DIR/$t.py" ]; then echo "❌ $t FAIL (スクリプト欠落: $t.py)" corpus_failed=1 elif python3 "$SCRIPT_DIR/$t.py"; then : else echo "❌ $t FAIL" corpus_failed=1 fi done # 同じディレクトリを2回渡されても1回だけ走らせる。 local seen=() for root in "${ROOTS[@]}"; do local dup=0 for s in "${seen[@]}"; do [ "$s" = "$root" ] && dup=1 done [ $dup -eq 1 ] && continue seen+=("$root") # day ファイルが1つも無い置き場は corpus ではない。ここを見ないと、 # 教材以外の md を1枚渡しただけで「dayファイルが見つかりません」で落ちる。 if ! compgen -G "$root/day[0-9][0-9]_*.md" > /dev/null; then echo "" echo "⏭️ corpus 全体チェックは対象外(day ファイルがありません): $root" continue fi echo "" echo "==========================================" echo "🌐 Gate 4 相当: corpus 全体チェック ($root)" echo "==========================================" for c in "${CORPUS_CHECKS[@]}"; do if [ ! -f "$SCRIPT_DIR/$c.py" ]; then echo "❌ $c FAIL (スクリプト欠落: $c.py)" corpus_failed=1 elif python3 "$SCRIPT_DIR/$c.py" "$root"; then : else echo "❌ $c FAIL" corpus_failed=1 fi done done return $corpus_failed } # 全ファイルを処理 for f in "${FILES[@]}"; do if ! run_checks_for_file "$f"; then FAILED=1 fi done if ! run_corpus_checks; then FAILED=1 fi # 最終結果 echo "" echo "==========================================" echo "📋 品質チェック結果 (${#FILES[@]} ファイル)" echo "==========================================" if [ $FAILED -eq 0 ]; then echo "✅ ALL CHECKS PASS" exit 0 else echo "❌ SOME CHECKS FAIL" exit 1 fi