jp-harness-tune

jp-harness-tune — jp_lint ルールの対話チューニング

ja-output-harness を運用していると「プロジェクト文脈では避けたくない語が検出される」「逆に固有の避けたい語が検出されない」というケースに遭遇する。このスキルは利用者の判断を対話で引き出し、結果を ja-output-tune CLI で ~/.codex/jp_lint.yaml に反映する。

前提: ja-output-harness がインストール済みで、ja-output-tune が PATH から実行できる（uv sync 済み、または pip install -e . 済み）。

呼び出し方

Codex（CLI / App）の入力欄で $ を押してスキル一覧を開き、$jp-harness-tune を選択する。対象語がある場合は後続に自然文で記述する（例: $jp-harness-tune slice を無効化したい）。

Step 1: 現状の把握

ja-output-tune show を実行し、バンドル規則とユーザー override を merge した後の有効ルールを確認する。件数と、利用者が気にしている語の現在の severity だけを簡潔に示す。

ja-output-tune show

Step 2: 操作意図のヒアリング

次の 6 つから意図を特定する。利用者の opening メッセージにいずれかを明確に示す語が含まれているかをまず確認し、含まれていない時だけこの番号付きメニューを提示する:

1. 無効化 — バンドル済みの語を検出対象から外したい（キーワード: 無効化, 外したい, 検出しないで, disable）
2. severity 調整 — 検出は続けたいが ERROR は厳しい → WARNING / INFO に緩めたい（キーワード: severity, WARNING に下げ, 弱めたい）
3. 追加 — プロジェクト固有の避けたい語をルールに追加したい（キーワード: 追加, 禁止語に入れ, add）
4. 削除（add の取り消し） — 以前 add した語を外したい（キーワード: 削除, 取り消し, remove）
5. 確認のみ — 今の状態を見たいだけ（キーワード: 確認, 一覧, show）
6. 候補抽出（discover） — 最近の Codex 出力を見せるので、未登録の生英語候補を抽出して追加判断したい（キーワード: 候補抽出, discover, 最近の出力から, 出力を見て追加, どの語を足す）

上記のいずれかに該当するキーワードが opening メッセージにあれば、番号確認は省いて該当 Step へ直行する。slice と done をどう扱うべきか のように特定語が提示されているが意図が曖昧な場合は意図 1 または 2 として扱い、判断支援（Step 3）に進む。

複数の意図が読み取れる場合、または意図がまったく読み取れない場合のみ、上の 1-6 を番号付きで提示して利用者に選ばせる。

Step 2b: discover フロー（意図 6 の場合）

利用者が 6 を選んだ場合のみ、このフローを回す。他の意図なら Step 3 へ進む。

2b-1. 入力を受け取る

次のいずれかで Codex 出力を取得する:

• paste 方式: 「直近の Codex 応答を貼ってください（終端は空行 2 回）」と案内し、paste 内容を一時ファイルに保存
• file 方式: ログや handoff メモのパスを指定してもらう（例: .claude/local/operator-handoff.md）

2b-2. 候補を抽出

ja-output-tune discover --file <path> --top 20
# もしくは stdin 経由:
cat <path> | ja-output-tune discover --stdin --top 20

出力は TSV 4 列: count \t term \t 推奨言い換え \t 代表文脈。

2b-3. 1 語ずつヒアリング

抽出された候補を上から順に提示し、1 語ずつ以下を確認する:

• 追加するか（Y/N）。UI ラベルや製品名、固有名詞（例: Back to Code, Ports）は N が基本
• 推奨言い換え: suggest 列の提案をそのまま採用するか、別案を書いてもらう。提案が空欄のケースは必ず利用者に入力を促す
• severity: 既定 ERROR で良いか。一般名詞の wrapper / helper 等は WARNING で十分な場合もある