| name | ja-tech-edit-score-check |
| description | 開いている Markdown 原稿について、推敲ブランチの編集内容が ja-tech-edit-score 選好評価モデルに 沿っているか hunk 単位で採点する。ユーザーが「推敲チェック」「選好チェック」 「pref チェック」と言ったとき、または edit/* ブランチ上の章ファイルの選好スコアを 確認したいときに使う。 |
| disable-model-invocation | true |
ja-tech-edit-score 選好チェック
推敲ブランチのファイルについて、下書きブランチとの diff を hunk 単位で採点し、
選好評価モデルが edit 方向を支持するかを報告する。
前提
- ツール本体: 環境変数
JA_TECH_EDIT_SCORE_HOME（未設定時は clone 先。例: ~/dev/ja-tech-edit-score）
- CLI:
ja-tech-edit-score-check（make install-bin で ~/.local/bin に symlink）
- ラッパーが PATH にない場合:
"$JA_TECH_EDIT_SCORE_HOME/bin/ja-tech-edit-score-check"
- 学習済みモデル:
"$JA_TECH_EDIT_SCORE_HOME/outputs/pref-static/"（リポジトリ同梱）
- 対象リポジトリは edit/ ブランチ上であること（例:
edit/chapter-name）
- 下書きブランチは
edit/foo から foo を自動推定する（必要なら --base）
- 未コミットの編集を含む（既定:
git diff <base> -- file）。コミット済みのみは --committed
- 2 回目以降はモデル常駐デーモンにより高速（初回のみデーモン起動で約 9 秒）
手順
- ユーザーが開いているファイル、または
@ で指定された Markdown ファイルのパスを特定する
- パスは 絶対パス に解決する
- シェルで次を実行する（必ず実際に実行し、自前解析で代用しない）:
ja-tech-edit-score-check "/absolute/path/to/file.md" --format markdown
PATH に CLI がない場合:
"${JA_TECH_EDIT_SCORE_HOME:-$HOME/dev/ja-tech-edit-score}/bin/ja-tech-edit-score-check" \
"/absolute/path/to/file.md" \
--format markdown
- 標準出力をそのままユーザーに提示する（数値サマリー、全 hunk スコア、対称評価内訳を含む）
要確認 または preferred_base の hunk があれば、著者による確認を促す
オプション
| オプション | 用途 |
|---|
--format markdown | Cursor チャット向け（既定でこれを使う） |
--format text | ターミナル向け |
--format json | 機械処理向け |
--only-flagged | 問題 hunk のみ |
--base BRANCH | 下書きブランチを明示 |
--edit BRANCH | 現在ブランチ名の表示用（省略時: 現在ブランチ） |
--committed | 作業ツリーではなく base..edit のコミット済み diff のみ |
--no-daemon | デーモンを使わず都度モデルを読み込む |
判定の読み方
| verdict | 意味 |
|---|
preferred_edit | 選好評価モデルは edit 方向を支持 |
uncertain | 差が小さい。著者が判断 |
preferred_base | 下書き側の方が選好に近い。要確認 |
reject_edit | edit 方向が強く非選好 |
選好評価モデルは学習データの文体と推敲パターンに依存する。
低スコアの hunk が必ずしも誤りとは限らない。
2候補の比較
推敲案 A と B を比較するときは ja-tech-edit-score-compare を使う:
ja-tech-edit-score-compare \
--source-file /tmp/source.txt \
--candidate-a-file /tmp/a.txt \
--candidate-b-file /tmp/b.txt
トラブルシュート
model not found → outputs/pref-static/model.joblib があるか確認。更新する場合は make traincannot infer base branch → --base <draft-branch> を付けるno scorable hunks → ファイルが下書きと同一（未保存または未変更）。編集後に再実行--committed 使用時は推敲ブランチにコミットが必要- Skill が見つからない → リポジトリで
make install-skills を実行
