Skip to content

Commit d11bb13

Browse files
authored
docs(skills): document auto-created GitHub Release after pipeline succeeds (#1403)
The official build pipeline now creates a published GitHub Release automatically on successful run (PR #1399's tooling change). Update both skills so contributors know to look for the release at /releases/tag/v<version> after their PR ships: - create-pr SKILL.md: Step 4 prompt now mentions the auto-release URL and what to do if it doesn't appear (token scope / SSO check). - pac-cli-update SKILL.md: Step 9 final summary now includes the same guidance.
1 parent 5d22343 commit d11bb13

2 files changed

Lines changed: 33 additions & 0 deletions

File tree

.claude/skills/create-pr/SKILL.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -162,4 +162,14 @@ When queuing, set these pipeline variables:
162162
- AZ_DevOps_Read_PAT PAT to read from the AzDO DPX-Tools-Upstream feed
163163
- isEsrpEnabled true
164164
- PUBLISH_TO_MARKETPLACE true
165+
166+
When the pipeline succeeds, the build automatically:
167+
- Pushes a v<version> tag (e.g. v2.0.147) to the repo
168+
- Signs and publishes the VSIXs to the VS Marketplace
169+
- Creates a published GitHub Release with all 4 signed VSIXs attached, marked Latest
170+
171+
Verify the release at:
172+
https://github.com/microsoft/powerplatform-build-tools/releases/tag/v<version>
173+
174+
If no GitHub Release shows up after a successful build, inspect the "Create GitHub release with VSIX assets" task in the ADO build logs — most likely cause is the GITHUB_TOKEN pipeline variable being missing, expired, or lacking `repo` scope / SSO authorization for `microsoft`.
165175
```

.claude/skills/pac-cli-update/SKILL.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -204,6 +204,29 @@ Print:
204204
4. **Release PR:** URL
205205
5. **Restore verified:** yes / no (did `gulp restore` download the new pac CLI successfully?)
206206

207+
Then tell the user what to do after both PRs merge:
208+
209+
```
210+
Once both PRs merge, queue the official build to sign, publish to Marketplace, and create the GitHub Release:
211+
https://dev.azure.com/dynamicscrm/OneCRM/_build?definitionId=21491
212+
213+
Pipeline variables to set when queuing:
214+
- GITHUB_TOKEN GitHub PAT (repo scope, SSO enabled for 'microsoft' org)
215+
- AZ_DevOps_Read_PAT PAT to read from the AzDO DPX-Tools-Upstream feed
216+
- isEsrpEnabled true
217+
- PUBLISH_TO_MARKETPLACE true
218+
219+
On success, a published GitHub Release will appear automatically at:
220+
https://github.com/microsoft/powerplatform-build-tools/releases/tag/v<new-extension-version>
221+
222+
That release will include:
223+
- All 4 signed VSIXs (LIVE, BETA, DEV, EXPERIMENTAL) as assets
224+
- Release notes extracted from `extension/overview.md`'s `{{NextReleaseVersion}}:` block
225+
- Latest tag
226+
227+
If the release does not appear, check the "Create GitHub release with VSIX assets" task in the build log — usually GITHUB_TOKEN scope or SSO authorization is the issue.
228+
```
229+
207230
---
208231

209232
## Hard rules

0 commit comments

Comments
 (0)