muse-agent-example/muse/lifecycle/quality/skills/judge/分析质量短板/SKILL.md

name, description, disable-model-invocation

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

质量归因建议

唯一目的

本 Skill 只做一件事：把 评估内容质量 或 judge 产出的结构化评分，翻译成可执行的归因建议——最低两维分别可能来自哪一层、下一轮该改哪个变量。

它不派 judge、不重生成候选、不跑收敛环、不 git 提交、不改 rubric。评分与 Gate 终态分别归 评估内容质量 与 判定质量是否合格。

输入

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

归因三层

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

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

每条建议必须写清：改什么、为什么对应最低维、改完如何复评（回到 评估内容质量）。

输出

一份归因报告，包含：

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

数据边界

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

红线

• 评分必须有引文证据；禁止为收敛压力让 judge 放水，rubric 与严格度不因本 Skill 改变。
• 同一 rubric 复评分差 >0.5 时，先查评委稳定性再查正文。
• 每轮只许建议改一个变量；禁止「同时改 prompt 和上下文」式混改。
• 禁止自称可直接 git 提交框架改动；设定层改动不得绕过 决定正文候选去留 / 确认知识草稿。
• 正文 A/B/C 回放口径归 评估内容质量 的 writer_replay profile，本 Skill 不重复定义。

复利合同

• 消费：上游 Canonical / 抽取状态 / 评测资产；本 Skill 只出归因建议，不改 rubric、不落库。
• 回写：不单独登记 example_lesson；效果信号归下游 评估内容质量 / 回放评估细纲质量 / 决定正文候选去留（本编排槽无落库位）。