Agent Skill 测试框架：写出可信赖的自动化测试

为什么 Skill 需要测试

Skill 是 AI 的能力单元。一个有 bug 的 Skill = AI 在关键时刻掉链子。

测试金字塔：

• 顶层 E2E：少量，覆盖关键路径
• 中层 Integration：适量，覆盖工具调用链
• 底层 Unit：大量，覆盖核心逻辑

单元测试

测试 Skill 的核心函数，不依赖外部服务：

import { parseWeatherResponse } from '../scripts/parser.js';

test('解析正常天气响应', () => {
  const result = parseWeatherResponse({ temp: 22, status: 'sunny' });
  expect(result.summary).toContain('22°C');
  expect(result.isGoodForOutdoor).toBe(true);
});

test('处理空数据', () => {
  expect(() => parseWeatherResponse(null)).toThrow('无效天气数据');
});

集成测试

测试 Skill 与外部 API 的交互，使用 mock：

test('调用天气 API 并格式化结果', async () => {
  const mockFetch = jest.fn().mockResolvedValue({
    json: () => Promise.resolve({ temp: 18, status: 'cloudy' })
  });
  global.fetch = mockFetch;
  
  const result = await getWeather('Shanghai');
  expect(mockFetch).toHaveBeenCalled();
  expect(result).toContain('18°C');
});

CI 集成

on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm test

最佳实践

• 测试文件放在 Skill 目录的 tests/ 下
• Mock 所有外部 API 调用
• 每次发布 Skill 前跑完测试
• 把测试覆盖率作为 Skill 质量指标