skill-quality-gate

name	skill-quality-gate
description	Quality gate validation for report chapters. Validates minimum section count, evidence coverage per section, word count requirements, and data annotation compliance.

Chapter Quality Gate

Purpose

Validate that each chapter meets minimum quality standards before it is considered complete. Acts as a final checkpoint to prevent incomplete or poorly-sourced content from reaching the report.

系统将在保存环节自动校验以下规则，无需手动自检。 各章节的具体量化标准（小节数、引用条数、字数区间、数字来源）统一在 skill.schema.yaml 中维护，由 OutputValidator 在保存时机器执行。

Validation Rules (System-Enforced)

1. Section Count

• 对比实际产出小节数与 skill.schema.yaml 中定义的小节列表
• 缺小节 → 保存拦截，返回缺失清单

2. Evidence Coverage

• 每个小节至少 1 条引用（ref_density_min 按章节配置）
• 零引用小节 → 标记为 insufficient_evidence

3. Word Count

• 逐小节校验 word_range，低于下限 → 拦截，高于上限 → 非阻塞警告

4. Data Annotation

• 数字声明必须有可追溯来源
• 泛来源（如「公开资料」）→ 标记为 unverifiable

Gate Results

Status	Meaning
pass	All checks passed
blocked	Critical failure — chapter cannot proceed
warning	Non-critical issues — chapter proceeds with notes

Anti-Patterns

• Do NOT pass a section with fabricated data marked as cited
• Do NOT skip word-count validation — short sections are often incomplete
• Do NOT treat a warning as pass — warnings should be reviewed

---

Agent Self-Check Rules

Agent 保存章节前必须自检以下项（与 OutputValidator 系统校验互补）：

1. 跨章数据一致性

• ch2 盈利预测数据（营收增速、毛利率）与 ch4 行业分析中的行业增速不可矛盾
• ch2 估值参数（WACC、永续增长率）与 ch3 估值模型中使用的参数必须一致
• ch5 公司分析中的财务数据与 ch2 盈利预测引用的历史数据保持一致
• 不一致时：以招股书原文为准，修正引用

2. 全文重复度检测

• 同一条事实性信息在全文中出现不超过 2 次
• 同一段落的实质内容不可在另一章节中以相同措辞复现
• 跨章节可引用（如 ch1 引用 ch4 结论），但必须标注"详见第 X 章"

3. 数字精度一致性

• 百分比保留 2 位小数（如 12.34%）
• 金额单位统一：万元或亿元，同一章节不可混用
• 增长率/复合增速保留 1 位小数（如 15.3%）
• 小数精度不一致 → 修正后保存

---

Output Style Standard

专业话术规范

• 避免模糊词："可能""大概""好像""似乎""据传"
• 使用确定性表述："数据显示""招股书披露""根据 XX 报告"
• 不确定信息必须标注来源和置信度："根据行业惯例推测（未经官方确认）"

图表引用位置

• 图 x 在段落中首次提及后即紧跟图片展示（不在章节末尾集中放图）
• 每张图必须有编号和图题（如"图 4-3：2023-2028 年中国生物医药市场规模"）

引用标注格式

• 招股书引用：（招股书 Pxx）
• 网页引用：[来源：网站名称，YYYY-MM-DD]
• 行业报告：[来源：报告名称，发布机构，YYYY-MM]
• 不可用"公开资料""市场调研"等泛来源标注