feat: 課題発見用 issue-finder agent を追加

[version-1]

課題発見用 issue-finder agent の追加

Summary

コードベースを変更せず、根拠に基づいて不具合・保守性・機能提案・脆弱性・ドキュメントの課題を発見する issue-finder agent を追加します。

主な変更点:

• Codex / Claude 共通の issue-finder agent 定義を追加
• 5種類の finder role と分野別 playbook、共通 issue-finder-playbook を追加
• 一時ディレクトリへの課題単位 Markdown 出力、安全境界、根拠・優先度 contract を定義
• Codex の読み取り専用 workspace / 一時領域書き込み permission profile を追加
• skill metadata、eval、skill library、dependency map を更新

やったこと

• role-bug-finder、role-maintenance-finder、role-feature-finder、role-vulnerability-finder、role-documentation-finder を追加
• 共通 agent が共通 playbook と対応する分野別 playbook を組み合わせる routing を実装
• 課題ごとの Markdown、no-findings、investigation-needed、duplicates、additional-candidates の出力 contract を定義
• 変更方針が一意に明確な課題へ $modification-design を含める条件を定義
• 出力先の canonical path、symlink、ファイル名正規化を含む境界検証を追加

動作確認

• deploy 実装の Go test
• skill frontmatter / UI metadata / eval JSON の構文検証
• agent TOML と permission profile の確認
• external skill を含む make deploy-dry-run
• git diff --check

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

• 責務分離 - role skill、共通 agent、共通 playbook、分野別 playbook の責務が重複していないか
• 安全境界 - repository を変更せず、一時ディレクトリだけへレポートを出力する contract が十分か
• Finder routing - 5種類の finder が目的に応じて正しく選択されるか
• 出力品質 - 根拠、重要度、確信度、重複確認、解決方針が後続 Issue の入力として十分か

推奨テスト計画:

1. 各 role-*-finder の正例・負例 eval を確認する
2. /tmp/issue-finder/ を出力先として小規模な repository 調査を実行する
3. 調査前後で repository の diff が増えていないことを確認する

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

CI で検出された external skill grape-usage の tree hash 不一致は、upstream の現在値へ固定 hash を更新して解消しました。

Claude agent の filesystem 権限は Codex permission profile と同等には分離できないため、コード変更禁止と出力先制約を developer instruction / playbook で強制しています。

Diagram

graph LR
    B["role-bug-finder"] --> I["issue-finder agent"]
    M["role-maintenance-finder"] --> I
    F["role-feature-finder"] --> I
    V["role-vulnerability-finder"] --> I
    D["role-documentation-finder"] --> I
    I --> C["issue-finder-playbook"]
    I --> P["対応する finder playbook"]
    C --> O["課題 Markdown"]
    P --> O

Loading