mcpField
S
skill-integration-tester

skill-integration-tester

github.com/tradermonty测试与质量3.4k3.2k 次安装2 天前更新
代码仓库

关于 skill-integration-tester

skill-integration-tester 是用于检查 CLAUDE.md 多技能工作流的本地 Python 技能，可验证步骤、数据交接和文件命名，并支持离线模拟及报告生成。

主要功能

  1. 01验证工作流步骤和技能是否存在
  2. 02检查 JSON 交接兼容性
  3. 03发现文件命名违规
  4. 04使用合成样例离线运行
  5. 05生成 Markdown 和 JSON 报告

适用场景

  1. 01编辑 CLAUDE.md 后检查工作流
  2. 02更改技能输出后验证兼容性
  3. 03发布前查找交接故障
  4. 04为技能变更执行 CI 预检查

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tradermonty/claude-trading-skills --skill skill-integration-tester

安装后在 Claude Code 中输入/skill-integration-tester确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

requirements.txt
references/
workflow_contracts.md
scripts/
validate_workflows.py
scripts/tests/
conftest.py
test_test_workflows.py

详细介绍

技能集成测试器

概述

通过按顺序执行 CLAUDE.md 中定义的多技能工作流（每日市场监控、每周策略复盘、财报动量交易等），验证这些工作流。检查技能间数据契约的 JSON schema 兼容性，确保第 N 步的输出与第 N+1 步的输入兼容；验证文件命名约定，并报告交接故障。支持使用合成 fixture 的试运行模式。

适用场景

  • 在 CLAUDE.md 中添加或修改多技能工作流后
  • 更改技能的输出格式（JSON schema、文件命名）后
  • 发布新技能前，验证流水线兼容性
  • 调试连续工作流步骤之间的交接故障时
  • 对涉及技能脚本的拉取请求执行 CI 预检查时

前提条件

  • Python 3.9+
  • 无需 API 密钥
  • 无需第三方 Python 包（仅使用标准库）

工作流

第 1 步：运行集成验证

针对项目的 CLAUDE.md 执行验证脚本：

python3 skills/skill-integration-tester/scripts/validate_workflows.py \
  --output-dir reports/

此脚本会解析多技能工作流部分中的所有 **Workflow Name:** 区块，将每个步骤的显示名称映射到技能目录，并验证其存在性、契约和命名。

第 2 步：验证特定工作流

通过名称子字符串指定单个工作流：

python3 skills/skill-integration-tester/scripts/validate_workflows.py \
  --workflow "Earnings Momentum" \
  --output-dir reports/
第 3 步：使用合成 fixture 进行试运行

为每项技能预期的输出创建合成 fixture JSON 文件，并在不使用真实数据的情况下验证契约兼容性：

python3 skills/skill-integration-tester/scripts/validate_workflows.py \
  --dry-run \
  --output-dir reports/

Fixture 文件会写入 reports/fixtures/，并设置 _fixture 标志。

第 4 步：查看结果

打开生成的 Markdown 报告，查看便于阅读的摘要；或者解析 JSON 报告，以供程序处理。每个工作流会显示：

  • 逐步检查技能是否存在
  • 交接契约验证（PASS / FAIL / N/A）
  • 文件命名约定违规项
  • 工作流总体状态（有效 / 故障 / 警告）
第 5 步：修复交接故障

对于每个 FAIL 交接，请确认：

  1. 生产者技能的输出包含所有必需字段
  2. 消费者技能的输入参数接受生产者的输出格式
  3. 生产者输出与消费者输入的文件命名模式一致

输出格式

JSON 报告
{
  "schema_version": "1.0",
  "generated_at": "2026-03-01T12:00:00+00:00",
  "dry_run": false,
  "summary": {
    "total_workflows": 8,
    "valid": 6,
    "broken": 1,
    "warnings": 1
  },
  "workflows": [
    {
      "workflow": "Daily Market Monitoring",
      "step_count": 4,
      "status": "valid",
      "steps": [...],
      "handoffs": [...],
      "naming_violations": []
    }
  ]
}
Markdown 报告

结构化报告，按工作流分节展示步骤验证、交接状态和命名违规项。

报告会保存到 reports/，文件名为 integration_test_YYYY-MM-DD_HHMMSS.{json,md}。

资源

  • scripts/validate_workflows.py -- 主验证脚本
  • references/workflow_contracts.md -- 契约定义和交接模式

核心原则

  1. 无需 API 密钥 -- 所有验证均在本地离线完成
  2. 非破坏性 -- 仅读取 SKILL.md 和 CLAUDE.md，绝不修改技能
  3. 确定性 -- 相同的输入始终产生相同的验证结果

评论

支持 Markdown