需通过代码调用flowable/activiti api启动github copilot工作流：先确认bpmn流程已部署，再用runtimeservice.startprocessinstancebykey()按key启动并传入prnumber等必要变量；注入github token至beans并显式清除；最后通过executionlistener监听结束事件，回调github checks api更新pr状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Flowable或Activiti中通过代码触发GitHub Copilot工作流引擎的流程实例，需绕过标准UI启动路径，直接调用流程引擎API完成初始化。
确认流程定义已部署到引擎
进入Flowable Modeler或Activiti Admin控制台，检查目标BPMN文件（如copilot-ci-pipeline.bpmn20.xml）状态是否为“已部署”。未部署的流程定义无法被代码引用，调用runtimeService.startProcessInstanceByKey()会抛出ActivitiObjectNotFoundException。
若使用Maven构建，确保BPMN文件位于src/main/resources/processes/下，并在Spring配置中启用自动部署：spring.activiti.check-process-definitions=true。
在Java中启动Copilot关联流程实例
方法一：按流程定义Key启动（推荐）
调用RuntimeService.startProcessInstanceByKey("copilot-pr-review")，传入与BPMN文件中id="copilot-pr-review"完全一致的字符串。Key不区分大小写但必须精确匹配，多一个空格或下划线都会导致ProcessDefinitionNotFoundException。
方法二：按部署ID启动（调试用）
先执行repositoryService.createProcessDefinitionQuery().processDefinitionKey("copilot-pr-review").singleResult().getId()获取部署ID，再传给startProcessInstanceById()。此方式绕过Key校验，适合验证部署是否成功，但生产环境禁止硬编码部署ID——它每次重新部署都会变更。
方法三：带变量启动（必需）
GitHub Copilot工作流依赖上下文变量驱动分支逻辑，例如：Map<string object> vars = new HashMap(); vars.put("prNumber", 1234); vars.put("repoName", "myorg/frontend"); runtimeService.startProcessInstanceByKey("copilot-pr-review", vars);</string>。缺少prNumber会导致后续服务任务无法定位Pull Request，流程卡在第一个UserTask。
注入GitHub API凭证与权限上下文
第一步：在流程启动前，将GitHub Token注入ProcessEngineConfiguration的beans映射中：
config.setBeans(Map.of("githubToken", System.getenv("GITHUB_TOKEN")))。此Token必须具备pull_requests:write和contents:read权限，否则服务任务调用GitHub REST API时返回403。
第二步：在BPMN的ServiceTask中引用该Bean，例如设置class="com.example.GitHubPRCommentDelegate"，并在其execute()方法内通过execution.getEngineServices().getRuntimeService().getVariable("githubToken")读取。
第三步：为防止Token泄露，【务必在流程结束时显式清除变量】：runtimeService.removeVariable(execution.getId(), "githubToken")。不执行此步可能导致Token残留于历史流程实例变量表中。
监听Copilot工作流完成事件并回调
① 实现org.flowable.engine.delegate.ExecutionListener接口，在notify(DelegateExecution execution)中判断execution.getEventName().equals("end")；
② 从execution.getProcessInstanceId()提取唯一ID，查询GitHub Actions运行记录：GET /repos/{owner}/{repo}/actions/runs?status=success&per_page=1；
③ 匹配workflow_run.head_sha与流程变量commitSha，确认Copilot生成的代码已通过CI验证；
④ 调用GitHub Checks API更新Pull Request状态：PATCH /repos/{owner}/{repo}/check-runs/{check_run_id}，将conclusion设为success并填充output.title为“Copilot AI Review Completed”。
