用途:在给 GateFlow 打标签或发布前执行发布就绪检查,确保版本、元数据、文档与组件数量一致。
主要能力:运行确定性校验器 python3 tools/validate_gateflow.py --version <target-version>,检查插件与市场 JSON 版本一致性、描述与 README 中的组件数量、docs/gateflow.index 对每个命令/技能/智能体的覆盖、命令相邻技能与智能体文件的根级镜像,以及目标版本的发布说明条目。
使用方式:需提供目标版本(如 2.5.0)并说明是仅检查还是发布准备编辑;未提供版本时,可查看 plugins/gateflow/.claude-plugin/plugin.json 并按变更类型建议下一个语义化版本(元数据/文档/打包修复为补丁,新增命令、技能、智能体、IP 或看板为次版本,破坏性布局或工作流变更为主版本)。准备流程包括统计组件数量、更新 plugin.json 与 marketplace.json 版本、更新 README、docs/gateflow.index 与 releases.md,运行 python3 -m unittest tests/test_validate_gateflow.py 与校验器,通过后再执行 git tag v<target-version> 与 gh release create v<target-version> --title "GateFlow v<target-version>" --notes-file <notes-file>。
适用场景:GateFlow 插件仓库的版本发布与发布前审查。
限制:校验器必须通过才能创建标签;具体命令、路径与报告格式以资料为准,其他环境细节暂未提供。