| name | testbuddy-skill |
| description | TestBuddy 测试设计技能包。当用户想要：(1) 生成测试框架/模块/场景/测试点/用例；(2) 根据 TAPD 需求或缺陷链接生成测试内容；(3) 根据任意文本（PRD/接口文档/代码/表格/功能描述）生成测试用例；(4) 打开/跳转到脑图、测试设计、TestBuddy 页面；(5) 进行测试设计、需求分析、缺陷分析时，使用本技能。 |
Design Agent Skill 测试设计技能包
核心定位
本 skill 是一个轻量级的意图识别和工作流调度器。
核心职责：
- 识别用户意图
- 加载会话上下文
- 路由到对应的工作流执行
工作流负责：
- 自己的执行清单规划
- 具体的执行逻辑（包括上下文补全、缺失数据处理等）
- 任务状态管理
工具能力清单
本 skill 及其工作流只能使用以下工具完成任务：
| 工具 | 文档路径 | 能力说明 |
|---|
get_session | references/tools/get_session.md | 读取/写入会话上下文（token、design_uid、knowledge_uids 等） |
get_issue | references/tools/get_issue.md | 通过 TAPD 链接或 workspace+issue_id 获取需求/缺陷详情 |
write_nodes | references/tools/write_nodes.md | 对脑图节点进行新增、修改、删除操作 |
search_nodes | references/tools/search_nodes.md | 查询脑图节点详细信息（支持按 UID 查询或查询整个 design） |
rag_search | references/tools/rag_search.md | 知识库检索（脚本检索 + RAG_search 附件检索） |
select_workflow | references/tools/select_workflow.md | 根据意图关键词匹配工作流 |
select_rule | references/tools/select_rule.md | 根据关键词匹配自定义规则 |
open_design | references/tools/open_design.md | 打开 TestBuddy 测试设计页面 |
⛔ 能力边界（严格遵守）：
- 禁止使用浏览器/网页获取内容：不要尝试打开 TAPD、OA 或任何外部网页来爬取/获取需求内容
- 获取需求/缺陷内容的正确途径：通过
get_issue 工具获取 TAPD 需求/缺陷详情，或从 get_session 返回的会话数据中读取
- 如果以上途径均无法获取所需信息，应提示用户提供需求内容（如粘贴文本、上传附件），而非自行去外部系统获取
执行流程【必须按步骤执行，严禁跳过任何步骤】
❗❗❗ 全局约束（所有步骤均适用）
执行脚本时绝对禁止 cd 切换目录：所有 Python 脚本必须在工作区根目录下执行，不要使用 cd 切换到任何其他目录。错误示例：cd /path/to/skill && python3 scripts/xxx.py，正确示例：python3 /path/to/skill/scripts/xxx.py。
步骤 1：识别用户意图
根据用户请求的关键词，识别用户想要执行的操作：
| 用户意图 | 触发关键词 | 意图关键词 |
|---|
| 生成测试框架 | 生成测试框架、生成框架、创建测试框架 | 框架生成 |
| 生成测试模块 | 生成测试模块、生成功能模块、识别测试模块 | 模块生成 |
| 生成测试场景 | 生成测试场景、生成场景、创建测试场景 | 场景生成 |
| 生成测试点 | 生成测试点、创建测试点、根据模块生成测试点 | 测试点生成 |
| 生成测试用例 | 生成测试用例、生成用例、根据测试点生成用例 | 用例生成 |
| 生成测试设计 | 生成测试设计、帮我做测试设计、测试设计 | 测试设计 |
| 开启SPEC | 生成 spec、开启spec工作流、spec | SPEC |
| 打开网页 | 打开脑图、打开测试设计、打开 TestBuddy、打开 testbuddy、跳转到测试设计、打开测试设计页面、帮我打开脑图 | 打开网页 |
步骤 2：初始化会话
使用 references/tools/get_session.md 工具读取上下文信息（design_uid、select_node、story_node、knowledge_uids 等）。
⛔ 错误处理（硬性终止）：如果脚本返回 status: error：
- 将返回的
msg 内容原样展示给用户
- 立即终止整个 skill 流程，禁止执行步骤 3 及后续任何步骤
- 禁止尝试任何替代方案、变通方法或降级策略（包括但不限于：自行获取需求内容、打开网页、调用其他工具）
- 唯一允许的动作是：展示错误信息，等待用户解决后重新触发
正常情况下，将返回的会话数据保留在上下文中，供后续工作流使用。
步骤 3：意图路由【打开网页意图在此短路】
如果步骤 1 识别到的意图为 打开网页：
- 调用
references/tools/open_design.md 工具执行打开逻辑
- 终止流程，不再执行后续步骤
步骤 4：选择并调用工作流
-
使用 select_workflow 工具：
- 调用
references/tools/select_workflow.md 工具
- 传入步骤 1 识别的意图关键词（如"用例生成"、"框架生成"）
-
调用工作流：
- 根据
select_workflow 返回的路径类型选择读取方式：
- 如果路径以
.codebuddy/rules/ 开头（自定义工作流）：使用 read_rules 读取
- 如果路径以
references/workflows/ 开头（默认工作流）：使用 read_file 读取
- 交由工作流执行具体逻辑
- 禁止不执行 select_workflow 流程直接读取文件/工作流
工作流能力矩阵（供参考）
| 生成目标 | 触发关键词 | 输入节点类型 | 输出节点类型 |
|---|
| 测试框架 | framework/框架 | STORY/BUG | FEATURE/SCENE/TEST_POINT |
| 测试模块 | feature/模块 | STORY/BUG | FEATURE |
| 测试场景 | scene/场景 | FEATURE/STORY/BUG | SCENE |
| 测试点 | tpoint/testpoint/测试点 | FEATURE/SCENE/STORY/BUG | TEST_POINT |
| 测试用例 | case/用例 | STORY/BUG/FEATURE/TEST_POINT/SCENE | CASE |
