| name | 22-substitution-frontmatter |
| description | Single-quote isolation probe to fill team-report §1.2 unverified cells. Tests Claude Code pre-substitution in plugin-level hook + skill frontmatter hook + skill body for SESSION_ID, PROJECT_DIR, SKILL_DIR, and user_config.KEY. |
| user-invocable | true |
| hooks | {"PreToolUse":[{"matcher":"Bash","hooks":[{"type":"command","command":"\"${CLAUDE_PLUGIN_ROOT}/hooks/subst-probe.sh\" fm SESSION_ID '${CLAUDE_SESSION_ID}'"},{"type":"command","command":"\"${CLAUDE_PLUGIN_ROOT}/hooks/subst-probe.sh\" fm PROJECT_DIR '${CLAUDE_PROJECT_DIR}'"},{"type":"command","command":"\"${CLAUDE_PLUGIN_ROOT}/hooks/subst-probe.sh\" fm SKILL_DIR '${CLAUDE_SKILL_DIR}'"}]}]} |
22-substitution-frontmatter
§1.2 マトリクスの未検証セルを single-quote isolation で観測する probe。
観測の仕組み
'${CLAUDE_SESSION_ID}' のように single-quote 内に ${VAR} を書くと：
- 事前置換あり → Claude Code 本体が string を書き換え、shell には実値が渡る → log に実値
- 事前置換なし → string そのまま shell に渡る、single-quote で shell expansion 抑止 → log に literal
${...}
期待結果（v2.1.146 推測）：
| tier | SESSION_ID | PROJECT_DIR | SKILL_DIR | user_config.KEY |
|---|
| plugin-level | ? | ✅ | ? | ✅ |
| frontmatter | ? | ? | ? | — |
| body | ✅ | ✅ | ✅ | ? |
step 1: body tier の事前置換を観測 + 直近 log を表示
proj="${CLAUDE_PROJECT_DIR:-$PWD}"
ver="${VERIFIER_VERSION_DIR:-v-unknown}"
out_dir="$proj/findings/$ver/probe-22"
mkdir -p "$out_dir"
echo '[BODY] USER_CONFIG_HELLO=${user_config.hello_message}' >> "$out_dir/subst.log"
echo '[BODY] USER_CONFIG_API=${user_config.api_secret}' >> "$out_dir/subst.log"
echo '[BODY] SESSION_ID=${CLAUDE_SESSION_ID}' >> "$out_dir/subst.log"
echo '[BODY] PROJECT_DIR=${CLAUDE_PROJECT_DIR}' >> "$out_dir/subst.log"
echo '[BODY] SKILL_DIR=${CLAUDE_SKILL_DIR}' >> "$out_dir/subst.log"
echo "=== subst.log (tier=plugin: SessionStart 経路, tier=fm: 自スキル frontmatter 経路, tier=body: 直前 echo) ==="
cat "$out_dir/subst.log"
判定ロジック
各行を見て：
- 値が UUID (例:
9307ae27-...) → 事前置換 ✅
- 値が絶対パス (例:
/home/...) → 事前置換 ✅
- 値が空 → 事前置換 ✅ だが値が unset
- 値が literal
${CLAUDE_SESSION_ID} 等 → 事前置換 ❌
完了したら exit。
