Skip to content

⚡ Quick Actions

Quick Actions provide command-based interactions with DAIV directly from issues and merge/pull requests. They are useful for common tasks and information requests.

Overview

Quick Actions are triggered by mentioning DAIV with specific commands in issue or merge/pull request comments.

How Quick Actions Work

Command Format: @<daiv-username> /<action> [arguments]

Supported Scopes:

  • Issues: Available in issue comments and discussions
  • Merge/Pull Requests: Available in merge/pull request comments and discussions

Command Parsing:

Quick Actions use shell-like parsing with support for:

  • Simple commands: @daiv /help
  • Commands with arguments: @daiv /approve-plan "some argument", @daiv /revise-plan "some argument"
  • Case-insensitive: @DAIV /HELP works the same as @daiv /help

Workflow

graph TD
    A["👤 User"] --> B["💬 Comments with @daiv<br/>(e.g., '@daiv /help')"]
    B --> C["🔔 Comment Webhook"]
    C --> D["📝 Quick Action Parser<br/>(extracts command and args)"]
    D --> E["📋 Registry Lookup<br/>(finds matching action)"]

    E --> F["✅ Action Found?"]
    F -->|Yes| G["⚡ Execute Action"]
    F -->|No| H["❌ Unknown Action Error"]

    G --> I["🔍 Validate Scope<br/>(Issue vs Merge/Pull Request)"]
    I --> J["🛠️ Execute Specific Logic"]

    J --> K["📖 Help Action<br/>(show available commands)"]
    J --> L["📋 Plan Action<br/>(regenerate/approve plan)"]
    J --> M["🔧 Pipeline Action<br/>(repair failed jobs)"]

    K --> N["💬 Posts Help Message"]
    L --> O["🔄 Triggers Plan Workflow"]
    M --> P["🚦 Triggers Pipeline Repair"]

    H --> Q["💬 Posts Error Message<br/>(suggests valid actions)"]

    style B fill:#e1f5fe
    style E fill:#fff3e0
    style G fill:#e8f5e8
    style H fill:#ffebee

Basic Usage

  1. Navigate to any issue or merge/pull request
  2. Add a comment mentioning DAIV with the desired action
  3. Submit the comment
  4. DAIV responds with the action result

Available Quick Actions

🆘 Help Action

Command: /help

Purpose: Displays all available Quick Actions for the current scope (issue or merge/pull request).

Scopes: Issues, Merge/Pull Requests

Example:

Text Only
1
@daiv /help

Response: DAIV replies with a formatted list of all available Quick Actions and their descriptions.

📋 Approve Plan Action

Command: /approve-plan

Purpose: Run or launch the current plan for the issue

Scopes: Issues only

Usage: Leave a comment to approve and execute the current plan

Example:

Text Only
1
@daiv /approve-plan

📋 Revise Plan Action

Command: /revise-plan

Purpose: Discard current plan and create a new one from scratch

Scopes: Issues only

Usage: Leave a comment on the issue to reset and regenerate the plan

Example:

Text Only
1
@daiv /revise-plan

Troubleshooting

Common Issues

Action not recognized:

  • Check that the action supports the current scope (issue vs merge/pull request)
  • Ensure proper spelling and case (actions are case-insensitive)
  • Verify command syntax (e.g., /approve-plan not /plan-execute)

No response from DAIV:

  • Confirm DAIV has access to the repository
  • Check that webhooks are properly configured
  • Verify the bot username is correct in the mention

Permission errors:

  • Ensure DAIV has sufficient repository permissions
  • Confirm the user triggering the action has appropriate access levels

Pipeline action issues:

  • Ensure the pipeline is in "failed" status
  • Check that failed jobs have script_failure as the failure reason
  • Verify jobs are not marked as allow_failure

Plan action issues:

  • Ensure you're commenting on an issue (not merge/pull request)
  • Check if there's an existing plan to execute or revise

Debug Information

Quick Actions log detailed information for troubleshooting:

  • Command parsing results
  • Registry lookup attempts
  • Execution success/failure
  • Error details and stack traces

Examples

Getting Help

Text Only
1
@daiv /help

Response:

Text Only
1
2
3
4
5
6
### 🤖 DAIV Quick-Actions
Comment one of the commands below on this issue to trigger the bot:

- `@daiv /help` - Shows the help message with the available quick actions.
- `@daiv /approve-plan` - Run or launch the current plan.
- `@daiv /revise-plan` - Discard current plan and create a new one from scratch.

Extension and Development

Adding New Actions

  1. Create new action class in automation/quick_actions/actions/
  2. Implement required methods execute_action and actions
  3. Decorate with @quick_action specifying command and scopes
  4. Import in the actions module
  5. Test the action in development environment

Best Practices

  • Keep actions simple: Quick Actions should execute immediately
  • Provide clear descriptions: Help users understand what each action does
  • Handle errors gracefully: Post user-friendly error messages
  • Use appropriate scopes: Only enable actions where they make sense
  • Follow naming conventions: Use clear, descriptive command names