Give Every Heading a Restate or Commit Lane Before Generation

说明与用途

在 CI 中实现语音动作过滤器，将 AI 生成文档中的事实性描述与承诺分离，提高可靠性并降低法律风险。

问题

Documentation generated by AI often mixes factual restatements with vendor commitments, leading to unverified promises and legal risk.

结果

The workflow reduces manual review effort, prevents accidental promises in AI‑generated docs, and maintains legal compliance by keeping commitments human‑owned.

工作流

• Define five speech‑act labels (DESCRIBE, EXAMPLE, PRESCRIBE, PROMISE, WARN).
• Create a heading‑permission YAML map that assigns each heading to a lane (restate or commit).
• Run the speech‑act filter script on model drafts before merge; non‑zero exit blocks the PR.
• Reviewers focus on commitment headings while the restatement headings are auto‑generated.
• Iterate on the permission map and forbidden verb list based on gate failures.

证据

Models are statistically good at turning a schema into a parameter table or an example body. They are not a source of authority for promises that customers will quote during an incident.

来源