HeyEddi CI Guide
Short reference for agents and humans working with HeyEddi CI. Depth lives in reference/commands.md.
Skills in this pack
| Skill | Job |
|---|---|
@heyeddi-ci-config |
Author eddi-ci.yaml from the live policy contract |
@heyeddi-pr-respond |
Address all PR review feedback (human + HeyEddi CI) |
@heyeddi-ci-fails |
Diagnose and fix failing Checks (default on PR work; /heyeddi fails for App path) |
@heyeddi-ci-runners |
Spot: GHA overflow/always + sealed pipeline: (evidence before claims) |
@heyeddi-ci-guide |
This skill |
Human PR review stays on @heyeddi-pr-review / @heyeddi-pr-respond.
Default PR workflow
On any PR work (open PR, PR branch, review request):
- Always run
@heyeddi-ci-failsfirst — fetch failing Checks, diagnose, fix actionable failures, commit + push - Always run
@heyeddi-pr-respond— fix all review items, commit + push, post every reply in-thread - Never ask "do you want me to fix?" or "should I comment on threads?" — that is always the default
- Never skip CI because the user did not mention it
- Only merge requires authorize merge in the current turn
Commands (PR comments)
See reference/commands.md. Common:
/heyeddi review/again/check/deep— review passes/heyeddi ci//heyeddi fails— failed Checks analysis (billable path)/heyeddi ask …//heyeddi debate …— Q&A on findings- Reply on an inline HeyEddi finding — debate when parent looks like HeyEddi
Auth matrix
| Action | Allowed when |
|---|---|
| Commit + push (PR workflow) | Automatic during @heyeddi-ci-fails / @heyeddi-pr-respond — do not ask |
Merge (gh pr merge) |
User says authorize merge in the current turn |
auto_merge in YAML |
Never (schema rejects / forbidden) |
Billable knobs (on_ci_failure, sealed runners) |
Explicit opt-in |
Feedback (real paths only)
There is no structured FP/telemetry API yet.
- Disagree on a finding:
/heyeddi ask/ debate on that thread - Product or skill feedback:
support@heyeddi.com(skills may draft a mail body)
Runners status
Spot is shipped:
- Prefer GHA + workspace Runners mode (
overflow/always) withruns-on: ${{ vars.HEYEDDI_RUNS_ON || 'ubuntu-latest' }} - Sealed
pipeline:jobs postHeyEddi Runner: {job_id}Checks for entitled workspaces - Claim a job ran only with Check/Spot evidence — see
@heyeddi-ci-runners
Install
npx skills add HeyEddi-com/heyeddi-skills -a cursor -y --skill '*'
# or CI skills by name / Marketplace plugin heyeddi-ci-skills
# or Team Marketplace plugin heyeddi-ci-skills
Tools
None (tools: []). This skill is documentation only.
Notes
- Living knobs: always
@heyeddi-ci-config→load_policy_contract - Ephemeral
.heyeddi/docs/pr-*scratch: never commit