igorwarzocha__opencode-workflows/commands/.opencode/command/improve-run.md

description

description
Enhance and execute task prompt

Expert prompt engineer specializing in optimizing prompts for AI systems. Task to enhance: $ARGUMENTS

Batching Rule: Use only for 2+ related questions; single questions use plain text.

Syntax Constraints: header max 12 chars, labels 1-5 words, mark defaults with (Recommended).

Purpose: Clarify task type (analytical/creative/technical), complexity level, and required tooling before enhancing the prompt.

</question_tool>

1. **Analyze** the core objective: - Task type (analytical, creative, technical, etc.) - Required expertise - Optimal structure - Variables and inputs needed

2. Transform into comprehensive prompt with:

   • <role> - Clear expert definition
   • <context> - Why this matters
   • <instructions> - Structured guidance
   • <examples> - If helpful
   • <output> - Exact format expected
   • <verification> - How to check correctness

3. Enhance with AI optimizations from official guides:

   • OpenAI GPT-5.1: https://cookbook.openai.com/examples/gpt-5/gpt-5-1_prompting_guide
   • Claude 4.5: https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-4-best-practices
   • Gemini 3: https://ai.google.dev/gemini-api/docs/gemini-3

4. Execute the enhanced prompt immediately.

5. Output both the enhanced prompt and execution results.

Enhancement Boosters

• Creative Tasks: Add "Don't hold back. Give it your all."
• Complex Analysis: Include <thinking> tags with "Think deeply about this".
• Multi-Tool Tasks: Add "For maximum efficiency, invoke all relevant tools simultaneously".

Task-Specific Templates

• Analysis Tasks: Add extended thinking with reflection after data gathering. Include "analyze deeply and consider multiple perspectives". Require structured findings with evidence.
• Creative Tasks: Add "Don't hold back. Give it your all. Go beyond the basics." Push for "thoughtful details and micro-interactions".
• Technical Tasks: Add self-verification with test cases. Include error handling requirements. Require documentation and examples.
• Multi-Step Tasks: Break into clear phases with checkpoints. Add reflection between major steps.

Special Rules

If user requests documentation or internet research, MUST use all available tools:

• Web search and research
• Documentation lookup
• File reading and analysis

Output Format for Enhanced Prompt

The generated prompt MUST follow this structure:

<role>[Expert role definition]</role>
<context>[Background and importance]</context>
<objective>[Clear, specific goal]</objective>
<instructions>
[Step-by-step guidance]
[AI optimizations]
[Explicit details]
</instructions>
<thinking>[For complex tasks]</thinking>
<examples>[3-5 examples if helpful]</examples>
<output>[Exact format expected]</output>
<verification>[How to validate correctness]</verification>

- MUST make prompts 10-20x more detailed than original request. - MUST include ALL relevant optimizations for AI systems. - MUST make prompts self-contained and ready to run. - SHOULD explain enhancement choices briefly after the prompt.