技能介绍

问题背景

测试用例往往锁在 TPM（测试用例管理平台）里，开发在 IDE 里写代码时很难同步看到验收标准；反过来，自测、提测前对照用例、把用例写回平台，也多半靠切页面、手工复制。若希望 AI 参与编码或 TDD，需要能把「需求—用例—计划—执行记录」变成可读取、可写入的结构化操作，而不是让模型凭空猜测试范围。

技能如何工作

本技能封装 优测 TPM 的预编译 CLI（位于技能目录 scripts/），由 AI 按子命令调用平台 API。核心能力包括：

export-story-cases：按需求 ID 导出关联用例为 Markdown，便于对照实现与评审
search-cases-by-link / query-case-exes：检索用例与近 60 天执行记录
create-testcase、create-plan、add-plan-cases、exe-plan-cases、query-plan-cases、add-plan-comment：在用例库与测试计划侧创建用例、组计划、批量改执行状态并留评

加载技能时会走 Token / 用户 ID 配置（tpm_skill_application.yaml）、可选的版本更新检查，以及各命令文档里定义的必填参数规则：业务 ID 等须由用户明确提供，不能拿示例值凑数。

适用边界与注意点

能力以 SKILL 内「支持功能」表为准，未列出的平台能力尚未接入。
首次联网可能触发公司 iOA 拦截（输出中出现 http_status_code=403 时需用户放行后重新发起对话）。
Windows 上执行 CLI 需注意用 cmd /c，避免 PowerShell 把 stderr 转成 CLIXML 导致乱码；命令输出通常需 tee 到技能目录下的 txt 再按文档关键词判定结果。

截图预览

使用场景

接到新需求后，用需求 ID 调用 `export-story-cases` 导出关联用例 Markdown，供 AI 或本人对照实现与验收。
编码前按需求拉取用例做 TDD，实现过程中用导出的步骤与预期结果检查是否漏场景。
提测前对指定测试计划执行 `exe-plan-cases` 批量更新用例状态，并用 `add-plan-comment` 记录自测说明。
用例 ID 查询近 60 天执行记录导出 Markdown，或用 `search-cases-by-link` 按条件定位相关用例。

适合人员

负责需求交付的开发，需要把 TPM 上该需求的用例同步到 IDE/对话里，减少切平台核对验收标准。
维护测试计划与用例库的测试工程师，要在计划里批量加用例、查计划列表并回写执行结果。
参与需求或测试评审的技术负责人，需要结构清晰的用例 Markdown 做异步评审与范围对齐。
发现用例缺口时要在指定用例库目录 `create-testcase` 并纳入 `create-plan` / `add-plan-cases` 流程的交付同学。