Keep OSS Reviews Inside a Four-File Packet

说明与用途

四文件包将每条评审评论绑定到冻结的 SHA、允许的路径、最小失败测试和差异，支持受限模型评审，防止评审漂移。

问题

Free‑model reviews drift when they read an entire repository tree, causing maintainers to chase defects that git never recorded.

结果

The packet ensures that every review comment is tied to a specific SHA, path, diff hunk, and failing command, preventing drift and enabling reproducible, bounded model reviews.

工作流

• Freeze the SHA on a clean tree and write BOUND.txt
• Capture the failing command in FAIL.txt
• Write the smallest failing test and run it at the frozen SHA
• Fill BOUND.txt with allowed and forbidden paths
• Stage only allowed paths and emit PATCH.diff
• Run a local test matrix and append results to FAIL.txt
• Create PROMPT.txt to instruct a free model to read only the packet
• Run packet_check.py to validate completeness

证据

Free-model reviews drift when they read an entire tree. Maintainers then chase defects that git never recorded.

来源

The patch does not start as a chat thread. The contributor freezes SHA, paths, diff, and test output together.

来源

The contributor writes a single PROMPT.txt file.

来源