$npx -y skills add TestAny-io/testany-agent-skills --skill testany-guideTestany 平台核心概念和配置参考
| 1 | # Testany 平台参考 |
| 2 | |
| 3 | 本 skill 提供 Testany 平台的核心概念参考。详细内容见 references/ 目录。若上游来自 `testany-eng`,优先配合 approved Test Spec 中的 `Testany Automation Handoff` 一起使用。 |
| 4 | |
| 5 | ## 核心实体关系 |
| 6 | |
| 7 | ``` |
| 8 | Traditional Test Scenario |
| 9 | │ |
| 10 | └──► Testany Platform Case |
| 11 | │ |
| 12 | └──► Pipeline (执行与编排单元) ──► Execution |
| 13 | │ |
| 14 | ├──► Plan |
| 15 | ├──► Manual Trigger |
| 16 | └──► Gatekeeper |
| 17 | ``` |
| 18 | |
| 19 | ## 快速参考 |
| 20 | |
| 21 | - 对象边界与职责链 → [automation-model.md](references/automation-model.md) |
| 22 | - 实体定义和可见性规则 → [concepts.md](references/concepts.md) |
| 23 | - Executor 配置详解 → [executors.md](references/executors.md) |
| 24 | - Pipeline YAML 语法 → [pipeline-yaml.md](references/pipeline-yaml.md) |
| 25 | |
| 26 | ## 宿主能力适配 |
| 27 | |
| 28 | `testany-bot` 通用版按**能力**而不是按**宿主品牌**分支: |
| 29 | |
| 30 | - 如果宿主支持结构化提问工具(如 AskUserQuestion),优先一次性收集缺失信息。 |
| 31 | - 如果宿主不支持该工具,则用普通文本在当前对话中提问;低风险字段可给出默认值建议,但必须明确告知用户。 |
| 32 | - 如果宿主支持 slash command / router,可推荐相关 workflow 的命令入口。 |
| 33 | - 如果宿主不支持 slash command,不要阻塞任务;直接在当前线程继续对应 workflow。 |
| 34 | |
| 35 | ## 标识符格式 |
| 36 | |
| 37 | | 类型 | 格式 | 示例 | |
| 38 | |------|------|------| |
| 39 | | Case Key | 8 位大写十六进制 | `A1B2C3D4` | |
| 40 | | Pipeline Key | `{WS_KEY}-{4-5位大写十六进制}` | `Y2K-0001A` | |
| 41 | | Workspace Key | 3 位大写字母数字 | `Y2K` | |
| 42 | | Execution ID | `{pipeline_key}-{5位大写十六进制}` | `Y2K-0001A-0000B` | |
| 43 | |
| 44 | ## MCP Schema Resources |
| 45 | |
| 46 | 在组装 API payload 前,应先读取对应的 schema resource: |
| 47 | |
| 48 | | Resource URI | 用途 | |
| 49 | |--------------|------| |
| 50 | | `testany://schema/case` | Case 创建/更新字段定义 | |
| 51 | | `testany://schema/pipeline` | Pipeline YAML 完整 schema | |
| 52 | | `testany://schema/import-git` | V2 Git 导入(连接 / 浏览 / 同步 / switch / relation / webhook)全量流程与类型 | |