前言¶

在 CI 或发布前做批量用例回归时，常见做法是登录 TP 平台点选任务、盯执行状态、再拉报告。若你已经在 Cursor、Claude Code 等环境里用 Agent 编排日常开发，希望把「触发测试、查资源、看结果」收进同一套对话流程，就需要一份把平台 API 与配置写清楚的 Skill，而不是每次手写 curl 或翻内部文档。

下面介绍 SkillHub 社区技能 千流-aitest（坐标 @user_6c0ab08d/qianliu-aitest，版本 1.0.0）。它面向千流 AI 测试效能平台（TP）集成，把任务执行、资源查询、状态监控和报告获取整理成 Agent 可遵循的说明。

这是什么¶

千流-aitest 是发布者 user_6c0ab08d 在 SkillHub 上架的社区 Skill，分类为 ai-agent，简介为「千流AI自动化技能」；技能包内核心文档对自身的描述是「千流 AI 测试效能平台集成技能」。

它解决的是：在支持 SKILL.md 的 Agent 中，按固定路径配置 TP 平台 Token 与任务参数，并依文档调用平台 REST 接口或配套脚本，完成测试任务下发与结果跟进。SkillHub 页面标注 requires_api_key=true，使用前必须配置 TP 访问凭证。

核心功能¶

以下能力均来自技能包内 SKILL.md，未在文档中出现的不作延伸：

1. 执行 TP 平台的测试任务（文档示例通过 execute-tp-test 脚本，并对应 POST /api/test/execute）。
2. 获取测试床与执行主机信息（GET /api/resource/testbeds、GET /api/resource/exec-hosts）。
3. 监控测试执行状态（GET /api/test/status/{taskId}）。
4. 获取测试报告（GET /api/test/report/{taskId}）。

默认平台基址在配置示例中为 https://tp.atrust.sangfor.com；具体 project_id、version_id、ai_testcase_task_id 等需按你所在项目填写。

安装与启用¶

安装 SkillHub CLI（若尚未安装）¶

先确认本机是否已有 CLI：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 官方安装说明执行完整安装（含 CLI 与默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装千流-aitest¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则技能可能落在默认 ./skills/ 而不会被识别。SkillHub 页面给出的安装提示为：依据 SkillHub 安装文档 安装 @user_6c0ab08d/qianliu-aitest。

在已安装 skillhub 的前提下，社区命名空间安装示例为：

skillhub install qianliu-aitest --namespace user_6c0ab08d --dir <你的 Agent skills 目录>

常见路径（以 SkillHub 文档为准）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装完成后，按你所用客户端要求重启或刷新 Agent，使新 Skill 被加载。

TP 平台与任务配置¶

1. Token 与基址

在用户目录创建或编辑 ~/.qianliu/config.json，写入 TP 平台 Token 与基址：

{
  "tp_token": "your_token_here",
  "tp_base_url": "https://tp.atrust.sangfor.com"
}

Token 获取步骤（文档原文）：登录 https://tp.atrust.sangfor.com → 个人设置 → API Token → 生成或复制后写入上述文件。

2. 任务参数

在工作区路径 workspace/.qianliu/.qianliu-aitest/tp-aitest-config.yaml 中配置任务（以下为文档中的示例结构，ID 需替换为你的项目实际值）：

tp_platform:
  project_id: 8
  version_id: 117
  ai_testcase_task_id: 1488
  agent_version: "v1"
  testbed_name: ""
  exec_host_name: ""
  desc: "批量测试任务（上线验证）- 千流manus"

典型用法¶

技能文档假设在技能目录下存在 scripts/ 中的 PowerShell 脚本；当前从 SkillHub 拉取的 1.0.0 包仅含 SKILL.md，实际执行前请确认你本地技能目录是否包含这些脚本，或让 Agent 严格按文档中的 API 与参数自行调用。

执行测试任务（文档示例，需在技能根目录执行）：

./scripts/execute-tp-test.ps1 -PlanId 1488 -ProductId 8 -ProjectId 117

参数含义与 tp-aitest-config.yaml 中的 project_id、version_id、ai_testcase_task_id 等应对齐，勿直接照搬示例数字。

获取测试床列表：

./scripts/get-resources.ps1 -Type testbed

与 REST 对照时，测试床列表对应 GET /api/resource/testbeds；执行主机为 GET /api/resource/exec-hosts。任务状态与报告分别使用 GET /api/test/status/{taskId}、GET /api/test/report/{taskId}。

在 Agent 对话中的常见做法是：先说明要跑的 plan / 产品 / 项目 ID，让 Agent 读取本 Skill 与上述配置文件，再按接口或脚本触发执行并轮询状态，最后拉取报告摘要。

适用场景与注意¶

适合谁

• 已使用千流 TP（tp.atrust.sangfor.com）做 AI 测试或批量用例任务的内网团队。
• 希望在 Cursor、Claude Code 等环境中，用自然语言触发「查测试床 → 跑任务 → 看报告」，而不是每次打开 Web 控制台。

限制与注意

• 必须配置有效 tp_token；SkillHub 标签已标明需要 API Key，无 Token 无法调用平台接口。
• 文档中的脚本路径为 PowerShell（.ps1），在纯 Linux 环境需改用 WSL、远程 Windows 执行机，或直接按同一 Skill 中的 HTTP API 说明调用。
• 测试床需为「空闲」、执行主机需在线；文档故障排查节列出了 Token 无效、测试床占用、主机连接失败时的检查项。
• SkillHub 统计（以页面抓取为准）：评分 100000，下载 952，安装 0；社区来源，升级与脚本完整性以 SkillHub 上该坐标最新包为准。

结尾¶

千流-aitest 把 TP 平台的 Token 配置、任务 YAML 与一组固定 REST 端点写进标准 SKILL.md，便于在 Agent 工作流里复用千流 AI 测试能力。安装与坐标以 SkillHub 为准。

• 技能 API 入口：https://api.skillhub.cn/user_6c0ab08d/qianliu-aitest
• SkillHub 页面：https://www.skillhub.cn/skills/user_6c0ab08d/qianliu-aitest
• 安装说明：https://skillhub.cn/install/skillhub.md