接続フォルダは、何を渡すかより何を歩かせないかで決まります

#!/usr/bin/env bash
# scope-probe.sh — 接続フォルダをエージェントに渡す前に、走査の範囲を一度だけ測る。
# 使い方: ./scope-probe.sh <フォルダ> [検索語]
set -uo pipefail
 
ROOT="${1:?usage: scope-probe.sh <folder> [pattern]}"
PAT="${2:-TODO}"
SKIP=(node_modules .git .next .venv dist build vendor __pycache__)
 
cd "$ROOT" || exit 1
 
# --- 1. 何本のファイルを歩くことになるのか（find は1パスだけ流す） ---
find . -type f -print0 2>/dev/null | awk -v RS='\0' -v skip="${SKIP[*]}" '
  BEGIN { n = split(skip, s, " ") }
  { total++
    hit = 0
    for (i = 1; i <= n; i++) if (index($0, "/" s[i] "/")) { c[s[i]]++; hit = 1; break }
    if (!hit) work++ }
  END {
    printf "  合計        %8d\n", total
    for (i = 1; i <= n; i++) if (c[s[i]]) printf "  %-10s  %8d  (%4.1f%%)\n", s[i], c[s[i]], c[s[i]]*100/total
    printf "  実作業      %8d  (%4.1f%%)\n", work, work*100/total }'
 
# --- 2. 既定の検索と、範囲を明示した検索で件数が変わるか ---
GLOBS=(); for d in "${SKIP[@]}"; do GLOBS+=(-g "!**/$d/**"); done
 
t0=$(date +%s%3N); rg -l --no-ignore --hidden "${GLOBS[@]}" -- "$PAT" . 2>/dev/null | sort > /tmp/scope_full.txt; t1=$(date +%s%3N)
t2=$(date +%s%3N); rg -l -- "$PAT" . 2>/dev/null | sort > /tmp/scope_default.txt; t3=$(date +%s%3N)
 
echo "  範囲を明示   $(wc -l < /tmp/scope_full.txt) 件  $(( t1 - t0 )) ms"
echo "  既定のまま   $(wc -l < /tmp/scope_default.txt) 件  $(( t3 - t2 )) ms"
 
# --- 3. 既定が黙って飛ばした分を、置き場所ごとに見せる ---
MISS=$(comm -23 /tmp/scope_full.txt /tmp/scope_default.txt | tee /tmp/scope_missed.txt | wc -l)
echo "  既定の取りこぼし ${MISS} 件"
[ "$MISS" -gt 0 ] && awk -F/ '{print "    " $2 "/" $3}' /tmp/scope_missed.txt \
  | sort | uniq -c | sort -rn | head -5
 
# 取りこぼしゼロが正常。1件でもあれば、その置き場所を走査設計に書き足す。
[ "$MISS" -eq 0 ]

$ ./scope-probe.sh "/path/to/workspace" premium
  合計          103845
  node_modules     81359  (78.3%)
  .git              7092  ( 6.8%)
  __pycache__         12  ( 0.0%)
  実作業           15382  (14.8%)
  範囲を明示   4277 件  11132 ms
  既定のまま   4142 件  6370 ms
  既定の取りこぼし 136 件
     78     rorklab.net/public
     46     gemilab.net/public
      3     .agents/skills
      2     rorklab.net/src
      2     gemilab.net/src

./_documents/_quality_audit/_scripts/__pycache__/article_gate.py.bak_2026-09-02

# sub/ を .rgignore に書いた状態
$ rg -l needle .
./top.txt                 # sub/ は飛ばされる
 
$ rg -l --no-ignore needle .
./sub/a.txt               # .rgignore ごと無効になるので見える
./top.txt

# 走査の既定をひとつに固定する。無人タスクからも手元からも同じものを呼ぶ。
scan() {  # scan <検索語> [パス]
  rg -l --no-ignore --hidden \
     -g '!**/node_modules/**' -g '!**/.git/**' -g '!**/.next/**' \
     -- "$1" "${2:-.}"
}