Ship an OSS Patch With a Reviewer Question Bank, Not Just a Diff

说明与用途

引入 REVIEWER_QUESTIONS.md 文件通过提供具体问题和证据，帮助快速完成 PR 审核。

问题

Maintainers stall on pull requests with minimal diffs and no reproduction or evidence, leading to delayed reviews and contributor frustration.

结果

Reviewers can quickly assess reproduction, public surface changes, negative paths, regression tests, commit shape, and documentation needs, reducing review time and improving contributor experience.

工作流

• Freeze the failing command and record it in the question bank
• Ensure every hunk is load‑bearing and avoid unrelated refactors
• Collect exit codes for the failing command, unit tests, and negative paths
• Draft the question bank using a coding model or manually
• Add the REVIEWER_QUESTIONS.md alongside the patch branch
• Submit the PR with the question bank for review

证据

The proposed artifact is a single Markdown file named REVIEWER_QUESTIONS.md that lives beside the patch branch.

来源

Unanswered items remain marked TODO so a local gate can refuse to open the pull request.

来源