docs(aw): add "Creating Command Workflows" section to create-agentic-workflow.md#21410
Merged
docs(aw): add "Creating Command Workflows" section to create-agentic-workflow.md#21410
Conversation
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Update create-agent-workflows.md with command creation section
docs(aw): add "Creating Command Workflows" section to create-agentic-workflow.md
Mar 17, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
Adds guidance for authoring on-demand “command” agentic workflows so workflow creators can choose the right trigger pattern and implement it correctly.
Changes:
- Added a new “Creating Command Workflows” section documenting
slash_commandvslabel_command, including tradeoffs, recommendations, and examples. - Added a comparison table and documented an OR-trigger pattern combining both triggers.
- Updated existing guidance to reference label commands in the interactive prompt and Issue Form Mode trigger selection.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
You can also share your feedback on Copilot code review. Take the survey.
| label_command: deploy | ||
| permissions: | ||
| contents: read | ||
| pull-requests: write # Required for automatic label removal |
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.
The workflow creator agent lacked guidance on how to build on-demand "command" workflows, leaving it without a clear recommendation between the two supported approaches.
Changes
New
## Creating Command Workflowssection in.github/aw/create-agentic-workflow.mdcovering both triggers with tradeoffs, when-to-recommend guidance, permission requirements, and working examples:slash_command— user types/commandin a comment; flexible, composable, accepts context via comment body, less discoverablelabel_command— user applies a label; auto-removed after activation, visible in GitHub UI sidebar, no argument passingComparison table for at-a-glance decision making:
slash_commandlabel_command/commandas first word of a commentCombining both — documents the
slash_command+label_commandOR-trigger pattern so workflows can be reached via either mechanismCross-references updated — Issue Form Mode Step 2 trigger list gains an "On-demand commands" entry pointing to the new section; "Starting the conversation" clarifying question updated to mention label commands
Original prompt
💬 Send tasks to Copilot coding agent from Slack and Teams to turn conversations into code. Copilot posts an update in your thread when it's finished.