Skip to content

docs: review の検出品質を上げる実装プランを追加 - #86

Open
takemi-ohama wants to merge 1 commit into
mainfrom
docs/review-detection-quality-plan
Open

docs: review の検出品質を上げる実装プランを追加#86
takemi-ohama wants to merge 1 commit into
mainfrom
docs/review-detection-quality-plan

Conversation

@takemi-ohama

Copy link
Copy Markdown
Contributor

Summary

cross-review の往復が 17 PR / 平均 4.1 ラウンド(最大 10 ラウンド)かかっている実測を起点に、
ndf:review指摘を投稿する前に落とす仕組みを入れる実装プランを追加する。

追加するのは issues/review-detection-quality.md の 1 ファイルのみで、実装は含まない。

プランの骨子は 3 つ。

  1. 指摘ごとに根拠を必須にする(correctness 系は再現条件、文書系は矛盾する対象)
  2. 投稿前に各指摘を反証する自己検証パスを置き、plausible は投稿しない
  3. 一度却下された論点を次ラウンドへ渡し、新しい根拠がない限り再提出させない

あわせて cross-reviewby_verdict を記録し、往復回数と却下率を継続的に測れるようにする(Task 4/5)。

関連

レビュー反映済みの内容

作成後に /ndf:review/code-review(high, 29 エージェント)の 2 系統でレビューし、
検証済み 10 件を反映してある。主なものは以下。

指摘反映内容
Task 3 の対象ファイルに state.py が無いcmd_merge_fixrejected を件数 int へ潰している事実を前提条件として明記し、対象へ追加
launch-codex.sh / launch-gemini.sh が全タスクの対象外実書式と result.json スキーマがこの 2 本に埋め込まれている旨を明記し、Task 1/2/3 の対象へ追加
by_verdict の書き出し先が実行系と不一致/tmp 系と $TMP_DIR<worktree>/.cross_review/)系の 2 系統を表で整理
全件 plausible 時の event が未定義APPROVE と定義。空ラウンドが max-rounds まで空回りする機序を記載
テスト計画に既存 pytest が無いcross-review/tests/ の実行を先頭に追加(test_state_merge_fix.py の更新が必須)
check-oscillation への影響が未言及重複率が下がり安全弁が発火しにくくなる点を注記
cross-review/SKILL.md が既に 475 行残り 25 行しかないため docs/ への退避を同じ PR に含める旨を影響範囲へ追加

Test plan

本 PR はプラン文書の追加のみでコード変更を含まないため、文書系チェックのみ実施する。

  • python3 scripts/check-markdown-links.py --root . が成功する(Markdown local links are valid
  • pre-commit hook の runtime plugin generated files are up to date が通る
  • プランの各タスクの対象ファイルが実在し、記載した行の内容と一致する
  • 「実測」節の数値(17 PR / 70 ラウンド / 平均 4.1)に異論がない

実装(Task 1〜5)は本 PR のスコープ外。

やらないこと

cross-review の往復が平均 4.1 ラウンドかかっている実測を起点に、指摘を投稿する
前に落とす仕組み(根拠の必須化・自己検証パス・却下済み論点の再提出抑止)と、
その効果測定までを 5 タスクに分解した実装プランを追加する。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AVdmSkGUg77ZfrWUh51vME
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@takemi-ohama