Stamp Changelog Claims as Extract, Draft, or Sign Before Publishing Notes

说明与用途

在此工作流中，每个 changelog 条目都标注权威级别（EXTRACT、DRAFT、SIGN），确保只有人类才声明承诺，模型仅重述提取的数据。

问题

Generated release notes often mix extracted symbol lists, model‑drafted summaries, and human‑written compatibility claims, leading to unverified authority and potential miscommunication of breakage or migration steps.

结果

The workflow enforces provenance for every changelog entry, preventing models from inserting unverified compatibility claims and ensuring human ownership of promises.

工作流

• 1. Run a script to extract public symbols from two git tags and output a JSON diff.
• 2. Store the diff as evidence (e.g., build/symbol_diff.json).
• 3. Create a stamped changelog map (docs/changelog/vX.Y.Z.yaml) listing rows with authority, evidence, and empty bodies for SIGN rows.
• 4. Allow a model to draft narrative summaries (DRAFT rows) based on extracted data.
• 5. Human reviewers fill SIGN rows with compatibility class, migration steps, rollback policy, and deprecation timeline.
• 6. Run a checker that blocks publishing if any SIGN row is non‑empty or contains model‑generated content.
• 7. Once all SIGN rows are approved, publish the tag and the final CHANGELOG.md derived from the stamped map.

证据

Generated release notes fail when a model is allowed to classify breakage or promise an upgrade path.

来源

A model that fills a SIGN row is not accelerating documentation but forging a signature the repository cannot prove.

来源