The Doc Draft Ledger: Price Verification Before You Send a Section to the Model

说明与用途

通过 YAML 账本，团队在 AI 生成前估算每个文档段落的审核时间，限制审核预算并加速审核流程。

问题

Documentation teams waste hours validating AI‑generated content that contains many high‑stakes claims, code, and external links.

结果

By pricing review effort upfront, teams keep AI drafting within a manageable budget, cutting review time from hours to minutes for low‑risk sections while focusing human attention on high‑stakes content.

工作流

• 1. Create a ledger.yaml with budget and section metadata (id, path, class, words, claim_density, code_blocks, external_links).
• 2. Run ledger_check.py to calculate estimated review minutes for each section.
• 3. Integrate the script into the CI pipeline; fail the merge if total estimated minutes exceed the weekly budget.
• 4. Use the cost estimates to decide which sections the model drafts, which are outlined, and which stay fully human‑written.
• 5. Review only the sections flagged as high‑cost, reducing overall review time.

证据

The ledger turns each section into an estimated review cost using weights, not magic.

来源

A two‑thousand‑word section may take the model twenty seconds to produce and a reviewer ninety minutes to validate.

来源