091b66a9bb
将角色与 Skill 从 .claude 迁入 .agent，移除 Claude CLI 运行时并接入固定 Opus 角色 profile、完整 schema、预算 deadline、raw 与回执证据链。 同步拆分 Skill 职责、复利 lesson、Gate 回放、Dashboard 人审入口、数据库登记和机械门禁；候选设计正文不包含在本提交中。
57 lines
3.3 KiB
Markdown
57 lines
3.3 KiB
Markdown
---
|
||
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`（本编排槽无落库位）。
|