mcpField
H
heyeddi-ci-runners

heyeddi-ci-runners

github.com/heyeddi-com云与 DevOps051 次安装1 天前更新
代码仓库

关于 heyeddi-ci-runners

heyeddi-ci-runners 是配置 HeyEddi CI 运行器路径的技能。它指导团队选择在 Spot 上运行的 GitHub Actions 或经明确同意的封闭式流水线，并要求有证据才能声称任务已运行。

主要功能

  1. 01指导配置 Spot 上的 GHA 或封闭式流水线
  2. 02避免不同运行路径重复执行 CI
  3. 03检查仓库中有依据的命令
  4. 04封闭式计费运行需明确同意
  5. 05核验运行器执行声明的证据

适用场景

  1. 01将现有 GitHub Actions 任务路由到 Spot
  2. 02为 GHA 较少的仓库配置封闭式任务
  3. 03报告 CI 执行前核验相关证据

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/heyeddi-com/heyeddi-skills --skill heyeddi-ci-runners

安装后在 Claude Code 中输入/heyeddi-ci-runners确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

manifest.json
context/
ANTI_PATTERNS.md
EXAMPLES.md
PROSE_ANTI_SLOP.md
VOCABULARY.md
reference/
runners.md
scripts/
_skill_cli.py
assert_runners_claims.py
assert_runners_placeholder.py
inspect_repo.py
load_policy_contract.py

详细介绍

HeyEddi CI 运行器

Spot 已上线。帮助用户接入正确的运行器路径，绝不编造执行情况。

两种作业类型（不要合并）

类型位置检查名称使用时机
GHA on Spot.github/workflows/*.yml + 工作区 gha_spot_mode同名工作流 Check已有 Actions 的仓库（默认）
密封的 pipeline:eddi-ci.yaml 中的 pipeline: 作业HeyEddi Runner: {job_id}没有（或只有极少量）GHA，或需要专门的密封检查

**黄金规则：**不要在 GHA 和 pipeline: 中重复相同的测试或构建。优先选择 GHA + Spot 路由；保留 pipeline: {}。

产品文档：https://ci.heyeddi.com/docs · hub 镜像：参见 reference/runners.md。

优先使用 GHA overflow / always

  1. 确认存在 .github/workflows/（或用户希望使用基于 Actions 的 CI）。
  2. 确保每个 Linux 作业都使用：
runs-on: ${{ vars.HEYEDDI_RUNS_ON || 'ubuntu-latest' }}
  1. 告知用户在 ci.heyeddi.com 上将工作区的 Runners 模式设为：
    • overflow — 优先使用 GitHub 分钟数；耗尽后使用 Spot JIT
    • always — 从首次运行起就在 Spot 上运行 Linux 作业
    • off — 仅使用托管运行器
  2. 将 eddi-ci.yaml 保持为仅 Reviewer，并设置 pipeline: {}（使用 @heyeddi-ci-config）。
  3. 限制：仅限 Linux；私有仓库；工作区需预付费/具备使用资格；平台紧急停止开关由运维负责。Overflow 的可靠性仍可能存在缺口——不要承诺“始终有效”。

密封的 pipeline:（高级 / 无 GHA）

  1. load_policy_contract — 仅使用动态配置项。
  2. inspect_repo — 使用有证据支持的命令和路径前缀；绝不编造 pytest / npm test。
  3. 明确征得用户同意（运行器时间需付费）。
  4. 编写 argv 安全的 run（不使用 shell 运算符、sudo、curl、wget），使用目录中的 image，并在可能时设置 filter.paths。
  5. 工作区具备使用资格且 Spot 环境处于运行状态时，作业会在 Spot 上运行；并创建 HeyEddi Runner: {job_id} Checks。

创建/更新的决策关卡优先使用 @heyeddi-ci-config。

证据规则（强制）

  • 作业可以在具备使用资格且 Spot 基础设施可用时运行。
  • 只有在有 Check / Spot 证据（HeyEddi Runner: …、工作流 Check 结论、Ops/日志）时，才能说作业确实运行了。
  • YAML lint ≠ 已执行。无法确认时 → 如实说明，并使用 @heyeddi-ci-fails。
  • 任何暗示已执行的总结之前，都要运行：
assert_runners_claims --check --agent-text "<your summary>"

Pipeline

load_policy_contract
inspect_repo
→ choose GHA-first vs sealed pipeline (never both for the same CI)
→ wire HEYEDDI_RUNS_ON hook and/or author pipeline: jobs
assert_runners_claims --check --agent-text "<your summary>"

工具

工具用途
load_policy_contract动态配置项 / 指南
inspect_repo语言 + 有证据支持的命令
assert_runners_claims阻止无依据的执行声明

安全

  • YAML 中绝不放置机密
  • 绝不编造测试命令
  • 绝不使用 auto_merge
  • 未经授权合并，绝不合并
  • 绝不声称 AI 与运行器的时间线存在关联（即将推出）

评论

支持 Markdown