CheatSheetSeries PR #2265 — AIコントリビューターガイドライン(AGENTS.md)とメンテナーPRレビューツールの追加
CheatSheetSeries PR #2265 — AIコントリビューターガイドライン(AGENTS.md)とメンテナーPRレビューツールの追加
概要
OWASP CheatSheetSeriesリポジトリにおいて、mackowskiによるPR #2265がオープンされた。メンテナー間で議論されていたAI生成PR(slop/AI-PR)のバックログに対処するため、以下の2つの仕組みを導入する:
1. AIコントリビューターガードレール — AGENTS.md
- Claude Code、Codex、Cursor、Copilot等、すべてのAIツール向けの単一情報源として
AGENTS.mdを作成 CLAUDE.mdからAGENTS.mdをインポートし、Claude Codeが自動的に読み込むCONTRIBUTING.md+GUIDELINE.mdの内容をAI貢献が最も破りやすいハードゲートに集約- AI支援PRがデフォルトでルールに従うように設計
2. メンテナーレビューワークフロー — /review-cheatsheet-pr コマンド
- Claude Codeのスラッシュコマンドとして実装
- 5人の専門レビュアー(セキュリティ、開発者実用性、リンク/ソース品質、重複・配置、言語)を並列にファンアウト
- MERGE / REQUEST_CHANGES / CLOSE の単一評定をエビデンス付きで統合
変更対象ファイル
| ファイル | 追加/削除 | 内容 |
|---|---|---|
AGENTS.md |
+101 | AIコントリビューター向けガードレール |
CLAUDE.md |
+9 | AGENTS.mdのインポート |
.claude/agents/cheatsheet-security-reviewer.md |
+45 | セキュリティレビュアーエージェント |
.claude/agents/cheatsheet-practicality-reviewer.md |
+44 | 実用性レビュアーエージェント |
.claude/agents/cheatsheet-link-auditor.md |
+47 | リンク監査エージェント |
.claude/agents/cheatsheet-duplication-checker.md |
+45 | 重複チェックエージェント |
.claude/agents/cheatsheet-language-reviewer.md |
+47 | 言語レビュアーエージェント |
.claude/commands/review-cheatsheet-pr.md |
+106 | レビューコマンド定義 |
.gitignore |
+6/-2 | 更新 |
.markdownlintignore |
+4 | 追加 |
セキュリティ的意義
- AI生成コンテンツの品質管理をプロジェクトレベルで標準化
- 虚偽の引用・技術的誤情報がチートシートに混入するリスクを低減
- 自動レビューワークフローにより、人的レビュー負荷を削減しつつ品質を維持
PR本文(抜粋)
Introduces two things to help with the slop/AI-PR backlog discussed among maintainers:
- AI contributor guardrails —
AGENTS.mdas the single source of truth for every AI tool used in this repo- Maintainer review workflow —
/review-cheatsheet-pr <PR#>that fans out five specialized reviewers in parallel
評価
- ステータス: オープン(未マージ)
- セキュリティ影響度: 中 — プロセス改善だが、コンテンツ品質と信頼性に間接的に影響
- 優先度: 中