关于 check
check 是帮助工程师在合并前验证运行行为、审查代码差异或完成两者的 Agent Skill。它将运行验证与只读代码审查分为独立模式。
主要功能
- 01运行应用并按规格验证行为
- 02使用不同模型审查代码差异
- 03按严重程度排列审查发现
- 04将运行验证和代码审查分开
适用场景
- 01按验收标准检查功能
- 02提交 PR 前审查代码差异
- 03先运行验证,再请求代码审查
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ jsmastery-pro/ skills --skill check安装后在 Claude Code 中输入/check确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
review-agent-prompt.mdreview-guide.mdagents/openai.yamlmodes/review.mdverify.md详细介绍
输出风格(纯文字,不用破折号或连字符)
此技能生成的所有内容,无论是文件还是消息,都请使用简单直白的语言。用 you 称呼读者,语气温和直接,像同事交流一样,并将每个步骤写成建议,让读者可以选择执行或跳过,而不是下达命令。保留有实际意义的技术术语,并用通俗的语言解释。不要将破折号或连字符用作标点:不使用 em dash、en dash,也不使用带连字符的复合词。写作时用 read only,不要写 read-only。请使用简单的词语,或改写句子。其他技能会匹配的代码、文件路径、命令标志和取值请保留其中的连字符。使用短句、逗号或括号。清晰胜过巧妙。
此技能的作用
/check 是合并前的关卡。它有两种模式,各自负责不同的任务,通常两种都要运行,请先验证:
verify(运行时验证):运行真实应用并观察改动的表现。验证改动是否有效,以及是否符合规范(是否满足每一项验收标准,是否构建了规范中要求的每个界面),这些问题无法仅凭测试通过来发现。只读代码,不写入持久文件,在主线程运行。通常在/develop之后运行。review(由新模型进行代码审查):由资深人员审查差异,审查者使用的模型必须与编写代码的模型不同(模型审查自己的输出时会有相同的盲点)。将按严重程度排序的发现写入docs/reviews/。只读。通常在 PR 之前运行。
两种模式都不会编辑代码。verify 会将失败项指向 /debug 或 /develop;review 会报告需要修复的问题。
选择模式(开始任何操作前先确定路线)
第一步,在读取任何模式文件或操作仓库之前,先查看 /check 后面的内容:
- 以
verify(或run)开头 → 读取modes/verify.md,并完整遵循其中的说明。将剩余参数(功能名称、范围)一并传递。 - 以
review开头 → 读取modes/review.md,并完整遵循其中的说明。原样传递相关指示(例如/check review with opus、/check review uncommitted)。 - 没有模式词,或含义不明确(例如单独输入
/check,或输入没有模式词的功能名称,如/check auth)→ 不要猜测,也不要默认选择。请显示包含两个选项的纯文本面板,然后停止并等待工程师选择。
如何呈现选项(纯文本,适用于所有 Agent,无需交互式弹窗):
请准确打印以下内容,然后停止并等待。对方回答前不要默认使用 verify。根据对方输入的词路由(verify / review / both)。
Which check do you want to run? Type one:
• verify run the real app and prove the change works against its spec (usually right after /develop)
• review a fresh model senior read of the diff, ranked findings (usually right before a PR)
• both verify first, then review
不使用交互式选择器或弹窗:直接显示并让对方输入选项,在所有 AI 工具中的效果都相同。(Claude Code 自动补全也会通过 argument-hint frontmatter 显示 verify | review;其他工具会忽略它,因此这种行内面板是更通用的方式。)
如果对方输入了没有模式词的功能名称(/check auth),那么他们选择模式后,请将该名称作为目标;仍需询问模式。
单次运行不要混用模式。如果选择 both,先运行 verify,然后再提供 review 选项。
可移植性(适用于任意操作系统和 Agent)
适用于 macOS、Linux 或 Windows 上的任意 Agent Skills 客户端。唯一必需的命令行工具是 git。其他 shell 代码片段仅供 POSIX 参考,并非可直接运行的脚本:请使用 Agent 自带的跨平台文件、进程和浏览器工具。每个模式文件都会补充自己的可移植性说明。若不支持子 Agent,则改为行内运行,相关说明见各模式。
随附文件:modes/verify.md、modes/review.md,以及供审查使用的 review-agent-prompt.md 和 review-guide.md。只读取路由到的模式文件;启动审查者时,请将随附的审查文件解析为绝对路径。