name: pr-review
description: 审查MiniMax Skills仓库的拉取请求。在审查PR、验证新技能提交或检查现有技能是否符合要求时使用。先运行验证脚本进行硬性检查，然后应用质量指南进行内容审查。触发条件：PR审查、拉取请求、验证技能、检查技能。
license: MIT
metadata:
    version: "1.0"
    category: tooling

PR 审查技能

根据仓库标准审查拉取请求。分为两个阶段：自动化验证，然后手动内容审查。

阶段 1：自动化验证（硬性规则）

运行验证脚本以检查结构要求：

python .claude/skills/pr-review/scripts/validate_skills.py

该脚本检查：

• 每个技能目录下是否存在 SKILL.md
• YAML 前置元数据可解析
• 必填字段存在：name、description
• name 与目录名称匹配
• 未检测到硬编码的秘密信息

所有 ERROR 级别的检查必须通过。WARNING 级别的项目（缺少 license、metadata）应被标记，但不作为阻塞项。

参见 [references/structure-rules.md](references/structure-rules.md) 以获取完整的硬性规则规范。

阶段 2：内容审查（软性指南）

在自动化检查通过后，根据质量指南审查 PR：

1. 技能范围 — 是否与现有技能重叠？边界是否清晰？
2. 描述质量 — description 是否包含清晰的触发条件？
3. 文件大小 — 参考文档的大小是否适合上下文窗口消耗？
4. API 密钥处理 — 如果使用了外部 API，凭据是否从环境变量中读取？
5. 脚本质量 — 脚本是否包含 shebang、requirements.txt 和错误处理？
6. 语言 — SKILL.md 和代码是否使用英语编写？
7. README 同步 — 新技能是否更新了 README.md 和 README_zh.md？

参见 [references/quality-guidelines.md](references/quality-guidelines.md) 以获取软性指南的详细信息。

审查清单摘要

必须通过（阻塞项）

• [ ] validate_skills.py 以退出码 0 结束
• [ ] PR 标题遵循常规提交格式
• [ ] 一个 PR，一个目的

应通过（在审查中标记）

• [ ] 与现有技能无功能重叠
• [ ] 描述包含触发条件
• [ ] 文件大小合理
• [ ] API 密钥通过环境变量传递
• [ ] 新技能的 README 表格已更新（来源列设置为 Community）