用途:校验 CLAUDE.md 中定义的多技能工作流(如每日市场监控、每周策略复盘、财报动量交易等),按顺序执行每个步骤,检查技能是否存在、步骤 N 输出与步骤 N+1 输入之间的 JSON schema 兼容性、文件命名约定,并报告断裂的交接。
适用时机:新增或修改 CLAUDE.md 中的多技能工作流后;更改某技能输出格式(JSON schema、文件命名)后;发布新技能前验证流水线兼容性;调试连续工作流步骤间的断裂交接;作为涉及技能脚本的 PR 的 CI 预检查。
前提:Python 3.9+,无需 API 密钥,无需第三方 Python 包(仅用标准库)。
用法:运行校验脚本,例如 python3 skills/skill-integration-tester/scripts/validate_workflows.py --output-dir reports/;可用 --workflow "Earnings Momentum" 按名称子串指定单个工作流;用 --dry-run 生成合成夹具 JSON 文件并校验契约兼容性,夹具写入 reports/fixtures/ 并带 _fixture 标记。
输出:生成 JSON 与 Markdown 报告,保存到 reports/,文件名形如 integration_test_YYYY-MM-DD_HHMMSS.{json,md}。JSON 含 schema_version、generated_at、dry_run、summary(total_workflows、valid、broken、warnings)及每个工作流的步骤、交接、命名违规。每个工作流显示逐步技能存在检查、交接契约校验(PASS/FAIL/N/A)、文件命名违规、整体状态(valid/broken/warning)。
修复:对每个 FAIL 交接,确认生产者技能输出包含所有必需字段、消费者技能输入参数接受生产者输出格式、文件命名模式在生产者输出与消费者输入间一致。
资源:scripts/validate_workflows.py 为主校验脚本;references/workflow_contracts.md 为契约定义与交接模式。
原则:无需 API 密钥,全部本地离线校验;非破坏性,仅读取 SKILL.md 与 CLAUDE.md,不修改技能;确定性,相同输入始终产生相同校验结果。