Skill goal 是一个技能编排入口,用于在单个 Pull Request 上按固定顺序运行两个已有技能:先进行代码审查与质量检查,再进行代码简化,循环往复,直到某一轮审查不再列出任何问题,且紧随其后的一轮简化不再列出任何可简化项为止。
用途: 该技能的目标是让一个 PR 在审查和简化两个维度上逐步收敛。审查循环要求把审查中列出的每一项(包括 Critical、required、Nit、Optional、Consider、FYI,以及“某项检查未运行”这类句子)都视为待办工作,必须在 PR 中落实对应修改,或运行其指定的检查并记录结果,不能把待办重新标记为 FYI 后退出。简化循环要求应用该技能提出的每一项简化。只有审查一轮为空、且随后的简化一轮为空且未改动代码差异时,才算完成。
主要能力:
- 按顺序编排 code-review-and-quality 与 code-simplification 两个技能。
- 审查循环:反复运行审查技能,处理所有发现,直到某一轮不再列出任何内容。
- 简化循环:在审查循环退出后反复运行简化技能,应用所有简化,直到某一轮不再列出任何内容。
- 若简化过程修改了代码差异,自动回到审查循环,再重新简化,避免审查结果过期。
- 通过 CreateGoal 一次性设定目标,目标文本为固定块,仅替换 <PR> 占位符,不允许添加其他限定词。
- 缺少 PR 参数时停止并显示用法行,不猜测 PR。
- 读取技能文件时按固定顺序查找:~/.agents/skills/<name>/SKILL.md、~/.cursor/skills/<name>/SKILL.md、当前仓库的 .agents/skills/<name>/SKILL.md、.cursor/skills/<name>/SKILL.md;任一缺失则停止并列出已检查的路径。
使用方式: 命令为 /skill-goal <PR>。其中 <PR> 为 Pull Request URL 或 owner/repo#number 形式。若缺少参数,停止并显示用法行。首次运行前需完整读取 code-review-and-quality 和 code-simplification 两个技能文件;若任一缺失,停止并列出检查过的路径。随后调用一次 CreateGoal,目标文本为规定块,仅替换 <PR>,不添加“with a concrete fix”“promotable”等任何限定词;若创建失败,报告目标未设定并停止。创建目标后应在同一轮开始审查,不得在创建目标后停止,也不得在审查列表非空时进行简化。
适用场景: 适用于需要对单个 Pull Request 进行持续质量打磨、希望审查与简化两个环节都收敛到零发现的开发流程。适合在代码评审前或合并前使用。
限制:
- 仅处理单个 Pull Request,需提供 URL 或 owner/repo#number。
- 依赖 code-review-and-quality 与 code-simplification 两个技能文件存在。
- 审查循环中不得把任何发现视为可跳过,也不得通过重新标记为 FYI 来退出。
- 简化必须遵循 code-simplification 自身限制:保持行为不变、停留在 PR 差异范围内、不做出其“do not”部分拒绝的修改。
- 测试需保持通过,不得为适应行为变更而改写测试。
- 完成条件严格:审查一轮为空,且随后简化一轮为空且未改动差异。
- 资料未提供该技能的收费、平台支持范围或性能数据。