SuperAPI AI 工具集

cli-forge-validate

编程与开发

查看项目

更新于 10-15 20:09

技能介绍

用途:cli-forge Validate 是 cli-forge 技能族的验证阶段,用于在项目进入发布前,或需要重新审计时,确认生成的、接管采用的或扩展的 Rust CLI 技能项目符合全部结构、内容与代码约束。它读取 cli-plan.yml 定义应检查的内容,并生成结构化的 validation-report.yml。

主要能力:执行权威的 47 项合规规则集,覆盖 STRUCT-(结构与流水线产物忽略策略)、NAME-(目录与包命名)、DEPS-* 与 META-(依赖与 Cargo 元数据)、SKILL-(SKILL.md 契约)、BUILD-(构建、clippy 与格式校验)、TREE-(命令树契约完整性)、HELP-(叶子/非叶子/--help/help 行为及类 man 格式)、DIR-(运行时目录文档)、CTX-(Active Context 行为与优先级)、ERR-(结构化错误行为)、REPL-(存在时的 REPL 行为)、DAEMON-(存在时的守护进程生命周期、路由与错误行为)。每项检查结果为 PASS、WARN(缺少最佳实践但不阻塞)或 FAIL(阻塞发布),最终聚合为 compliant、warning 或 non_compliant。

使用方式:入口条件为 project_path 已知且存在、目标目录含 Cargo.toml、存在 cli-plan.yml(用于行为检查)。先阅读 ./planning-brief.md 了解基线规划限制,再执行 ./instructions/validate.md 中的规则集,结合文件系统、代码与测试输出逐项判定,并按 ./contracts/validation-report.yml.tpl 模板生成 .cli-forge/validation-report.yml,报告需快照契约/回执来源,供 Publish 阶段比对。

适用场景与限制:适用于发布前把关或重新审计。WARN 不阻塞发布;FAIL 必须阻塞任何发布或 npm 分发,需返回 Takeover、Scaffold、Extend 或 Design 修复。若 cli-plan.yml 标记守护进程行为 in_scope,应验证声明的守护进程契约而非降级为旧假设。若既有项目缺少 .cli-forge/cli-plan.yml,不得在 Validate 内临时编造计划:已有 design-contract.yml 则转 Plan,否则转 Takeover 重建基线。不得自动发布,需让用户先审阅报告。后续步骤:compliant 或 warning 进入 ../cli-forge-publish/SKILL.md;non_compliant 返回修复。