状态稳定
类型原子 Skill
领域软件测试
生命周期测试设计
适合角色QA / PM / DEV
语言中文 / 英文
评测有评测 ✓
同步日期2026-11-06
解决什么问题
它把当前 Skill 的方法整理成可以直接执行、评审和复用的质量输入。
- 这是静态 package review，不执行目标业务，不替用户修改 Skill。
- 不能用目录完整、skill-up validate、CLI install smoke 或 Project 状态声称 runtime 行为、模型效果、业务验收、Quality Score 或发布批准。
- 不凭空补充环境、依赖、指标、触发结果或执行事实；缺少证据时使用 UNASSESSED、NOT_RUN、BLOCKED 或 INSUFFICIENT_EVIDENCE。
- 把目录完整、CLI smoke 或 Project 状态当成 runtime 或模型证据。
适用场景
推荐使用
- 需要从 package 级别审查 Skill 的工程完整性，而不只是润色文案。
- 需要检查 SKILL.md、Prompt、metadata、示例、references 和 evals/ 是否形成一致契约。
- 需要判断 Skill 是否可独立复制/安装，以及哪些结论仍缺少 runtime 证据。
常见误区
- 把目录完整、CLI smoke 或 Project 状态当成 runtime 或模型证据。
- 只审查文案，遗漏 metadata、Eval、安装路径或双语不一致。
- 为了补齐包结构而增加跨 Skill 私有文件依赖。
输入
最低输入
- 确认 Skill、语言、目录和审查目标；没有文件时先列信息缺口。
推荐输入
- 产出前阅读 prompts/skill-quality-review.md，以它的输出契约为准。
- 需要判断行为时读取当前 Skill 的 evals/，但不要把配置验证写成 runtime 通过。
- 需要深层证据时读取仓库提供的 Evaluation Contract 和 local trace rules；若它们不在独立复制的目录中，保留证据限制，不建立硬依赖。
可选上下文
- 相关代码或配置
- 历史结果
- 日志与指标
输出
输出会围绕该 Skill 的方法形成可执行结果，并明确事实、假设、风险和下一步。
以下是 Skill 对预期产出的要求，不代表它已在真实项目中执行。
- 01范围、文档角色和输入缺口明确
- 02触发、输入、输出、约束、独立安装和 Eval readiness 已检查
- 03阻塞问题、建议、未评估项和证据等级可追溯
- 04没有把静态检查冒充 runtime/model 证据
工作原理
- 01确认 Skill、语言、目录和审查目标；没有文件时先列信息缺口。
- 02检查架构职责、范围/非目标、触发条件、输入审计、输出契约、progressive disclosure 和邻近能力边界。
- 03检查 SKILL.md、主 Prompt、agents/openai.yaml、示例/引用和 evals/ 的路径、名称和内容是否一致。
- 04检查独立安装：只复制当前 Skill 目录时，相对资源仍可解析，且不依赖另一个 Skill 的内部文件。
- 05按阻塞问题、重要建议、信息缺口、证据边界输出结果；把静态结论与 runtime/model 结论分开。
安装与快速开始
安装命令 / SHELL
npx skills add \
https://github.com/naodeng/awesome-qa-skills/tree/main/skills/zh/skill-engineering/skill-quality-review
-gskill-quality-review.prompt
@skill skill-quality-review
结合当前项目上下文，按该 Skill 的要求给出可执行结果。
补充上下文：
[粘贴项目背景或需求]---
name: skill-quality-review
description: Use this skill when reviewing a complete Skill package for architecture, scope, triggers, independent installation, bilingual consistency, Eval readiness, and evidence boundaries; triggers include Skill 质量审查、Skill package review、评测准备度。
license: PolyForm-Noncommercial-1.0.0
metadata:
version: "1.0.0"
compatibility: ""
author: "Awesome QA Skills contributors"
language: "zh-CN"
category: "skill-engineering"
source: "https://github.com/naodeng/awesome-qa-skills"
license-url: "https://polyformproject.org/licenses/noncommercial/1.0.0"
---
# Skill 质量审查
## 何时使用
- 需要从 package 级别审查 Skill 的工程完整性，而不只是润色文案。
- 需要检查 `SKILL.md`、Prompt、metadata、示例、references 和 `evals/` 是否形成一致契约。
- 需要判断 Skill 是否可独立复制/安装，以及哪些结论仍缺少 runtime 证据。
## 输出格式选项
- 默认使用 Markdown 审查报告，包含结论、阻塞问题、建议、信息缺口和证据边界。
- 需要比较多个文件或证据层时使用表格，但不要用分数替代判断依据。
## 如何使用
1. 确认 Skill、语言、目录和审查目标；没有文件时先列信息缺口。
2. 检查架构职责、范围/非目标、触发条件、输入审计、输出契约、progressive disclosure 和邻近能力边界。
3. 检查 `SKILL.md`、主 Prompt、`agents/openai.yaml`、示例/引用和 `evals/` 的路径、名称和内容是否一致。
4. 检查独立安装：只复制当前 Skill 目录时，相对资源仍可解析，且不依赖另一个 Skill 的内部文件。
5. 按阻塞问题、重要建议、信息缺口、证据边界输出结果；把静态结论与 runtime/model 结论分开。
## 核心约束
- 这是静态 package review，不执行目标业务，不替用户修改 Skill。
- 不能用目录完整、`skill-up validate`、CLI install smoke 或 Project 状态声称 runtime 行为、模型效果、业务验收、Quality Score 或发布批准。
- 不凭空补充环境、依赖、指标、触发结果或执行事实；缺少证据时使用 `UNASSESSED`、`NOT_RUN`、`BLOCKED` 或 `INSUFFICIENT_EVIDENCE`。
- 不新增第二套 Eval Engine、Judge、Benchmark 或 Quality Score。
## 参考文件
- 完整审查输出契约见 `prompts/skill-quality-review.md`。
- 将目标 Skill 的 `SKILL.md`、Prompt、metadata、references、examples 和 `evals/` 一起检查。
- 仓库契约只作为可选深资料；缺少 runtime 时保留限制，不凭空补证据。
## 常见误区
- 把目录完整、CLI smoke 或 Project 状态当成 runtime 或模型证据。
- 只审查文案，遗漏 metadata、Eval、安装路径或双语不一致。
- 为了补齐包结构而增加跨 Skill 私有文件依赖。
## 最佳实践
- 先确认范围和信息缺口，再把每个结论追溯到文件和证据等级。
- 分开记录阻塞缺陷、建议和未评估项。
- 保持审查范围在 package 层，并确保结论不依赖本机绝对路径。
## 按需加载
- 产出前阅读 `prompts/skill-quality-review.md`，以它的输出契约为准。
- 需要判断行为时读取当前 Skill 的 `evals/`，但不要把配置验证写成 runtime 通过。
- 需要深层证据时读取仓库提供的 Evaluation Contract 和 local trace rules；若它们不在独立复制的目录中，保留证据限制，不建立硬依赖。
## 交付前自检
- [ ] 范围、文档角色和输入缺口明确
- [ ] 触发、输入、输出、约束、独立安装和 Eval readiness 已检查
- [ ] 阻塞问题、建议、未评估项和证据等级可追溯
- [ ] 没有把静态检查冒充 runtime/model 证据
## 选择审查范围
完整包契约与安装就绪审查使用本 Skill，包括文件、metadata、资源、示例和 eval。仅审阅一段文字、Prompt 或文档契约时使用 skill-prose-review；文本审查不能证明包完整。