---
name: optimize-content-quality
description: 根据 score-content-quality 的独立评分，锁定最低质量维度并归因到 prompt、上下文或设定层，只出单变量改进建议。候选稳定不达标且需要定位改进来源时使用；不执行重生成、不改 rubric、不自行提交代码。
---

# 质量归因建议

## 唯一目的

本 Skill 只做一件事：把 [`score-content-quality`](../score-content-quality/SKILL.md) 或 judge 产出的结构化评分，翻译成**可执行的归因建议**——最低两维分别可能来自哪一层、下一轮该改哪个变量。

它不派 judge、不重生成候选、不跑收敛环、不 git 提交、不改 rubric。评分与 Gate 终态分别归 `score-content-quality` 与 `adjudicate-quality-gate`。

## 输入

- 结构化评分报告：逐维分数、引文证据、最低维标识、候选 id / 章节定位。
- 可选上下文：本轮 writer prompt 摘要、assemble-context 投影清单、相关设定卡 id。

## 归因三层

取最低两维，各给出**单一**归因层（不得混改多个变量）：

| 层 | 典型信号 | 建议落点 |
|---|---|---|
| prompt 层 | 写手指令缺约束、语气合同冲突、场景任务不清 | `.agent/agents/writer.md` 或本轮功能 Skill |
| 上下文层 | 该给的卡/细纲/状态没给、给多了泄漏、投影字段错 | `assemble-context` 选取规则或 schema aiContext |
| 设定层 | 卡字段空洞、关系/能力边界未写清、披露节奏矛盾 | 知识卡或规划项（改动走用户确认与 `confirm-knowledge-draft` / `decide-candidate`） |

每条建议必须写清：改什么、为什么对应最低维、改完如何复评（回到 `score-content-quality`）。

## 输出

一份归因报告，包含：

1. 最低两维及引文证据摘要（不复制大段正文）。
2. 每层一条、最多两条的单变量建议；若无法归因，明确写 `insufficient_evidence` 与缺什么信息。
3. 明确声明**本 Skill 不执行**的建议项（重生成、设定落库、框架 git 提交须由主会话或对应 Skill 承接）。

## 数据边界

- 只读：评分报告、可选的 prompt/上下文/设定摘要。
- 不写库、不改正文、不调用模型网关、不提交 Git。
- 实验性「评→诊→改→产→止」五轮收敛环的历史 runbook 见 [`docs/2026-08-20-质量收敛环运行手册.md`](../../../docs/2026-08-20-质量收敛环运行手册.md)；该环不是本 Skill 的合同，主会话若仍要跑须单独授权。

## 红线

- 评分必须有引文证据；禁止为收敛压力让 judge 放水，rubric 与严格度不因本 Skill 改变。
- 同一 rubric 复评分差 >0.5 时，先查评委稳定性再查正文。
- 每轮只许建议改**一个**变量；禁止「同时改 prompt 和上下文」式混改。
- 禁止自称可直接 git 提交框架改动；设定层改动不得绕过 `decide-candidate` / `confirm-knowledge-draft`。
- 正文 A/B/C 回放口径归 `score-content-quality` 的 `writer_replay` profile，本 Skill 不重复定义。

## 复利合同

- **消费**：上游 Canonical / 抽取状态 / 评测资产；本 Skill 只出归因建议，不改 rubric、不落库。
- **回写**：不单独登记 `example_lesson`；效果信号归下游 `score-content-quality` / `evaluate-frozen-replay` / `decide-candidate`（本编排槽无落库位）。