用途:帮助在 GitHub Actions 上搭建超出 CI 范围的自动化,替代人工重复操作。
主要能力:覆盖触发机制分类,包括 workflow_dispatch(手动、UI、gh workflow run、REST,需在默认分支,支持 Typed 输入如 environment、choice、boolean)、repository_dispatch(外部 POST,自定义 event_type 与 client_payload,仅默认分支)、schedule(UTC cron,最短 5 分钟,仓库约 60 天不活跃后停用,负载下延迟)、issue 与 issue_comment、pull_request、pull_request_target、workflow_run、merge_group、projects_v2_item、release、push、workflow_call。说明 fork PR 的“双工作流模式”:A 用 pull_request 跑不可信代码、无密钥、上传产物;B 用 workflow_run 在基上下文读取产物。区分可复用工作流(单位为一个或多个作业、自带 runner、显式 secrets、最多嵌套 4 层)与复合操作(步骤组、在调用者 runner 上、继承 step env、最多 10 层)。给出机器人自动化清单,如按路径打标签、陈旧 issue sweep、自动分配评审、发布草稿、自动合并 Dependabot 补丁、PR 大小检查等,推荐 actions/github-script 处理小逻辑。介绍 enable_pr_auto_merge、Dependabot 配置(含 github-actions 生态与分组)、并发控制与调试方法。
使用方式:通过 on 定义触发,workflow_dispatch 输入用 type: environment 或 choice 提供可用 UI;外部调用示例:gh api repos/OWNER/REPO/dispatches -f event_type=deploy_requested -F client_payload='{"env":"staging","sha":"abc123"}';可复用工作流用 jobs.<id>.uses;复合操作用 steps.uses。调试命令包括 gh run watch、gh run view --log-failed、仅重跑失败作业、用 ACTIONS_STEP_DEBUG 开启步骤调试;也可用 get_job_logs 的 failed_only。
限制与注意:client_payload 属不可信输入,禁止插入 run 块;pull_request_target 有密钥但不要检出 PR head;可复用工作流与第三方 action 应固定到提交 SHA(版本写注释),标签可变;默认分支不要 cancel-in-progress,部署工作流用共享 group 且 cancel-in-progress: false;不要自动合并大版本更新。
适用场景:机器人工作流、外部系统触发、定时清理、fork PR 的安全处理、板卡驱动自动化、依赖更新与发布流程。其他内容暂未提供。