メニュー
TCase 自动化测试代码生成技能。当用户需要生成测试代码、自动化测试、根据UUID/文本用例/节点生成测试时触发。支持 uuid、text_case、node、standard 四种模式。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | tcase-codegen |
| description | TCase 自动化测试代码生成技能。当用户需要生成测试代码、自动化测试、根据UUID/文本用例/节点生成测试时触发。支持 uuid、text_case、node、standard 四种模式。 |
| allowed-tools | null |
| disable | false |
<skill_dir> 是本 skill 加载时的 base directory 路径前缀（不要写死路径）。所有对 skill 内部文件（脚本、日志等）的引用，均使用 <skill_dir> 作为前缀。
你可以打印出来 <skill_dir> 的值，以确认是否正确。在调用任何MCP工具之前，你必须按顺序完成以下所有检查：
python3 <skill_dir>/scripts/env_prepare.py || python <skill_dir>/scripts/env_prepare.pyuser_id（如果为空则停止，提示用户）user_repo（如果有多个仓库，必须让用户选择）user_branch[阻断] 如果任何一项未完成，不得进入检查点2。
references/phase2_params.md 中关于 case_text 的结构化与非结构化用例说明user_query 参数[阻断] 如果操作模式不明确，必须询问用户，不得猜测。
<attached_files> 标签）.py 文件或文件夹路径 → code_path，.md/.mdc 文件 → 约束文件.md/.mdc 文件的绝对路径已追加到 case_note[CONSTRAINT_PATH]{绝对路径}[/CONSTRAINT_PATH][阻断] 如果有约束文件但未追加到 case_note，不得调用MCP工具。
case_uuid 使用数组格式：["uuid1", "uuid2"][通过] 完成所有检查点后，才能调用 mcp__TCase__generate_code。
收到 MCP 返回后，必须先阅读
references/phase3_result.md中的「MCP 返回结构解读」章节，理解返回字段含义和code字段的两种正常形态（代码框架 vs 用例描述），再执行以下检查项。关键提醒：
status: "success"+code是纯文本用例描述 = 正常的纯文本用例返回，不是错误！不要走规则5的错误处理路径。
references/phase3_result.md 的「MCP 返回结构解读」，理解当前返回属于哪种形态order 字段提取代码模板规范（忽略项目中原生的模版以order字段提供为准）、工作流模式（file_append/create_file/dir_append）和目标路径code 字段形态：代码框架（高分用例）→ 补全 TODO；用例描述（纯文本用例）→ 从零生成code 字段提到的业务动作、API 名称和相关线索；如果首次未直接命中，已继续搜索别名、封装层、调用链等间接实现，获取调用方式和导入路径order 模板规范生成完整可执行的测试代码（不是转述 MCP 返回内容！）order 指定的目标路径tcase_uuid字段一定存在且为标准 UUID 格式：优先复用 design_case_uuid——如果该测试函数的 docstring/元信息中已有 design_case_uuid，则 tcase_uuid 直接取与 design_case_uuid 相同的值，无需调用生成脚本；仅当测试函数没有 design_case_uuid 时，才提取函数名调用 python3 <skill_dir>/scripts/generate_tcase_uuid.py <repo> <branch> '["func_name_1", ...]' 批量生成；写入完成后必须校验所有 tcase_uuid 的值均为标准 RFC4122 UUID 格式（xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx），非标准格式（如占位符）必须替换为真实 UUID 后才能通过检查[阻断] MCP 只返回指令和素材，不会生成代码也不会写入文件。你必须亲自完成代码生成和文件写入，否则不得进入检查点6。 [要求] 一次搜索无结果不是失败条件，必须继续沿别名、封装层、调用链和相似测试扩展搜索后再完成代码生成。
测试代码已生成并同步到TCase系统。说明：上传由 PostToolUse Hook 自动触发，write_to_file / replace_in_file 写入包含 tcase_uuid 的文件后会自动后台上传，无需手动执行。
[严重] 如果检查点5未完成，整个任务视为失败！
生成代码时，MCP 返回的 order 字段中的模板和指令具有最高优先级。禁止因"与项目已有代码风格保持一致"而偏离 order 中的模板
order 中的模板order 字段开头通常包含代码模板规范说明order 中的模板格式order 模板与项目已有代码格式不同，以 order 为准每次调用MCP工具前，必须检测是否存在约束文件（.md 或 .mdc 结尾）。
<attached_files> 标签）<rules_context> 标签）case_note[CONSTRAINT_PATH]/absolute/path/to/constraint.mdc[/CONSTRAINT_PATH]示例：
{
"case_note": "用户的额外约束\n[CONSTRAINT_PATH]/data/workspace/yottadb/功能测试代码生成规范.mdc[/CONSTRAINT_PATH]"
}
code_path 参数只能填入 .py 文件或文件夹路径.py 文件，将其归类到 case_note 或忽略code_path: "/path/to/规范.md" ❌code_path: "/path/to/test_example.py" ✅在调用MCP工具前，必须检查：
{} 成对出现" 成对出现case_uuid: ["uuid1", "uuid2"]）case_text、node_info）内部引号已转义如果格式错误，不得调用MCP工具，必须修正后再调用。
仅以下情况才视为 MCP 内部错误，直接回复用户并停止：
status 字段值不是 "success"order 和 code 字段均为空当确认为 MCP 内部错误时，你必须直接回复：
"很抱歉，当前无法生成自动化测试用例，请联系TCase团队排查问题信息以发起下一次提问"
并中文描述内部报错内容即可。
以下情况不是错误，必须继续执行代码生成：
status: "success" 但 code 是纯文本用例描述（含"用例名:"、"步骤1:"等）→ 正常的纯文本用例返回，必须尽全力从零生成代码status: "success" 但 code 中有大量 #TODO → 正常的高分用例返回，必须尽全力补全 TODOstatus: "success" 且 code 内容看起来不像代码 → 先按检查点4.5判断形态，再决定处理方式切记：
code字段返回纯文本用例描述是 MCP 的正常工作模式之一，不是生成失败！遇到这种情况绝不能走错误处理路径。
code 中直接提到的业务动作、接口名、资源名、字段名等直接线索MCP 内部报错，否则必须继续完成代码生成路径执行进度清单（完成上述检查点后使用）：
生成进度：
- [ ] 步骤 1：环境准备
- [ ] 步骤 2：参数组装
- [ ] 步骤 3：MCP 调用与结果处理
- [ ] 步骤 4：批量用例生成处理（`node` 模式需要时执行）
- [ ] 步骤 5：上传与归档（Hook 自动完成）
步骤 1：环境准备
必须完成：references/phase1_env_prepare.md 中的所有检查项
核心任务：
输出要求：
user_id: 当前用户名user_repo: 目标仓库名user_branch: 目标分支code_path: 用户引用的.py文件路径或目录路径（如果有）case_note: 包含约束文件路径的完整字符串步骤 2：参数组装
必须完成：references/phase2_params.md 中的参数组装规则
核心任务：
op_type 模式（uuid/text_case/node/standard）request 对象包裹传递）user_query输出要求：
步骤 3：MCP 调用与结果处理
必须完成：references/phase3_result.md 中的代码生成与写入流程
核心任务：
generate_code 工具order 字段中的模板规范、工作流模式和目标路径输出要求：
步骤 4：批量用例生成处理
必须完成：references/phase4_batch.md 中的批次处理规则
核心任务：
node 模式首次调用用于获取 UUID 列表uuid数组处理uuid模式调用 MCP 工具，批次内不需要一个个单独调用tcase_uuid 复用规则：如果测试函数有 design_case_uuid，tcase_uuid 直接复用该值；没有时才调用脚本生成输出要求：
步骤 5: 上传与归档（由 Hook 自动完成）
上传由 PostToolUse Hook 自动触发，无需手动执行命令。
详见：references/phase5_upload.md
用户感知要求（必须遵守）:
YottaDB 分布式数据库功能测试代码生成工具。当用户需要生成 YottaDB 测试代码、根据 UUID/文本用例/节点生成测试、编写 TSDB/MEMDB/SSDKV 等模块的功能测试时触发此技能。
腾讯云鼎实验室出品，Skill安全审查工具。对用户指定的skill.md文件及其配套的文档、程序、脚本等进行全面安全审计，确保引用安全
ALB自动化测试用例代码生成工具。当用户需要为 ALB（Application Load Balancer）生成自动化测试用例、编写接口测试代码、根据 API 文档生成测试代码时触发此技能。支持通过关键词（ALB）自动拉取对应源码，严格遵循 DB 校验、接口联动、LD(nginx) 校验、数据清理（DB查询→delete接口→DB校验残留）等测试规范。支持 set 类、LD 类、listener 类等多种资源接口的测试代码生成。
CloudGame autotest code generator - 根据CloudGame项目的测试设计文档生成pytest自动化测试用例代码。当用户提供测试设计规范（通过UUID或直接描述）并需要将其转换为遵循项目约定的Python pytest测试用例时使用。支持多个模块（xhd、proxy、master、resource_svr、cgmanager、wx_video），并具有特定的命名规则、目录结构和测试框架。
TCase 用例生成 spec 工作流。提供完整的5阶段测试用例生成流程：查询需求→需求分析→测试点设计→用例生成→同步到脑图。当 testbuddy-skill 检测到此技能包存在时自动使用。
文本测试用例生成技能包。任何有关于文本测试用例生成、文本测试用例框架生成、脑图用例生成、召回、需求分析等文本测试用例生成的相关问题，都可以使用此技能。