From d30c212029c05b767d99b5391c1dd4cee78ef336 Mon Sep 17 00:00:00 2001 From: Fahad Date: Thu, 21 Aug 2025 12:23:13 +0400 Subject: [PATCH] refactor: minor prompt tweaks --- tools/chat.py | 17 ++++++++--------- tools/shared/base_models.py | 29 ++++++++++++----------------- 2 files changed, 20 insertions(+), 26 deletions(-) diff --git a/tools/chat.py b/tools/chat.py index 5e2bb86..f521c70 100644 --- a/tools/chat.py +++ b/tools/chat.py @@ -22,16 +22,15 @@ from .simple.base import SimpleTool # Field descriptions matching the original Chat tool exactly CHAT_FIELD_DESCRIPTIONS = { "prompt": ( - "You MUST provide a thorough, expressive question or share an idea with as much context as possible. " - "IMPORTANT: When referring to code, use the files parameter to pass relevant files and only use the prompt to refer to " - "function / method names or very small code snippets if absolutely necessary to explain the issue. Do NOT " - "pass large code snippets in the prompt as this is exclusively reserved for descriptive text only. " - "Remember: you're talking to an assistant who has deep expertise and can provide nuanced insights. Include your " - "current thinking, specific challenges, background context, what you've already tried, and what " - "kind of response would be most helpful. The more context and detail you provide, the more " - "valuable and targeted the response will be." + "Provide a thorough, expressive question or idea with maximum context. Include your current thinking, specific " + "challenges, background context, what you've tried, and what kind of response would be most helpful. " + "The more context and detail you provide, the more valuable and targeted the response will be. " + "NOTE: You're talking to a thought-partner who has deep expertise and can provide nuanced insights. " + "IMPORTANT: When referring to code, use the files parameter to pass relevant file paths. Use this prompt for " + "function/method names or tiny code snippets if absolutely necessary to explain the issue and to refer to " + "code from the provided paths." ), - "files": "Optional files for context (must be FULL absolute paths to real files / folders - DO NOT SHORTEN)", + "files": "Absolute full-paths to existing files / folders for context. DO NOT SHORTEN.", "images": ( "Optional images for visual context. Useful for UI discussions, diagrams, visual problems, " "error screens, or architectural mockups. (must be FULL absolute paths to real files / folders - DO NOT SHORTEN - OR these can be bas64 data)" diff --git a/tools/shared/base_models.py b/tools/shared/base_models.py index 5715eb5..946bdb7 100644 --- a/tools/shared/base_models.py +++ b/tools/shared/base_models.py @@ -33,25 +33,20 @@ COMMON_FIELD_DESCRIPTIONS = { "max (100% of model max). Higher modes enable deeper reasoning at the cost of speed." ), "use_websearch": ( - "Enable web search for documentation, best practices, and current information. " - "When enabled, the model can request Claude to perform web searches and share results back " - "during conversations. Particularly useful for: brainstorming sessions, architectural design " - "discussions, exploring industry best practices, working with specific frameworks/technologies, " - "researching solutions to complex problems, or when current documentation and community insights " - "would enhance the analysis." + "Enable web search for documentation and current information. Model can request Claude to perform " + "searches during conversation. Useful for: architecture discussions, best practices, framework docs, " + "solution research, or when current information would enhance analysis." ), "continuation_id": ( - "Thread continuation ID for multi-turn conversations. When provided, the complete conversation " - "history is automatically embedded as context. Your response should build upon this history " - "without repeating previous analysis or instructions. Focus on providing only new insights, " - "additional findings, or answers to follow-up questions. Can be used across different tools." + "Thread continuation ID for multi-turn conversations. Automatically reuse the last continuation_id " + "when this appears to be a follow-up or related discussion (unless user explicitly provides a different ID). " + "When provided, the tool embeds complete conversation history as context. Your response should build upon this history " + "without repeating previous analysis. Focus on providing only new insights. Works across different tools." ), "images": ( - "Optional image(s) for visual context. Accepts absolute file paths or " - "base64 data URLs. Only provide when user explicitly mentions images. " - "When including images, please describe what you believe each image contains " - "to aid with contextual understanding. Useful for UI discussions, diagrams, " - "visual problems, error screens, architecture mockups, and visual analysis tasks." + "Optional images for visual context. MUST be absolute file paths or base64 data. " + "Only use when user mentions images. Describe what each image contains. " + "Useful for: UI, diagrams, error screens, mockups, visual analysis." ), "files": ("Optional files for context (must be FULL absolute paths to real files / folders - DO NOT SHORTEN)"), } @@ -61,10 +56,10 @@ WORKFLOW_FIELD_DESCRIPTIONS = { "step": "Current work step content and findings from your overall work", "step_number": "Current step number in the work sequence (starts at 1)", "total_steps": "Estimated total steps needed to complete the work", - "next_step_required": "Whether another work step is needed after this one", + "next_step_required": "Whether another work step is needed after this one. When false, aim to reduce total_steps to match step_number to avoid mismatch.", "findings": "Important findings, evidence and insights discovered in this step of the work", "files_checked": "List of files examined during this work step", - "relevant_files": "Files identified as relevant to the issue/goal", + "relevant_files": "Files identified as relevant to the issue/goal (must be FULL absolute paths to real files / folders - DO NOT SHORTEN)", "relevant_context": "Methods/functions identified as involved in the issue", "issues_found": "Issues identified with severity levels during work", "confidence": (