Sign the Sentences, Not the PR: An Approval Ledger for Model-Drafted Doc Blocks

说明与用途

该工作流通过哈希将模型生成的句子与人工签名绑定，任何更改都会使签名失效，需重新批准。

问题

PR approvals can outlive the text they approve, allowing model‑rewritten sentences to remain unreviewed.

结果

The workflow ensures that any change to a model‑drafted sentence requires a fresh human signature, preventing stale approvals.

工作流

• Mark ownership boundaries with HTML comments in the source file.
• Draft the file with a model under a restricted instruction that only rewrites model‑owned blocks.
• Run a pre‑commit/CI checker that hashes each model‑drafted block and compares it to a JSON ledger of approved hashes.
• If a hash differs, the checker fails, prompting a new human approval for the changed block.

证据

Most documentation reviews approve a pull request, not a sentence.

来源

The artifact is a ~90-line Python checker that runs in pre-commit and CI.

来源

Wrap each unit you want to attribute in an HTML comment pair, and keep the body plain Markdown so the page still renders anywhere.

来源