From c78380e7ecdb7077149da216b39c5ce43599d3a9 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sat, 25 Apr 2026 10:57:28 +0000 Subject: [PATCH] docs(instructions): add checkout and env fields for import object form Documents the `checkout:` and `env:` fields introduced in v0.68.3 for import entries using the object form (`path:`/`uses:` + `with:`). Co-Authored-By: Claude Sonnet 4.6 --- .github/aw/github-agentic-workflows.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/.github/aw/github-agentic-workflows.md b/.github/aw/github-agentic-workflows.md index fb6749f4370..3187d51d602 100644 --- a/.github/aw/github-agentic-workflows.md +++ b/.github/aw/github-agentic-workflows.md @@ -2223,7 +2223,7 @@ imports: --- ``` -**Object form with inputs** — Use `path:`/`uses:` + `with:`/`inputs:` to pass values to shared workflows that define an `import-schema:`: +**Object form with inputs** — Use `path:`/`uses:` + `with:`/`inputs:` to pass values to shared workflows that define an `import-schema:`. Optional `checkout:` and `env:` fields customize the import: ```yaml imports: @@ -2231,9 +2231,15 @@ imports: with: environment: staging max-issues: 3 + env: + MY_VAR: "value" # Optional: pass env vars into the imported workflow + checkout: main # Optional: ref to check out when this import is processed - uses: shared/security-notice.md # 'uses' is an alias for 'path' ``` +- `env:` - Environment variables passed into the imported workflow context (object). Use when a shared workflow relies on environment variables that must be supplied by the importing workflow. +- `checkout:` - Ref (branch, tag, or SHA) to check out when processing this import (string). Overrides the default checkout for this specific import entry. + Inside the imported workflow, access values via `${{ github.aw.import-inputs. }}`. ### Import File Structure