Pautas de indicaciones para Developer Assistant

Esta página proporciona pautas prácticas para crear indicaciones (prompts) efectivas al utilizar Developer Assistant para Jutro, el asistente para desarrolladores con IA de Guidewire. Está diseñado para desarrolladores de frontend que trabajan con la plataforma Jutro y desean maximizar la precisión y la utilidad de sus respuestas. Aprenderá a estructurar solicitudes, proporcionar ejemplos, especificar criterios y desglosar tareas complejas para lograr mejores resultados y optimizar su flujo de trabajo de desarrollo.

Utilice un lenguaje sencillo y preciso

Cuando elabore indicaciones para Developer Assistant, utilice un lenguaje claro y directo. Evite la jerga, las oraciones complejas o los términos ambiguos que podrían generar malentendidos. El objetivo es comunicar sus necesidades de la forma más sencilla y directa posible.

Evite este tipo de frases:

- Create a fairly long section (how long should it be?)
- Add some examples (how many examples?)

Dé instrucciones claras

Cuando utilice Developer Assistant, proporcione instrucciones claras y específicas sobre lo que desea lograr. Evite el lenguaje vago o ambiguo para garantizar respuestas precisas.

En lugar de solicitudes vagas:

Help me create a form for users to fill in

Use indicaciones específicas y prácticas:

Create a form consisting of Jutro components with validation that includes:

- a TextInput component for email addresses
- a Select component for country selection
- a Button component for the submit button 

Include proper TypeScript types and error handling for all of these elements

Sea específico acerca de lo siguiente:

• El componente o la funcionalidad exactos que necesita.
• Las propiedades, el estilo o el comportamiento necesarios.
• El formato de salida esperado, como código de componente, configuración, pruebas.
• Cualquier restricción o requisito, como accesibilidad o diseño responsive.

Dé instrucciones específicas de Jutro

Debido a que Developer Assistant tiene una comprensión integrada del código y los estándares de generación de códigos de Jutro, puede recurrir a información específica de Jutro al elaborar indicaciones. Esto ayuda a garantizar que el código generado esté listo para integrarse con sus aplicaciones existentes de Jutro y se alinee con el marco de Jutro y sus prácticas recomendadas. Los siguientes elementos se pueden incluir en sus indicaciones:

• Componentes, propiedades y configuraciones específicas de Jutro.
• Patrones de desarrollo y prácticas recomendadas de Jutro.
• Funciones de Jutro Digital Platform, como internacionalización, tematización, accesibilidad y pruebas.
• Pautas de arquitectura y estructura del proyecto de Jutro.

Dé buenos ejemplos

Proporcionar ejemplos en las indicaciones ayuda a que Developer Assistant comprenda el formato y el estilo de salida deseados. Incluya fragmentos de código o referencias a componentes existentes que ilustren lo que desea.

Incluya el código de muestra cuando solicite modificaciones:

Modify this Button component to include an icon prop. Here's my current implementation:

```tsx
import { Button } from '@jutro/components';
import { IntlMessageShape } from '@jutro/prop-types';

interface ButtonProps {
  label: IntlMessageShape;
  onClick?: React.MouseEventHandler<HTMLButtonElement>;
}

export const MyButton = ({ label, onClick }: ButtonProps) => {
  return (
    <Button
      label={label}
      onClick={onClick}
    />
  );
};
```

I want to add an optional icon that appears before the text.

Consulte los patrones y componentes existentes para mantener la coherencia:

Create a form using Jutro components

Ensure it includes input fields for the following elements:
- Username
- Password
- Email

Ensure the fields are all implemented using Jutro components and include the relevant props for accessibility and styling

Brinde criterios específicos.

Describa claramente los criterios o requisitos específicos para la tarea, incluidas las secciones de código requeridas, el formato de salida y los estándares de generación de código. Esto ayuda a que Developer Assistant adapte las respuestas para satisfacer las necesidades que usted tenga.

En lugar de una solicitud general:

Create a form

Proporcione criterios específicos:

Create a drawer component with the following requirements:

- Include a mandatory header with H2 heading and close icon
- Ensure the body contains a form with name, email, and phone number fields using the TextInput and PhoneInput components
- Include an optional footer with primary and secondary action buttons using the Button component
- Use TypeScript interfaces and follow Jutro component patterns
- Include proper ARIA labels and focus management

Cuanto más específicos sean sus criterios, más fácil será para Developer Assistant generar el código exacto que se ajuste a sus necesidades.

Divida la tarea en pasos más pequeños

Para tareas complejas, divida su solicitud en pasos más pequeños y manejables. Esto ayuda a que Developer Assistant se concentre en cada parte de la tarea y a producir resultados más precisos.

En lugar de una solicitud única y amplia como esta:

Build a complete dashboard with charts, filters, and export functionality

Divida la tarea en pasos:

Create a dashboard layout based on the following requirements:

1. Create the layout structure using the Jutro Card component and include a header and sidebar navigation
1. Add a table view that displays sales data by month
1. Implement filter controls for date range and product category
1. Add an export button that downloads the chart data as a CSV file

Este enfoque permite que Developer Assistant aborde cada parte de su proyecto en detalle, lo que da como resultado un código mejor y más fácil de mantener.