用途:validator-commit 用于在提交代码前显式引入 Agent Validator 验证流程。它只在用户明确提到 validator、gauntlet、checks、validation 或 skip 的提交请求中启用;普通的“commit”“make a commit”等请求不应使用此技能。
主要能力与流程:
- 检测变更:运行 agent-validate detect 2>&1; echo "DETECT_EXIT:$?",根据 DETECT_EXIT 判断:0 表示有门禁可运行,继续;2 表示无门禁可运行,直接提交;1 或其他值表示错误,报告并停止。
- 确定验证意图:解析 $ARGUMENTS。包含 check/checks 时调用 /validator-check;包含 run/full/all gates 时调用 /validator-run;包含 skip 时运行 agent-validate skip 2>&1 后提交;无明确意图时向用户提供三个选项:运行所有门禁(完整验证)、仅运行检查(不含 AI 审查)、跳过验证器。注意先判断 check/checks,再判断 run,因此“run checks before commit”会选择 /validator-check。
- 执行验证:完整验证调用 /validator-run,仅检查调用 /validator-check。若通过则进入提交;若失败,由对应技能处理修复并重跑,完成后询问用户“Ready to commit?”,仅在确认后继续。跳过验证则运行 agent-validate skip 2>&1,报告输出后提交。
- 提交:检查是否有可用的提交技能(排除 validator-commit 自身以避免自调用)。若有则调用该技能提交;若无,则暂存所有已跟踪变更,按 conventional commits 格式(<type>: <description>)提出提交信息,然后运行 git commit -m "<message>"。
适用场景:需要将验证器状态纳入提交决策的开发者工作流,包括完整验证后提交、仅运行检查后提交,或有意跳过验证器推进基线。
限制:仅限显式 validator 感知的提交请求;不适用于普通提交。验证失败时的修复与重跑由 /validator-run 或 /validator-check 技能负责。资料未提供安装方式、收费、平台支持或具体门禁内容。