Quality Gate

Quality Gate — 质量闸门

一次一件事，达标才停。不达标→循环修复。无 skill_view 记录=门不通过。

执行步骤（固定流程）

契约层 · IO_CONTRACT

输入：请求描述、上下文信息。 输出：执行结果、状态反馈。

原则 (Principles)

凡检必跑，不假手记。 质量一律以 runner 实测为准，state.json 自报与旧报告皆不可信。 一阀定存亡。 L0.5 数据诚实门与 G4 宪法合规为一票否决——余门全过，此门失则整体不通过。 不达标不退出。 修复循环按 P0→P1→P2 逐档执行，连续三次未过方请人工介入，门不松、标准不让。

Step 1: 确定论文目录

输入：论文目录路径（含 paper.tex）。

• 从 outputs/papers/ 目录查找
• 从用户输入提取
• 从 pipeline_trace.json 获取

Step 2: 运行质量检查引擎

cd /media/yakeworld/sda2/Synthos/skills/core/quality-gate/scripts/

# 完整模式（G1-G7 + L0.5）
python3 quality-gate-runner.py \
    --paper-dir "{paper_dir}" \
    --output "{output_dir}/quality_report.json" \
    --mode full

# 快速模式（仅 G1+G2+L0.5，预检）
python3 quality-gate-runner.py \
    --paper-dir "{paper_dir}" \
    --output "{output_dir}/quality_report_fast.json" \
    --mode fast

Step 3: 解析报告

从 quality_report.json 读取：

• overall_score — 总体评分
• overall_pass — 是否通过（≥0.85）
• gates — 每门详细结果
• issues — 问题清单

判定：

• overall_score ≥ 0.85 且 overall_pass = true → 通过
• L0.5_data_honesty score < 0.5 → 一票否决，必须修复
• 任何 P0 问题（G4_constitution, L0.5）→ 必须修复

Step 4: 生成报告

按固定模板生成报告，使用 references/comprehensive-quality-report-template.md：

# 将 quality_report.json 加载，按模板输出 Markdown 报告
# 模板：报告一（通用六域）+ 报告二（类型专项）+ 报告三（引用审查）+ 报告四（检查员报告）

如果 quality-gate-runner.py 输出 JSON 符合模板结构，直接转换输出。

Step 5: 修复循环（如未通过）

1. 按 severity 排序 issues（P0 → P1 → P2）
2. 对每个问题，参考 references/quality-gate-fix-recipes.md 获取修复方案
3. 执行修复（patch paper.tex / 清理 bib / 重编译）
4. 重编译验证：

   cd {paper_dir}
   pdflatex paper.tex 2>&1 | grep -c "Error"  # = 0
   pdflatex paper.tex 2>&1 | grep -c "Overfull"  # = 0
   

5. 重新运行 Step 2-4
6. 连续 3 次未通过 → 报告"需要人工介入"

Step 6: 输出交付

将最终报告保存为 {paper_dir}/quality-report.md，更新 {paper_dir}/state.json 的 quality_score 字段。

Gene 验证 (G8 门) — v5.1 核心门

验基因，不验长文。 Gene 是独立进化单位 (宪法 P7)，验证 Gene 即验证策略。 存储: SKILL.md 内 ## Genes 小节 (紧凑层，优先加载)

• G8a: Genes 小节存在性 — 每技能 SKILL.md 必须有 ## Genes 小节 (目标: 157/157 = 100%)
• G8b: Gene 一致性 — Genes 策略与 SKILL.md 完整文档不矛盾
• G8c: Gene 可进化性 — 每条 Gene 可独立变异 + 独立验证 (P1 可复现性)
• G8d: Gene 数量 — 每技能 4-8 条 (太少=覆盖不足，太多=失去压缩)
• G8e: 表观遗传激活 — pipeline_trace 记录 gene_activation (activated/suppressed)

G8 是核心门 (v5.1)，权重 0.10。G8 不通过 → 整体不通过 (一票否决)。 连续 2 轮 G8 不通过 → 触发 OPTIMIZE 维度的 Gene 修复任务。

Genes (策略基因)

紧凑策略表示。条件→策略。需要深度时参考上方完整文档。

• [QG-001] 质量检查 → 四层: L0动灵→L0.5数据诚实→G1-G7管线→L4内容。固定流程零自由发挥
• [QG-002] 一票否决 → L0.5 数据诚实 + G4 宪法合规 = 一票否决。余门全过此门失→整体不通过
• [QG-003] 修复循环 → 不达标→P0→P1→P2 逐档修复。连续三次未过→人工介入。门不松标准不让
• [QG-004] 实测为准 → 凡检必跑，不假手记。state.json 自报不可信。runner 实测是唯一真理
• [QG-005] 通过标准 → overall≥0.85 且 0 undefined citation 且 D8≥80% 且 D10a≥90%

闸门清单

通过条件：所有门 score ≥ 阈值 且 无 P0 问题

输入契约

输出契约

{
  "paper_dir": "/path/to/paper",
  "paper_name": "paper-name",
  "overall_pass": true,
  "overall_score": 0.92,
  "gates": {
    "G1_identity": {"gate": "G1_identity", "pass": true, "score": 1.0},
    "L0.5_data_honesty": {"gate": "L0.5_data_honesty", "pass": true, "score": 0.8}
  },
  "issues": [
    {
      "gate": "G3_citation_integrity",
      "severity": "P1",
      "findings": ["3 orphan citations"],
      "suggestions": ["Add missing bib entries"]
    }
  ]
}

脚本清单

固定报告模板

• references/comprehensive-quality-report-template.md — 报告结构模板（四份报告）
• references/quality-gate-fix-recipes.md — 每个常见问题的修复方案
• references/codex-g7-quality-workflow.md — G7 详细工作流
• references/stale-quality-report-trap.md — 旧报告过期陷阱

陷阱

• runner 期望 --paper-dir 指向 01-manuscript/（tex 所在目录）（2026-08-21 实测）：G2/G3 用 os.listdir 不递归，传论文根目录会报 "No .tex files found"。state.json 自动从上一级读取。
• quality-gate-runner.py 假阳性 G3（2026-08-21 已修复）：旧正则 \\cite[pcp]*{?([^},\s]+)}? 会把 key 首字符当 citep/citet 后缀剥除（patel2024anterior → atel2024anterior，10 个正常引用被误报 unused）。已改为 \\cite[a-zA-Z]*\{([^}]*)\} 循环提取。若旧脚本仍误报 "atel2024anterior" 类 key，先更新脚本再跑。
• 旧报告不可信：state.json 中的 quality_score 可能过期 → 必须重新运行 runner
• L0.5 一票否决：即使其他门全过，L0.5 失败 → 整体不通过
• state.json 自报 vs 独立审计不一致：以 runner 输出为准
• Ensemble 混用：paper 声称的 ensemble 成员与实际 JSON 不一致 → P0

验证清单

• 运行了 quality-gate-runner.py
• 报告 JSON 解析成功
• 所有门 score ≥ 阈值
• L0.5 score ≥ 0.5
• 无 P0 未修复问题
• 报告保存为 quality-report.md
• state.json 已更新

示例 · EXAMPLES

输入：paper_dir: "outputs/papers/pima-crispdm", mode: "full" 输出：overall_score=0.92, overall_pass=true；G3 orphan citations=0, L0.5 score=0.8；quality-report.md 按固定模板生成并更新 state.json

输入：paper_dir: "outputs/papers/bppv-nystagmus", mode: "fast"（预检） 输出：overall_score=0.71, overall_pass=false；G4 发现 1 处硬编码 API key（P0）→ 修复循环触发 → 重跑后 overall_score=0.87 通过

约束规则 · RULES

• 全部检查走 quality-gate-runner.py，不执行自行编写的检查逻辑
• L0.5 数据诚实门与 G4 宪法合规为一票否决：此门失则整体不通过
• 不达标不退出：按 P0→P1→P2 逐档修复，连续 3 次未过方请人工介入
• state.json 自报值不可信，一律以 runner 实测输出为准
• 报告必须按 references/comprehensive-quality-report-template.md 固定模板生成

边界声明

• 不保证论文质量高（只保证检查流程完整）
• 不执行自行编写的质量检查逻辑（全部走脚本）
• 报告生成后必须执行修复循环，不达标不退出

Golden 集合 · GOLDEN SET

• Golden Input: paper_dir: "outputs/papers/pima-crispdm"（含 paper.tex），mode: "full"
• Golden Output: overall_score ≥ 0.85 且 overall_pass=true，G1-G7 与 L0.5 全过（L0.5 score ≥ 0.5），quality-report.md 按固定模板生成并更新 state.json
• Golden Error: 任一 P0 问题（G4_constitution 或 L0.5 score < 0.5）未修复 → runner 退出码 1，overall_pass=false，一票否决，进入修复循环

Golden

• Golden Input: {paper_dir: "outputs/papers/pima-crispdm"}
• Golden Output: overall_score ≥ 0.85, all gates pass, quality-report.md generated
• Golden Error: exit code 1 when any P0 issue remains unrepaired