用途:校验 CLAUDE.md 中定义的多技能工作流(如 Daily Market Monitoring、Weekly Strategy Review、Earnings Momentum Trading),按顺序执行每个步骤,检查技能存在性、第 N 步输出与第 N+1 步输入之间的 JSON schema 兼容性、文件命名规范,并报告断裂的交接。适用于新增或修改多技能工作流后、修改技能输出格式后、发布新技能前、调试断裂交接时,以及作为触及技能脚本的 PR 的 CI 预检查。
前置条件:Python 3.9+;无需 API 密钥;无需第三方 Python 包(仅标准库)。所有校验均在本地离线进行,只读取 SKILL.md 和 CLAUDE.md,绝不修改技能,且结果确定——相同输入始终产生相同校验结果。
使用方式:
执行整体校验:python3 skills/skill-integration-tester/scripts/validate_workflows.py
--output-dir reports/
该命令解析 Multi-Skill Workflows 部分的所有 Workflow Name: 块,把每步的显示名解析为技能目录,并校验存在性、契约与命名。
按名称子串校验单个工作流:加 --workflow "Earnings Momentum"。
使用合成夹具 dry-run:加 --dry-run,夹具写入 reports/fixtures/ 并带 _fixture 标志。
随后查看生成的 Markdown 报告,或解析 JSON 报告。报告保存在 reports/,文件名为 integration_test_YYYY-MM-DD_HHMMSS.{json,md}。
主要能力:逐步骤技能存在性检查;交接契约校验(PASS / FAIL / N/A);文件命名违规检测;工作流整体状态(valid / broken / warning);JSON 与 Markdown 两种报告输出。
修复断裂交接时需确认:生产者技能输出包含所有必需字段;消费者技能输入参数接受生产者的输出格式;生产者输出与消费者输入之间的文件命名模式一致。
资源:scripts/validate_workflows.py(主校验脚本);references/workflow_contracts.md(契约定义与交接模式)。
限制:资料未提供具体收费、价格、平台支持范围及实际效果数据。