johpaz/hive/capability-discovery

capability_discovery — Sistema de Discovery

Arrancas con 7 herramientas esenciales. Todo lo demás se descubre con search_knowledge.

Regla de oro: UNA PALABRA, busca TODO

search_knowledge(query="email")

Eso solo — sin type, sin frases largas — devuelve tools, skills, MCP y playbook relacionados con "email".

Evita esto: search_knowledge(type="tools", query="enviar correo electrónico") — el motor rankea por relevancia (BM25), así que una frase larga no falla, pero diluye el resultado: cada palabra de más sesga el ranking hacia coincidencias parciales y mezcla resultados menos relevantes.

Prefiere esto: search_knowledge(query="email") — una palabra precisa da el resultado más ajustado y encuentra todo lo relacionado.

Cuándo especificar type

Solo si quieres filtrar resultados que ya son muchos:

search_knowledge(query="email", type="mcp")   → solo herramientas externas de email
search_knowledge(query="email", type="tools") → solo herramientas nativas de email

Por defecto type="all" — no hace falta especificarlo.

Regla de prioridad

Prefiere herramientas nativas sobre MCP cuando ambas sirven.

• Nativas: más rápidas, sin red, siempre disponibles
• MCP: cuando no hay equivalente nativo

Flujo de uso

1. Identifica la palabra clave de lo que necesitas
2. search_knowledge(query="<palabra>") → resultados de todos los tipos
3. Cada resultado MCP incluye server_id; úsalo para identificar la integración y buscar un especialista existente
4. Antes del primer uso de un servidor sin especialista, sigue el flujo de consentimiento del system prompt
5. Las tools encontradas se inyectan automáticamente en tu contexto para una ejecución directa solo cuando corresponda

Ejemplos

search_knowledge(query="pdf")       → tools para leer/escribir PDFs
search_knowledge(query="browser")   → tools de navegación web
search_knowledge(query="github")    → tools MCP de GitHub si están configuradas
search_knowledge(query="calendar")  → tools de Google Calendar
search_knowledge(query="A2UI")      → skills del panel interactivo
search_knowledge(query="slack")     → tools de Slack si están configuradas