skill-quality-review · git:20260920.222a120 · 2026-09-20 · sha256 0cc576f5cdd8f485
skill-quality-review git:20260920.222a120A
Immutable. This exact content never changes and is served at /api/v1/blob/0cc576f5cdd8f485.
--- name: skill-quality-review description: 在需要审查完整 Skill 包的架构、范围、触发、独立安装、双语一致性、Eval 准备度和证据边界时使用;触发词包括 Skill 质量审查、Skill package review、评测准备度。 --- # Skill 质量审查 ## 何时使用 - 需要从 package 级别审查 Skill 的工程完整性,而不只是润色文案。 - 需要检查 `SKILL.md`、Prompt、metadata、示例、references 和 `evals/` 是否形成一致契约。 - 需要判断 Skill 是否可独立复制/安装,以及哪些结论仍缺少 runtime 证据。 ## 执行流程 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 的 `evals/`,但不要把配置验证写成 runtime 通过。 - 需要深层证据时读取仓库提供的 Evaluation Contract 和 local trace rules;若它们不在独立复制的目录中,保留证据限制,不建立硬依赖。 ## 交付前自检 - [ ] 范围、文档角色和输入缺口明确 - [ ] 触发、输入、输出、约束、独立安装和 Eval readiness 已检查 - [ ] 阻塞问题、建议、未评估项和证据等级可追溯 - [ ] 没有把静态检查冒充 runtime/model 证据