SuperAPI AI 工具集

preflight-validator

通用与其它

查看项目

更新于 10-16 06:51

技能介绍

用途:preflight-validator 是对 aura-frog/scripts/preflight/run-all.sh 的按需包装,用于在你希望校验 hook 看不到的对象时显式调用,例如提交前校验 Markdown 文件、对 Bash 命令做安全性 dry-run、批量对目录中的计划文件做 frontmatter 校验。自动 hook hooks/pre-flight-validate.cjs 会在每次 PreToolUse(Bash/Edit/Write/Read)时自动触发,失败则阻止工具调用,无需手动操作;本 skill 用于手动或批量场景。

主要能力:先解析目标(文件路径、Bash 命令字符串或 stdin 内容),再带相应参数运行 bash aura-frog/scripts/preflight/run-all.sh,并把退出码和 stderr 返回给调用方。Tier 1 检查器包括:validate-frontmatter.sh(校验 plan/skill/agent/rule/command 类 Markdown 的 YAML frontmatter)、validate-tool-input.sh(工具输入形状,如必填字段、绝对路径、无操作编辑)、validate-tool-output.sh(ANSI 转义数量、提示注入短语、JSON 声明合理性)、check-path-safety.sh(拒绝路径穿越、系统文件如 /etc/passwd、凭据目录)、check-command-allowlist.sh(硬阻止破坏性命令如 rm -rf /、mkfs、fork 炸弹,对 git push --force、DROP TABLE 等风险命令告警)、check-secret-patterns.sh(高置信度凭据模式,如 AWS、GitHub、OpenAI、JWT、私钥)。run-all.sh 负责编排并返回所有检查器中的最高退出码。退出码:0 通过(静默继续)、1 警告(发出警告并允许)、2 失败(阻止工具调用,PreToolUse hook 返回 2 后 claude-code 拒绝该工具)。

使用方式:自动模式下 hook 在 PreToolUse 时触发;手动可用 /aura-frog:preflight check 对当前工具上下文运行 run-all.sh;CI 中可用 bash aura-frog/scripts/preflight/run-all.sh --files <files> 做批量校验;贡献者编写新 hook 时可直接调用各个脚本。

限制:不运行 OPA Tier 2(推迟到 v3.7.0-rc.1+,OPA 在规范 §20.4 中为可选);只读,不修改工具输入/输出;不缓存结果,每次调用都是新执行(约 10ms,足够快);bash 不可用时没有回退,要求 Linux/macOS。当前状态为 v3.7.0-beta.1。其他安装方式、价格与平台支持暂未提供。