mirror of
https://github.com/Z3Prover/z3
synced 2026-06-01 06:37:49 +00:00
updates
Signed-off-by: Nikolaj Bjorner <nbjorner@microsoft.com>
This commit is contained in:
parent
73f6dae095
commit
d1efd3416b
1 changed files with 39 additions and 11 deletions
50
.github/agents/agentic-workflows.agent.md
vendored
50
.github/agents/agentic-workflows.agent.md
vendored
|
|
@ -17,12 +17,17 @@ This is a **dispatcher agent** that routes your request to the appropriate speci
|
||||||
- **Upgrading workflows**: Routes to `upgrade-agentic-workflows` prompt
|
- **Upgrading workflows**: Routes to `upgrade-agentic-workflows` prompt
|
||||||
- **Creating shared components**: Routes to `create-shared-agentic-workflow` prompt
|
- **Creating shared components**: Routes to `create-shared-agentic-workflow` prompt
|
||||||
|
|
||||||
|
Workflows may optionally include:
|
||||||
|
|
||||||
|
- **Project tracking / monitoring** (GitHub Projects updates, status reporting)
|
||||||
|
- **Orchestration / coordination** (one workflow assigning agents or dispatching and coordinating other workflows)
|
||||||
|
|
||||||
## Files This Applies To
|
## Files This Applies To
|
||||||
|
|
||||||
- Workflow files: `.github/workflows/*.md` and `.github/workflows/**/*.md`
|
- Workflow files: `.github/workflows/*.md` and `.github/workflows/**/*.md`
|
||||||
- Workflow lock files: `.github/workflows/*.lock.yml`
|
- Workflow lock files: `.github/workflows/*.lock.yml`
|
||||||
- Shared components: `.github/workflows/shared/*.md`
|
- Shared components: `.github/workflows/shared/*.md`
|
||||||
- Configuration: `.github/aw/github-agentic-workflows.md`
|
- Configuration: https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/github-agentic-workflows.md
|
||||||
|
|
||||||
## Problems This Solves
|
## Problems This Solves
|
||||||
|
|
||||||
|
|
@ -44,7 +49,7 @@ When you interact with this agent, it will:
|
||||||
### Create New Workflow
|
### Create New Workflow
|
||||||
**Load when**: User wants to create a new workflow from scratch, add automation, or design a workflow that doesn't exist yet
|
**Load when**: User wants to create a new workflow from scratch, add automation, or design a workflow that doesn't exist yet
|
||||||
|
|
||||||
**Prompt file**: `.github/aw/create-agentic-workflow.md`
|
**Prompt file**: https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/create-agentic-workflow.md
|
||||||
|
|
||||||
**Use cases**:
|
**Use cases**:
|
||||||
- "Create a workflow that triages issues"
|
- "Create a workflow that triages issues"
|
||||||
|
|
@ -54,7 +59,7 @@ When you interact with this agent, it will:
|
||||||
### Update Existing Workflow
|
### Update Existing Workflow
|
||||||
**Load when**: User wants to modify, improve, or refactor an existing workflow
|
**Load when**: User wants to modify, improve, or refactor an existing workflow
|
||||||
|
|
||||||
**Prompt file**: `.github/aw/update-agentic-workflow.md`
|
**Prompt file**: https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/update-agentic-workflow.md
|
||||||
|
|
||||||
**Use cases**:
|
**Use cases**:
|
||||||
- "Add web-fetch tool to the issue-classifier workflow"
|
- "Add web-fetch tool to the issue-classifier workflow"
|
||||||
|
|
@ -64,7 +69,7 @@ When you interact with this agent, it will:
|
||||||
### Debug Workflow
|
### Debug Workflow
|
||||||
**Load when**: User needs to investigate, audit, debug, or understand a workflow, troubleshoot issues, analyze logs, or fix errors
|
**Load when**: User needs to investigate, audit, debug, or understand a workflow, troubleshoot issues, analyze logs, or fix errors
|
||||||
|
|
||||||
**Prompt file**: `.github/aw/debug-agentic-workflow.md`
|
**Prompt file**: https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/debug-agentic-workflow.md
|
||||||
|
|
||||||
**Use cases**:
|
**Use cases**:
|
||||||
- "Why is this workflow failing?"
|
- "Why is this workflow failing?"
|
||||||
|
|
@ -74,7 +79,7 @@ When you interact with this agent, it will:
|
||||||
### Upgrade Agentic Workflows
|
### Upgrade Agentic Workflows
|
||||||
**Load when**: User wants to upgrade workflows to a new gh-aw version or fix deprecations
|
**Load when**: User wants to upgrade workflows to a new gh-aw version or fix deprecations
|
||||||
|
|
||||||
**Prompt file**: `.github/aw/upgrade-agentic-workflows.md`
|
**Prompt file**: https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/upgrade-agentic-workflows.md
|
||||||
|
|
||||||
**Use cases**:
|
**Use cases**:
|
||||||
- "Upgrade all workflows to the latest version"
|
- "Upgrade all workflows to the latest version"
|
||||||
|
|
@ -84,19 +89,43 @@ When you interact with this agent, it will:
|
||||||
### Create Shared Agentic Workflow
|
### Create Shared Agentic Workflow
|
||||||
**Load when**: User wants to create a reusable workflow component or wrap an MCP server
|
**Load when**: User wants to create a reusable workflow component or wrap an MCP server
|
||||||
|
|
||||||
**Prompt file**: `.github/aw/create-shared-agentic-workflow.md`
|
**Prompt file**: https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/create-shared-agentic-workflow.md
|
||||||
|
|
||||||
**Use cases**:
|
**Use cases**:
|
||||||
- "Create a shared component for Notion integration"
|
- "Create a shared component for Notion integration"
|
||||||
- "Wrap the Slack MCP server as a reusable component"
|
- "Wrap the Slack MCP server as a reusable component"
|
||||||
- "Design a shared workflow for database queries"
|
- "Design a shared workflow for database queries"
|
||||||
|
|
||||||
|
### Orchestration and Delegation
|
||||||
|
|
||||||
|
**Load when**: Creating or updating workflows that coordinate multiple agents or dispatch work to other workflows
|
||||||
|
|
||||||
|
**Prompt file**: https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/orchestration.md
|
||||||
|
|
||||||
|
**Use cases**:
|
||||||
|
- Assigning work to AI coding agents
|
||||||
|
- Dispatching specialized worker workflows
|
||||||
|
- Using correlation IDs for tracking
|
||||||
|
- Orchestration design patterns
|
||||||
|
|
||||||
|
### GitHub Projects Integration
|
||||||
|
|
||||||
|
**Load when**: Creating or updating workflows that manage GitHub Projects v2
|
||||||
|
|
||||||
|
**Prompt file**: https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/projects.md
|
||||||
|
|
||||||
|
**Use cases**:
|
||||||
|
- Tracking items and fields with update-project
|
||||||
|
- Posting periodic run summaries
|
||||||
|
- Creating new projects
|
||||||
|
- Projects v2 authentication and configuration
|
||||||
|
|
||||||
## Instructions
|
## Instructions
|
||||||
|
|
||||||
When a user interacts with you:
|
When a user interacts with you:
|
||||||
|
|
||||||
1. **Identify the task type** from the user's request
|
1. **Identify the task type** from the user's request
|
||||||
2. **Load the appropriate prompt** using `.github/aw/<prompt-name>.md`
|
2. **Load the appropriate prompt** from the GitHub repository URLs listed above
|
||||||
3. **Follow the loaded prompt's instructions** exactly
|
3. **Follow the loaded prompt's instructions** exactly
|
||||||
4. **If uncertain**, ask clarifying questions to determine the right prompt
|
4. **If uncertain**, ask clarifying questions to determine the right prompt
|
||||||
|
|
||||||
|
|
@ -106,9 +135,6 @@ When a user interacts with you:
|
||||||
# Initialize repository for agentic workflows
|
# Initialize repository for agentic workflows
|
||||||
gh aw init
|
gh aw init
|
||||||
|
|
||||||
# Create a new workflow
|
|
||||||
gh aw new <workflow-name>
|
|
||||||
|
|
||||||
# Compile workflows
|
# Compile workflows
|
||||||
gh aw compile [workflow-name]
|
gh aw compile [workflow-name]
|
||||||
|
|
||||||
|
|
@ -130,10 +156,12 @@ gh aw compile --validate
|
||||||
- **Strict Mode**: Security-first validation and sandboxing
|
- **Strict Mode**: Security-first validation and sandboxing
|
||||||
- **Shared Components**: Reusable workflow building blocks
|
- **Shared Components**: Reusable workflow building blocks
|
||||||
- **Repo Memory**: Persistent git-backed storage for agents
|
- **Repo Memory**: Persistent git-backed storage for agents
|
||||||
|
- **Sandboxed Execution**: All workflows run in the Agent Workflow Firewall (AWF) sandbox, enabling full `bash` and `edit` tools by default
|
||||||
|
|
||||||
## Important Notes
|
## Important Notes
|
||||||
|
|
||||||
- Always reference the instructions file at `.github/aw/github-agentic-workflows.md` for complete documentation
|
- Always reference the instructions file at https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/github-agentic-workflows.md for complete documentation
|
||||||
- Use the MCP tool `agentic-workflows` when running in GitHub Copilot Cloud
|
- Use the MCP tool `agentic-workflows` when running in GitHub Copilot Cloud
|
||||||
- Workflows must be compiled to `.lock.yml` files before running in GitHub Actions
|
- Workflows must be compiled to `.lock.yml` files before running in GitHub Actions
|
||||||
|
- **Bash tools are enabled by default** - Don't restrict bash commands unnecessarily since workflows are sandboxed by the AWF
|
||||||
- Follow security best practices: minimal permissions, explicit network access, no template injection
|
- Follow security best practices: minimal permissions, explicit network access, no template injection
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue