[docs] Document Aspire skills bundle fallback in aspire agent init#1094
Open
aspire-repo-bot[bot] wants to merge 1 commit into
Open
[docs] Document Aspire skills bundle fallback in aspire agent init#1094aspire-repo-bot[bot] wants to merge 1 commit into
aspire-repo-bot[bot] wants to merge 1 commit into
Conversation
… init Document the best-effort skills bundle acquisition order (cache → GitHub release asset → embedded snapshot) introduced in microsoft/aspire#17537. The command now warns and skips bundle-backed skills instead of failing when all acquisition sources are unavailable. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
14 tasks
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the Aspire CLI docs to reflect the new best-effort behavior of aspire agent init when acquiring the Aspire skills bundle, including offline/air-gapped fallback behavior introduced in microsoft/aspire#17537.
Changes:
- Added a new “Aspire skills bundle acquisition” subsection describing the bundle resolution order (cache → GitHub release asset → embedded snapshot).
- Documented best-effort behavior when all sources fail (warn + skip only bundle-backed skills), including parity for
aspire new/aspire initchained flows.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
|
||
| ### Aspire skills bundle acquisition | ||
|
|
||
| When installing the Aspire skill, the command resolves the skills bundle using the following priority order: |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documents changes from microsoft/aspire#17537 by
@IEvangelist.Targeting
release/13.4— the latest release branch onmicrosoft/aspire.dev— becauserelease/13.5(from the source PR milestone13.5) does not exist there.Why this PR is needed
PR microsoft/aspire#17537 changed
aspire agent init(and the chainedaspire new/aspire initflow) to use best-effort behavior when acquiring the Aspire skills bundle. Instead of failing with a non-zero exit code when the GitHub release asset is unavailable, the command now falls back to an embedded snapshot and, if that also fails, warns and skips only the bundle-backed skills. The existing docs described the command as always downloading skills from GitHub, leaving users in restricted-network or air-gapped environments without guidance.Changes made
Updated
src/frontend/src/content/docs/reference/cli/commands/aspire-agent-init.mdx:aspire newandaspire initchained flows follow the same behavior.