llm-content-pipeline-quality-gate

Procedure

1. ディレクトリ構成

project/
├── generate.sh          # 生成スクリプト本体
├── daily.sh             # launchd ラッパー（N本まとめて起草）
├── knowledge/           # LLMへ渡すナレッジファイル群
│   ├── persona.md
│   ├── style.md
│   └── quality-rubric.md
├── lib/
│   └── parse_avg.py     # SCORE行からavgを抽出
├── drafts/              # 生成済み下書き（人間レビュー前）
├── logs/
│   ├── gen.log          # 全生成ログ（OK/REJECTED）
│   ├── posted-types.log # 使った型ログ（重複回避）
│   └── posted-topics.log
└── PAUSED               # このファイルがあると全処理を停止

2. プロンプト組み立てパターン

# ナレッジを束ねる
KNOW=""
for f in persona style quality-rubric; do
  KNOW+=$'\n\n===== '"$f"$' =====\n'"$(cat "knowledge/$f.md")"
done

# grounding（一次情報）を差し込む
GROUND=""
for src in "$HOME/.remember/recent.md" "$HOME/.remember/now.md"; do
  [ -f "$src" ] && GROUND+=$'\n\n--- '"$(basename "$src")"$' ---\n'"$(head -c 4000 "$src")"
done
[ -z "$GROUND" ] && GROUND="（作業ログ無し）"

# 型・テーマの直近ログを読み込んで重複回避
LAST_TYPES=$(tail -3 logs/posted-types.log | paste -sd '、' -)
LAST_TOPICS=$(tail -8 logs/posted-topics.log | paste -sd '、' -)

3. LLM呼び出し（リトライ付き）

CLAUDE="${CLAUDE:-~/.local/bin/claude}"
MODEL="${MODEL:-sonnet}"
GEN_TIMEOUT="${GEN_TIMEOUT:-420}"

resp_is_valid() {
  local r="$1"
  [ -z "$r" ] && return 1
  printf '%s' "$r" | grep -q '^TYPE:' || return 1
  printf '%s' "$r" | grep -q '^SCORE:' || return 1
  printf '%s' "$r" | grep -qiE 'request timed out|usage limit|rate limit' && return 1
  [ "$(printf '%s' "$r" | wc -c | tr -d ' ')" -lt 600 ] && return 1
  return 0
}

RESP=""
for attempt in 1 2 3; do
  RESP=$(timeout "$GEN_TIMEOUT" "$CLAUDE" -p "$PROMPT" \
         --allowedTools WebSearch --model "$MODEL" 2>/dev/null)
  resp_is_valid "$RESP" && break
  echo "[gen] 生成失敗(試行${attempt}/3)。再試行…" >&2
  RESP=""
done
resp_is_valid "$RESP" || { echo "[gen] 3回試行後も失敗。" >&2; exit 1; }

4. スコア抽出 (lib/parse_avg.py)

#!/usr/bin/env python3
"""SCORE行(JSON or 雑な文字列)からavgを取り出す。失敗時は0。"""
import sys, json, re

s = sys.stdin.read().strip()
avg = 0
try:
    avg = float(json.loads(s).get("avg", 0))
except Exception:
    m = re.search(r'"?avg"?\s*[:=]\s*([0-9]+(?:\.[0-9]+)?)', s)
    if m:
        avg = float(m.group(1))
print(avg)

5. 品質ゲート

SCORE=$(printf '%s\n' "$RESP" | sed -n 's/^SCORE: *//p' | head -1)
AVG=$(printf '%s' "$SCORE" | python3 lib/parse_avg.py 2>/dev/null)
[ -z "$AVG" ] && AVG=0

MIN_AVG="${MIN_AVG:-7.0}"
if python3 -c "import sys; sys.exit(0 if float('$AVG') >= float('$MIN_AVG') else 1)"; then
  :  # 通過
else
  echo "[gen] 品質avg=$AVG < $MIN_AVG。棄却。" >&2
  echo "$(date '+%F %T')	REJECTED_LOWSCORE	avg=$AVG" >> logs/gen.log
  exit 2
fi

6. ファイル出力とローテーションログ記録

TS=$(date +%Y-%m-%d_%H%M%S)
FNAME="drafts/${TS}.md"
{
  printf '<!-- TYPE: %s | SCORE_AVG: %s | gen: %s -->\n\n' "$TYPE" "$AVG" "$TS"
  printf '%s\n' "$BODY"
} > "$FNAME"

echo "$TYPE"  >> logs/posted-types.log
echo "$TOPIC" >> logs/posted-topics.log
echo "$(date '+%F %T')	OK	avg=$AVG	$TYPE	$TOPIC	$FNAME" >> logs/gen.log

7. launchd ラッパー (daily.sh)

#!/bin/bash
set -uo pipefail
DIR="$(cd "$(dirname "$0")" && pwd)"
N="${DAILY_N:-2}"

# launchd最小環境でnvmを通す
export NVM_DIR="${NVM_DIR:-$HOME/.nvm}"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" >/dev/null 2>&1

# PAUSEDキルスイッチ
[ -f "$DIR/PAUSED" ] && { echo "[daily] PAUSED"; exit 0; }

ok=0
for i in $(seq 1 "$N"); do
  bash "$DIR/generate.sh" && ok=$((ok+1))
  sleep 2
done
echo "[daily] 起草 $ok/$N 本"

Pitfalls

• SCORE行のパース: LLMが SCORE: {"avg":7.2} の形式を守らないことがある。parse_avg.py はJSON失敗時に正規表現フォールバックを持たせる
• リトライ中のtimeout累積: GEN_TIMEOUT × 3 が最大待ち時間になる。launchd の StartInterval より小さく設定すること
• posted-types.log の肥大化: tail -3 で読むだけなのでサイズは問題ないが、定期的に wc -l で確認すると安心
• nvm PATH: launchd は ~/.zshrc を読まない。NVM_DIR を .env に書くか daily.sh で直接 source する
• PAUSEDファイル: 緊急停止用。touch PAUSED で全処理が止まる。解除は rm PAUSED

Verification

# ドライラン（テストレスポンスを差し込む）
export X_ARTICLE_TEST_RESPONSE='TYPE: 実録
TOPIC: Claude Code自動化
SCORE: {"hook":8,"value":7,"avg":7.5}

# テスト記事本文
'
bash generate.sh
# → drafts/ にファイルが出力されることを確認

# 品質ゲートのテスト（avg 5.0 → 棄却されること）
export X_ARTICLE_TEST_RESPONSE='TYPE: 実録
TOPIC: テスト
SCORE: {"hook":5,"value":5,"avg":5.0}

# 低品質記事
'
bash generate.sh
# → exit code 2 で終了し、drafts/ に出力されないことを確認

# ログ確認
cat logs/gen.log