CarrotContext has 9 tools with basic schemas and descriptions, but significant quality gaps limit production readiness. All tools have descriptions (positive), but most are under 100 chars and lack actionable context for LLM selection. Parameter descriptions are minimal or missing context about constraints, formats, and dependencies. No output schemas documented. Error handling returns plain strings without recovery guidance. Tool names follow verb_noun convention (good), but descriptions don't explain WHEN to use each tool or what distinguishes similar operations (e.g., get_knowledge_detail vs read_file_content). No tool annotations (readOnlyHint, destructiveHint) despite clear read/write semantics. Permission checks exist server-side (good security), but error messages are generic Chinese strings that don't guide LLM recovery.

• Add output schemas to all tools. E.g., list_knowledge_base should return {type: 'array', items: {type: 'object', properties: {id: string, name: string, description: string, tags: array}}}. Document in tool description: 'Returns array of knowledge bases accessible to the user.'
• Expand descriptions to 80-150 chars with WHEN/WHY context. E.g., 'Read file content from a knowledge base. Use this to retrieve document text before editing or analyzing. Requires read permission on the knowledge base.'
• Add parameter constraints and format guidance. E.g., file_path: 'Path to file relative to knowledge base root (e.g., docs/readme.md). Use forward slashes. Max 255 chars.'
• Annotate tools with readOnlyHint/destructiveHint. E.g., update_file and commit_changes should have destructiveHint: true. list_knowledge_base and read_file_content should have readOnlyHint: true.
• Enhance error messages with recovery steps. E.g., instead of '权限不足', return 'Permission denied: you lack write access to this knowledge base. Contact the knowledge base owner or request elevated permissions.' Include actionable next steps.

Inferred effective spec: <=2025-11-25.

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry