Skip to content

Clarified limitations of copilot-setup-steps concerning use of reusable workflows#44494

Open
KubaZ wants to merge 1 commit into
github:mainfrom
KubaZ:patch-2
Open

Clarified limitations of copilot-setup-steps concerning use of reusable workflows#44494
KubaZ wants to merge 1 commit into
github:mainfrom
KubaZ:patch-2

Conversation

@KubaZ
Copy link
Copy Markdown

@KubaZ KubaZ commented May 29, 2026

Why:

Closes: #44493

What's being changed (if available, include any code snippets, screenshots, or gifs):

Check off the following:

  • A subject matter expert (SME) has reviewed the technical accuracy of the content in this PR. In most cases, the author can be the SME. Open source contributions may require an SME review from GitHub staff.
  • The changes in this PR meet the docs fundamentals that are required for all content.
  • All CI checks are passing and the changes look good in the review environment.

…able workflow

Clarified limitations of `copilot-setup-steps` concerning use of reusable workflow
Copilot AI review requested due to automatic review settings May 29, 2026 13:30
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds a documentation note clarifying that the copilot-setup-steps job does not support reusable workflows via uses, and suggests alternatives.

Changes:

  • Inserts a NOTE callout in the customize-the-agent-environment doc explaining the limitation and recommending inline steps or composite actions.

@github-actions
Copy link
Copy Markdown
Contributor

How to review these changes 👓

Thank you for your contribution. To review these changes, choose one of the following options:

A Hubber will need to deploy your changes internally to review.

Table of review links

Note: Please update the URL for your staging server or codespace.

The table shows the files in the content directory that were changed in this pull request. This helps you review your changes on a staging server. Changes to the data directory are not included in this table.

Source Review Production What Changed
copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/customize-the-agent-environment.md fpt
ghec
fpt
ghec

Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server

🤖 This comment is automatically generated.

@github-actions github-actions Bot added the triage Do not begin working on this issue until triaged by the team label May 29, 2026
Copy link
Copy Markdown

@raffryn22 raffryn22 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For more information on these options, see [AUTOTITLE](/actions/writing-workflows/workflow-syntax-for-github-actions#jobs).

> [!NOTE]
> The `copilot-setup-steps` job does not support calling reusable workflows with `uses`. Define setup logic directly in the job's `steps` instead or extract shared setup into a composite action and reference it within a step. For more information, see [AUTOTITLE](/actions/sharing-automations/creating-actions/creating-a-composite-action).
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> The `copilot-setup-steps` job does not support calling reusable workflows with `uses`. Define setup logic directly in the job's `steps` instead or extract shared setup into a composite action and reference it within a step. For more information, see [AUTOTITLE](/actions/sharing-automations/creating-actions/creating-a-composite-action).
Any value that is set for the `fetch-depth` option of the `actions/checkout` action will be overridden to allow the agent to rollback commits upon request, while mitigating security risks. For more information, see [`actions/checkout/README.md`](https://github.com/actions/checkout/blob/main/README.md).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fetch-depth

Comment on lines +96 to +97
> The `copilot-setup-steps` job does not support calling reusable workflows with `uses`. Define setup logic directly in the job's `steps` instead or extract shared setup into a composite action and reference it within a step. For more information, see [AUTOTITLE](/actions/sharing-automations/creating-actions/creating-a-composite-action).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> The `copilot-setup-steps` job does not support calling reusable workflows with `uses`. Define setup logic directly in the job's `steps` instead or extract shared setup into a composite action and reference it within a step. For more information, see [AUTOTITLE](/actions/sharing-automations/creating-actions/creating-a-composite-action).
Any value that is set for the `fetch-depth` option of the `actions/checkout` action will be overridden to allow the agent to rollback commits upon request, while mitigating security risks. For more information, see [`actions/checkout/README.md`](https://github.com/actions/checkout/blob/main/README.md).

@surya000111222078-sys
Copy link
Copy Markdown

075 533 6081

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

triage Do not begin working on this issue until triaged by the team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Clarify limitations of copilot-setup-steps concerning call of reusable workflows

4 participants