菜单
Use when adding a capability the IA can call in Chispa's agentic brain — a new ChispaTool (get_speed, clear_dtc, set_brightness, poner_musica, web search, etc.). Triggers — "agregar una tool", "que la IA pueda X", "nueva herramienta del carro", "tool use", "ChispaBrain".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Use when adding a new sensor or input to Chispa — an OBD PID, phone sensor (accel, gyro, light, proximity), GPS speed, or a Maps nav signal. Anything that produces a Stream that feeds the combined AppState. Triggers — "agregar sensor", "leer un nuevo PID", "nueva fuente de datos", "wire X into AppState".
Use when adding or changing a Chispa mood / animation state — a new emotional reaction, its place in the priority cascade, its look (color, eyes, mouth, extras), and its Rive input. Triggers — "agregar un ánimo", "nueva animación", "que reaccione con X", "Mood enum", "mood_resolver", "estado de ánimo".
Use when launching or running the Chispa app on an Android device, or to verify a change works in the real app (not just tests). Triggers — "corre la app", "run on device", "pruébalo en el celular", "ver si funciona en el carro", "instala el APK", "hot reload".
基于 SOC 职业分类
| name | add-chispa-tool |
| description | Use when adding a capability the IA can call in Chispa's agentic brain — a new ChispaTool (get_speed, clear_dtc, set_brightness, poner_musica, web search, etc.). Triggers — "agregar una tool", "que la IA pueda X", "nueva herramienta del carro", "tool use", "ChispaBrain". |
La IA recibe la lista de tools, decide cuáles usar, tú las ejecutas local y devuelves el resultado.
El bucle de ChispaBrain repite hasta la respuesta final.
usuario -> modelo -> ¿pide tool? -> run() local -> resultado -> modelo -> ... -> respuesta
Cada tool va desacoplada de la fuente: se le inyecta la función que lee/ejecuta el dato, no importa el servicio directo. Así se testea con un fake.
ChispaTool en lib/brain/tools/. Define name, description (clara y bien
distinta de las demás), schema (JSON de parámetros) y run(args).Future<int> Function() readSpeed), no el servicio.requiresConfirmation = true:
ChispaBrain pide confirmación por voz antes de ejecutar. Las de solo lectura corren directo.ToolRegistry. Límite: 3–5 tools activas. La precisión del modelo cae con más
(10–15 empieza a errar, 20 se confunde). Si crecen, agrupa o divide por agente temático.run se refleja en onToolUse → Chispa muestra "consultando X". El bucle entero es
thinking; la respuesta final dispara los visemas (answering).tool_call predecible
y verifica que run se invoca, que una tool mutadora espera confirmación, y el resultado vuelve al modelo.| Tool | Tipo | Fuente envuelta |
|---|---|---|
get_speed | lectura | GPS / OBD |
get_engine_status | lectura | OBD (temp, RPM, carga) |
clear_dtc | mutadora (Modo 04) | OBD — confirma por voz |
get_next_turn | lectura | NavService (Maps) |
set_brightness | mutadora | ventana/sistema — confirma |
poner_musica | acción | intent MEDIA_PLAY_FROM_SEARCH (sin Spotify/Premium) |
control_musica | acción | sesiones de media del sistema |
buscar_web | lectura | Tavily (empezar) o Brave |
onToolUse/onThinking. → La animación no refleja lo que hace.