Skip to content

レビュー系 skill 全体に敵対的検証を追加 - #100

Merged
version-1 merged 4 commits into
mainfrom
docs/add-adversarial-review-guidance
Jul 20, 2026
Merged

レビュー系 skill 全体に敵対的検証を追加#100
version-1 merged 4 commits into
mainfrom
docs/add-adversarial-review-guidance

Conversation

@version-1

@version-1 version-1 commented Jul 20, 2026

Copy link
Copy Markdown
Owner

レビュー系 skill の基本姿勢に敵対的検証を追加

Summary

レビューを主用途にする internal skill 全体に、実装者の前提や正常系中心の説明を鵜呑みにせず、見落とされた失敗条件が残っている前提で敵対的検証を行う姿勢を追加しました。

主な変更点:

  • role-reviewer の description と基本姿勢に、敵対的検証を行うことを明示
  • code-review基本姿勢 セクションを追加し、レビューの前提として敵対的検証を行うことを明記
  • code-next-developer-review に、後続開発で前提が崩れる状況を敵対的検証する姿勢を追加
  • code-quality-review に、将来の変更・テスト・運用で品質問題が表面化する条件を敵対的検証する姿勢を追加
  • 各 review skill の evals、該当する agents/openai.yamldocs/skill-library.md の説明を同期

やったこと

  • codex/skills/internal/role-reviewer/SKILL.md の基本姿勢へ、実装者の説明やテスト結果を鵜呑みにせず敵対的検証を行う前提を追加
  • codex/skills/internal/code-review/SKILL.md に基本姿勢を追加し、レビュー手順から独立した敵対的検証ステップを削除
  • codex/skills/internal/code-next-developer-review/SKILL.md に、次の開発者が詰まる条件を敵対的検証する前提を追加
  • codex/skills/internal/code-quality-review/SKILL.md に、品質問題が表面化する条件を敵対的検証する基本姿勢を追加
  • code-next-developer-review / code-quality-reviewagents/openai.yaml を skill 本体に合わせて更新
  • review 系 skill の evals.json に敵対的検証を行う発火ケースを追加
  • skill 一覧の概要文を更新

動作確認

  • jq . codex/skills/internal/role-reviewer/evals/evals.json
  • jq . codex/skills/internal/code-review/evals/evals.json
  • jq . codex/skills/internal/code-next-developer-review/evals/evals.json
  • jq . codex/skills/internal/code-quality-review/evals/evals.json
  • Ruby YAML パーサによる SKILL.md frontmatter 基本検証
  • Ruby YAML パーサによる agents/openai.yaml 基本検証
  • git diff --check
  • git diff --staged --check

レビュー & 動作確認 チェックリスト

  • 対象範囲 - レビュー主用途の role-reviewer / code-review / code-next-developer-review / code-quality-review に反映されているか
  • 基本姿勢としての配置 - 敵対的検証が独立観点ではなく、レビュー前提として読めるか
  • 明示文言 - 敵対的検証を行う という表現が各 review skill に明確に入っているか
  • 既存方針との整合 - skill 本体、eval、UI metadata、skill-library の説明に矛盾がないか

推奨テスト計画:

  1. 各 review skill の description と基本姿勢を読み、独立観点ではなくレビュー前提として敵対的検証を行うことが伝わるか確認する
  2. 追加した evals.json の prompt / expected_output が、敵対的検証を行うレビュー姿勢を期待しているか確認する
  3. agents/openai.yamldocs/skill-library.md の説明が skill 本体の変更内容と一致しているか確認する

その他気になることや相談ごと

quick_validate.py はスクリプトに実行権限がなく、Python 経由では PyYAML が未インストールだったため実行できませんでした。代替として JSON 構文確認と Ruby 標準 YAML パーサによる frontmatter / openai.yaml 基本検証を実施しています。

role-reviewer と code-review の説明、レビュー手順、観点リファレンスに敵対的検証を追加した。

あわせて evals に発火ケースを追加し、skill-library の説明を同期した。

検証: jq で evals.json を確認、Ruby YAML パーサで SKILL.md frontmatter を確認、git diff --staged --check を実行。
敵対的検証を独立した観点やレビュー手順として追加する形から、role-reviewer と code-review の基本姿勢へ移した。

あわせて points の独立観点を削除し、evals と skill-library の表現を同期した。

検証: jq で evals.json を確認、Ruby YAML パーサで SKILL.md frontmatter を確認、git diff --check / --staged --check を実行。
@version-1 version-1 changed the title レビュー系 skill に敵対的検証観点を追加 レビュー系 skill の基本姿勢に前提確認を追加 Jul 20, 2026
role-reviewer と code-review の description、基本姿勢、eval、skill-library に「敵対的検証を行う」という表現を追加した。

独立観点には戻さず、基本姿勢として明示している。

検証: jq で evals.json を確認、Ruby YAML パーサで SKILL.md frontmatter を確認、git diff --check / --staged --check を実行。
@version-1 version-1 changed the title レビュー系 skill の基本姿勢に前提確認を追加 レビュー系 skill の基本姿勢に敵対的検証を追加 Jul 20, 2026
code-next-developer-review と code-quality-review にも、実装者の前提を鵜呑みにせず敵対的検証を行う基本姿勢を追加した。

あわせて evals、agents/openai.yaml、skill-library の説明を同期した。

検証: jq で evals.json を確認、Ruby YAML パーサで SKILL.md と openai.yaml を確認、git diff --check / --staged --check を実行。
@version-1 version-1 changed the title レビュー系 skill の基本姿勢に敵対的検証を追加 レビュー系 skill 全体に敵対的検証を追加 Jul 20, 2026
@version-1
version-1 merged commit bad1413 into main Jul 20, 2026
1 check passed
Sign up for free to 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