¿Qué hace linear-sdk-scripting?
Habilidad de agente 'linear-sdk-scripting' de cline/skills.
Esta habilidad permite al agente interactuar con la API de Linear mediante su SDK oficial. El agente puede realizar operaciones como crear, leer, actualizar y eliminar issues, consultar equipos, proyectos y sprints, y ejecutar consultas GraphQL personalizadas.
Requisitos
- Tener una cuenta en Linear con acceso a la API.
- Configurar una variable de entorno
LINEAR_API_KEYcon una clave de API de Linear. - El agente debe tener acceso a Node.js y npm para instalar el SDK.
Instalación
El SDK de Linear se instalará automáticamente cuando el agente ejecute la habilidad. Si es necesario, se puede instalar manualmente:
npm install @linear/sdk
Uso
El agente utilizará el SDK de Linear para ejecutar comandos. Por ejemplo, para listar issues:
import { LinearClient } from '@linear/sdk';
const client = new LinearClient({ apiKey: process.env.LINEAR_API_KEY });
const issues = await client.issues();
console.log(issues.nodes);
Operaciones Soportadas
- Crear issue: Crear una nueva tarea en un equipo de Linear.
- Actualizar issue: Modificar el estado, prioridad, asignado, etc.
- Eliminar issue: Eliminar una tarea existente.
- Buscar issues: Filtrar por estado, equipo, prioridad, etc.
- Gestionar equipos: Listar equipos y proyectos.
- Consultas GraphQL: Ejecutar consultas personalizadas.
Configuración
La habilidad requiere que el agente tenga configurada la variable de entorno LINEAR_API_KEY. El agente puede solicitar esta clave al usuario si no está presente.
Ejemplo de Flujo de Trabajo
- El usuario pide al agente: "Crea un issue en el equipo 'Backend' con título 'Implementar autenticación' y prioridad alta".
- El agente usa el SDK para crear el issue en Linear.
- El agente confirma la creación y devuelve el ID del issue.
Limitaciones
- Depende de la disponibilidad de la API de Linear.
- El agente debe tener permisos adecuados en Linear para realizar las operaciones.
- Las consultas GraphQL complejas pueden requerir conocimientos específicos del esquema de Linear.