testany-trigger

Testany Trigger

管理 Testany 平台上的 trigger，并负责 即时发起一次 pipeline execution。

用户输入: $ARGUMENTS

---

先统一心智模型

在开始之前，先按 automation-model.md 理解边界：

• pipeline 是执行与编排单元
• trigger 是执行入口
• trigger 决定“如何发起 execution”
• execution 发起之后的观测与管理属于 testany-execution

重要结论：

• 本 skill 既负责持久化执行入口，也负责即时单次触发
• 本 skill 不负责查看 execution 历史、轮询、取消或失败诊断

---

职责范围

• 创建/查询/更新/删除 Plan（定时计划）
• 创建/查询/更新/删除 Gatekeeper（Webhook 触发器）
• 覆盖 Manual Trigger 的平台概念、适用场景和当前支持路径
• 立即执行一次已有 pipeline（ad-hoc run now）
• 为已有 pipeline 提供合适的 trigger 方案建议
• 提供可复制的 Webhook / CI 集成示例

---

Trigger 类型

Persistent Trigger

长期存在、可重复复用的执行入口：

• Plan
• Manual Trigger
• Gatekeeper

Ad-hoc Trigger

一次性即时触发：

• testany_execute_pipeline

它会直接返回 execution_key，后续观测与管理交给 testany-execution。

---

MCP 支持现状

类型	平台能力	当前 MCP 支持	本 skill 的处理方式
Plan	完整	有	直接通过 MCP CRUD
Gatekeeper	完整	有（含 pipeline 绑定与 webhook URL）	直接通过 MCP 完成全流程
Manual Trigger	平台已支持	当前未看到对应 MCP tools	明确纳入 trigger 体系；若当前宿主/MCP 无工具，则指导用户走 UI fallback
Run Now	完整	有 (testany_execute_pipeline)	直接执行一次并返回 execution_key

---

操作速查

Persistent Trigger

用户意图	操作类型	MCP 工具
列出 Gatekeepers	Read	testany_list_gatekeepers
查看 Gatekeeper 详情	Read	testany_get_gatekeeper
创建 Gatekeeper	Create	testany_create_gatekeeper（可同时绑定 pipelines）
查看 Gatekeeper 绑定的 Pipelines	Read	testany_get_gatekeeper_pipelines
绑定/替换 Gatekeeper 的 Pipelines	Update	testany_bind_gatekeeper_pipelines
更新 Gatekeeper 字段	Update	testany_update_gatekeeper
删除 Gatekeeper	Delete	testany_delete_gatekeeper
列出 Plans	Read	testany_list_plans
查看 Plan 详情	Read	testany_get_plan
创建 Plan	Create	testany_create_plan
更新 Plan	Update	testany_update_plan
删除 Plan	Delete	testany_delete_plan
转移 Plan Owner	Update	testany_assign_plan

常用辅助：

• testany_get_my_workspaces
• testany_list_pipelines

Ad-hoc Run Now

用户意图	MCP 工具
立即执行一次 pipeline	testany_execute_pipeline

---

Trigger 选择原则

方式	适用场景
Plan	固定时间自动执行，如夜间回归、定时巡检
Manual Trigger	人工按需执行，如修复后复测、发布前验收
Gatekeeper	外部事件驱动执行，如 CI/CD、告警、Webhook
Run Now	现在立刻执行一次，不沉淀长期 trigger 资源

---

Run Now（立即执行一次）

适用场景

• “现在帮我跑一次这个 pipeline”
• “临时执行一次回归”
• “刚改完，立即验证”

流程

1. 如果用户没有明确 pipeline key：
   • testany_get_my_workspaces
   • testany_list_pipelines
   • 帮用户定位目标 pipeline
2. 调用 testany_execute_pipeline
3. 返回 execution_key
4. 明确告诉用户：
   • 执行已经发起
   • 接下来如需看进度、查历史、取消、看结果，切到 testany-execution

输入补充

如有需要，可同时传：

• environment
• parameters

但不要把这些一次性参数误写成长期 trigger 配置。

---

Plan（定时计划）

定义

Plan 用于按固定 schedule 自动触发一个或多个 pipeline。

创建流程

1. testany_get_my_workspaces → 选择 workspace
2. testany_list_pipelines → 选择要定时执行的 pipelines
3. testany_create_plan → 创建计划

建议同时填写：

• schedule_expr
• timezone
• schedule_str
• watchers

更新注意事项

Plan 更新应视为高风险“覆盖式更新”：

1. testany_get_plan 先读取现有配置
2. 基于现有配置构造完整 payload
3. 再调用 testany_update_plan

---

Manual Trigger（按需执行模板）

定义

Manual Trigger 用于按需执行一个或多个 pipeline，不依赖定时调度，也不依赖外部 webhook。

典型场景

• 热修复上线前快速回归
• 环境恢复后立即复测关键链路
• 人工发起标准化多 pipeline 验收

当前处理方式

如果当前 MCP/宿主没有 Manual Trigger 工具：

1. 帮用户确定 workspace 和 pipelines
2. 给出建议的名称、描述和 pipeline 列表
3. 提示用户到 Testany UI 创建 Manual Trigger

---

Gatekeeper（Webhook / 事件驱动）

定义

Gatekeeper 通过 Webhook 触发一个 pipeline group 的执行。

重要澄清

• Gatekeeper 不是 pipeline 编排工具
• Gatekeeper 不是 execution 观测工具
• “是否放行部署”属于外部 CI/CD 逻辑，应在调用 Gatekeeper 之后依据 execution 结果自行决定

创建流程

方式一：创建时直接绑定（推荐）

1. testany_get_my_workspaces → 选择 workspace
2. testany_list_pipelines → 选择要触发的 pipelines
3. testany_create_gatekeeper(workspace, name, pipelines=[...]) → 创建并绑定
4. testany_get_gatekeeper → 获取 hook_url
5. testany_update_gatekeeper → 配置 trigger_method / trigger_name / trigger_condition / watchers / owned_by

方式二：先创建，再绑定

1. testany_create_gatekeeper → 创建 Gatekeeper
2. testany_bind_gatekeeper_pipelines → 绑定 pipelines
3. testany_get_gatekeeper_pipelines → 确认绑定结果

Webhook URL 获取

通过 testany_get_gatekeeper 获取详情即可拿到 hook_url。如果用户无编辑权限，hook_url 会是 null。

---

CI/CD 集成示例

GitHub Actions

- name: Trigger Testany Gatekeeper
  run: |
    curl -X POST "${{ secrets.TESTANY_GATEKEEPER_WEBHOOK_URL }}" \
      -H "Content-Type: application/json" \
      -d '{"source":"github-actions"}'

Jenkins

stage('Quality Gate') {
    steps {
        sh '''
          curl -X POST "${TESTANY_GATEKEEPER_WEBHOOK_URL}" \
            -H "Content-Type: application/json" \
            -d '{"source":"jenkins"}'
        '''
    }
}

---

返回格式

任务完成后，向用户汇报：

• Trigger 类型：Plan / Manual Trigger / Gatekeeper / Run Now
• 目标 pipelines 列表
• MCP 直连完成
• 关键配置（schedule_expr、timezone、watchers、trigger_name 等）
• 如是 Run Now：
  • 返回 execution_key
  • 明确下一步去 testany-execution
• 如是 Gatekeeper：
  • 返回 Webhook URL（通过 testany_get_gatekeeper 获取；无权限时为 null）

---

参考文档

• Testany 自动化对象模型
• 核心概念