CircleCI 流水线管理器

触发流水线的三种典型痛点

• 手动点击：在 Web 界面里逐个点开项目再触发，操作路径长、重复成本高。
• 参数散落：环境变量、上下文和缓存键分散在 UI、config.yml 和 shell 脚本里，很难一次性核对。
• 状态不可见：单次触发后如果失败，缺少统一的日志、工作区与产物入口，排查链路容易断。

技能如何工作

• 调用 CircleCI v2 API 发起 pipeline 触发，把触发动作收敛到一条可脚本化路径。
• 解析项目根目录的 config.yml，识别其中声明的 orbs 与 workflow 结构，并按 workflow 名称定向触发，避免全量跑。
• 在请求体中注入 parameters，区分必填与可选键，用 contexts 与持久化 workspace 承载密钥、令牌和构建产物。
• 将动态配置拆成 default 与 overrides 两段写入，使本地调试与生产执行共用一份参数骨架。

适用边界与注意点

• 需要有效的 CircleCI token 与目标项目的写入权限，纯只读 token 无法完成触发。
• workflow 名称必须与 config.yml 中声明一致；改名后旧触发脚本不会自动跟随。
• API 参数 schema 与 UI 表单并不完全对齐，部分高级键需要以 JSON 直接表达。
• 工作区持久化依赖项目侧的存储配置，删除工作区后历史构建产物不可恢复。