关于 validator-commit
validator-commit 是用于明确纳入 Agent Validator 流程的提交技能。它会检测适用门禁,根据意图运行完整验证、仅运行检查或跳过验证,再按结果继续提交。
主要功能
- 01检测适用的验证门禁
- 02支持完整验证或仅运行检查
- 03支持明确跳过验证
- 04按验证流程执行提交
适用场景
- 01全部验证门禁通过后提交
- 02提交前仅运行检查
- 03提交时跳过验证状态
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ codagent-ai/ agent-validator --skill validator-commit安装后在 Claude Code 中输入/validator-commit确认已加载。
详细介绍
/validator-commit $ARGUMENTS
明确提交时的验证意图。先运行 agent-validate detect,再根据意图进行验证(完整运行、仅检查或跳过),处理失败情况,然后提交。
调用策略
仅当用户明确要求在提交流程中使用 Agent Validator 时,才使用此技能,包括完整验证、仅检查验证,或有意在提交时跳过验证器状态。
对于未提及 validator、gauntlet、checks、validation 或 skip 的普通“提交”“进行提交”或“提交这些更改”请求,不要选择此技能。
步骤 1 - 检测更改
使用 Bash 运行 agent-validate detect:
agent-validate detect 2>&1; echo "DETECT_EXIT:$?"
检查 DETECT_EXIT: 行中的退出代码:
- 退出代码 0 → 将运行门禁,继续步骤 2
- 退出代码 2 → 不会运行门禁(没有更改或没有适用的门禁),跳至步骤 4(直接提交)
- 退出代码 1 → 出错,向用户报告错误并停止
- 任何其他退出代码 → 视为错误,向用户报告输出并停止
步骤 2 - 确定验证意图
解析 $ARGUMENTS 以确定验证意图。若能明确判断意图,不要提示用户。
| ARGUMENTS 模式 | 操作 |
|---|---|
| 包含 "check" 或 "checks" | 调用 /validator-check(步骤 3b) |
| 包含 "run"、"full" 或 "all gates" | 调用 /validator-run(步骤 3a) |
| 包含 "skip" | 运行 agent-validate skip 2>&1(步骤 3c),然后转到步骤 4 |
| 为空或意图不明确 | 向用户提供以下三个选项,并等待选择 |
先判断是否匹配“check”或“checks”模式,再判断通用的“run”模式,以便
像“run checks before commit”这样的短语会选择 /validator-check。
提示用户时,提供以下选项:
- 运行所有门禁 — 完整验证(检查 + 审查)
- 仅运行检查 — 执行检查,不进行 AI 审查
- 跳过 validator — 不运行任何门禁,直接推进基线
然后继续执行与用户选择相对应的步骤。
步骤 3a - 完整验证(validator-run)
调用 /validator-run。
- 若通过 → 转到步骤 4
- 若失败 →
/validator-run技能会处理修复并重新运行。该技能完成后,询问用户:“准备好提交了吗?”。仅在用户确认后继续步骤 4。
步骤 3b - 仅检查验证(validator-check)
调用 /validator-check。
- 若通过 → 转到步骤 4
- 若失败 →
/validator-check技能会处理修复并重新运行。该技能完成后,询问用户:“准备好提交了吗?”。仅在用户确认后继续步骤 4。
步骤 3c - 跳过验证
运行:
agent-validate skip 2>&1
向用户报告命令输出,然后转到步骤 4。
步骤 4 - 提交
检查是否有可用于提交 Git 更改的技能(不包括 validator-commit 本身,以避免自行调用)。
- 若找到提交技能 → 调用该技能执行提交
- 若未找到提交技能 → 暂存所有已跟踪的更改,按照约定式提交格式(
<type>: <description>)拟定提交信息,然后运行git commit -m "<message>"
评论
支持 Markdown