Escribir una buena habilidad

Habilidades y luego Crear habilidad. Cuatro cosas que rellenar.

O pídelo sin más en un chat. Describe la habilidad que quieres («apunta cómo damos formato a nuestros casos de éxito: el titular, luego el problema en una frase y luego las cifras») y Asteria redacta el borrador. Una tarjeta te muestra las instrucciones que ha escrito, la descripción que decide cuándo se activa la habilidad y si se cargará sola o esperará a un /, y no se crea nada hasta que apruebes esa tarjeta. Obtienes una habilidad corriente: ábrela aquí después para editarla, compartirla o desactivar la carga automática.

Nombre

Qué es, en un par de palabras. Formato de Caso de Éxito, Notas de Reunión, Respuestas de Política de Gastos.

Es lo que ves en la lista de /, así que hazlo fácil de escanear.

Descripción

Doscientos caracteres, y el campo más importante de la página.

El cuadro pregunta "¿Cuándo debería tu asistente recurrir a esta habilidad?" y lo dice literalmente. Con la Carga automática activada, este texto es lo que lee Asteria para decidir si la habilidad aplica. Es un disparador, no un resumen.

Escríbelo como una condición, no como una descripción.

Flojo, porque describe en lugar de disparar:

Nuestro formato de casa para los casos de éxito de clientes.

Fuerte, porque dice cuándo:

Dar formato a un caso de éxito o historia de cliente. Cubre el orden de secciones, la extensión y la cita destacada obligatoria. Cargar antes de redactar cualquier caso de éxito.

Las habilidades integradas están todas escritas así, y merece la pena copiarlas. Una de ellas dice:

Peticiones de diagrama (diagrama de flujo, arquitectura, pipeline, máquina de estados). Usa create_diagram, no generate_image. Cargar antes de cualquier petición de "dibuja / diagrama / esquematiza el flujo".

Fíjate en lo que hace: nombra las situaciones, lista las palabras que un usuario escribiría de verdad y termina con un explícito "cargar antes de X". Esa última cláusula trabaja mucho.

Si tu habilidad nunca parece dispararse, casi siempre el motivo es la descripción. Añade el vocabulario que usarían tus compañeros, incluidas las palabras informales.

Carga automática

Activada significa que Asteria puede recoger la habilidad por su cuenta. Correcto para cualquier cosa que deba aplicarse siempre que surja la situación, que es la mayoría de habilidades.

Desactivada significa solo /. Correcto cuando:

• La habilidad tiene opinión propia y solo debería aplicarse cuando se pide
• Aplica a un caso estrecho que prefieres decidir tú
• Contradice a otra habilidad y quieres elegir entre las dos

Instrucciones

La habilidad en sí, en Markdown, con una pestaña Editar y una Vista previa.

Escríbela como un procedimiento para alguien capaz que no ha hecho esta tarea concreta aquí antes. Lo que funciona:

Sé concreto con la forma. Numera las secciones, di cuánto ocupa cada una, da el orden.

Pon un ejemplo. Un ejemplo corto y trabajado vale más que tres párrafos de descripción.

Di qué no hacer, sobre todo donde el enfoque evidente es el equivocado. "No empieces con la historia de la empresa del cliente. Empieza por el problema."

Di qué hacer cuando no encaje. "Si no hay un resultado medible, dilo claramente en lugar de inventarte uno blando, y señálalo para quien redacte."

Lo que no funciona:

Repetir las buenas prácticas. "Sé claro y conciso" ya está en vigor y desperdicia el espacio.

Hacerla enorme. Una habilidad se carga en la conversación cuando se dispara, y una desparramada desplaza a tu pregunta de verdad. Si la tuya se está alargando, probablemente sean dos habilidades.

Duplicar las instrucciones de un agente. Si solo aplica dentro de un agente, y ese agente ya lo dice, no necesitas la habilidad.

Probarla

Abre un chat y describe la situación sin nombrar la habilidad:

Redacta un caso de éxito sobre el despliegue de Acme.

Si la Carga automática está activada y la descripción es buena, se dispara. Si no, la descripción necesita las palabras que acabas de usar.

Luego compruébala con / para confirmar que las instrucciones producen lo que querías. Son dos pruebas separadas, porque fallan por motivos distintos: una habilidad que se dispara pero produce la forma equivocada es un problema de instrucciones, y una habilidad que nunca se dispara es un problema de descripción.

Acuérdate de quitar la pastilla después, o se queda en vigor el resto de esa conversación.

Compartir

El diálogo de compartir de siempre, o Publicar para meterla en el marketplace de tu organización, donde cualquiera puede añadirla a su biblioteca.

Al publicar puedes permitir o prohibir la duplicación. Permítela si prefieres que la gente adapte tu habilidad antes que empezar de cero. Prohíbela si la gracia es que todo el mundo siga una sola versión.

Despublicar retira la habilidad del marketplace y revoca la entrada de la biblioteca de todos, así que lo que hayan duplicado se queda con ellos y lo que solo hubieran añadido desaparece.