Who Owns This Heading? A Contract for AI-Drafted Docs

说明与用途

使用 YAML 归属合同为每个文档标题分配明确的所有者，并使用门控脚本在合并前检查人类拥有的章节是否已签名。这样可确保关键章节由人工审核，AI 生成的内容不会导致操作错误。

问题

AI-generated documentation can contain critical operational or policy information that, if incorrect, leads to failures. Existing file-level ownership is too coarse, allowing human‑owned sections to be drafted by models without verification.

结果

The workflow enforces clear ownership of documentation sections, preventing AI‑generated errors in critical operational content and ensuring human review before merge.

工作流

• 1. Define a doc_ownership.yaml with rules mapping heading patterns to owners and reasons.
• 2. Generate documentation with an AI model, marking model_draft sections.
• 3. Add DOC‑OWN signatures to human_own headings by a reviewer.
• 4. Run ownership_gate.py to fail the build if any human_own heading lacks a valid signature.
• 5. Merge only after all gates pass, ensuring correct ownership and verification.

证据

That failure was not a grammar problem. It was an ownership problem.

来源

Unsigned, or signed with owner=model_draft on a human_own rule, is a gate failure.

来源