用途:扫描项目并配置 Agent Validator 的检查(checks)与审查(reviews)。开始前需阅读 references/check-catalog.md 了解检查类别、YAML schema 与示例。
主要流程:先读取 .validator/config.yml,若不存在则提示用户先运行 agent-validate init 并停止。检查 entry_points 字段,并结合 git 状态判断是否为新安装;仅当已提交配置含有效 entry_points/checks 或用户确认时才视为已有配置。已有配置时提供 Add checks、Add custom、Reconfigure 三种操作;Reconfigure 会备份 .validator/checks/.yml 与自定义 .validator/reviews/.md,清空 entry_points。
随后检测项目结构(monorepo、拆分项目或单项目),推断入口路径(src、lib 或根目录),扫描 6 类工具信号,展示类别、工具、命令与置信度表格并让用户确认。支持添加自定义 check(shell 命令)或 review(内置 code-quality 或自定义提示)。
配置写入 .validator/config.yml 的 entry_points,checks 内联为单键对象,内置 review 内联引用,自定义 review 写入 .validator/reviews/<name>.md。新配置始终包含 code-quality review。最后运行 agent-validate validate 校验,提交配置,运行 /validator-skip 推进基线,并提示可运行 /validator-run 或再次 /validator-setup。
限制:依赖 agent-validate init 生成的脚手架;git 不可用或状态不明确时需询问用户;校验失败仅尝试一次修正,仍失败则停止询问用户。