AgentePlanificar

Diseñar el contrato de comandos y errores de una CLI

Perfil para diseñar una herramienta de línea de comandos usable por personas y scripts: ayuda, opciones coherentes, JSON estable, códigos de salida y errores con una acción siguiente. Incluye criterios de compatibilidad y distribución.Ir a la descarga

Ficha elaborada por peopleofthe.ai con asistencia de IA. Consulta el criterio editorial y los límites de las pruebas.

CLIexperiencia de desarrolloautomatizacióncontratos
Documentación revisada · recurso sin ejecutar

Perfil y licencia completos revisados; SHA256 y Git blob cotejados con árbol no truncado de revisión fija. ZIP reconstruido determinísticamente; sin ejecutar ni instalar el recurso.

Antes de empezar

Comprueba que tienes lo necesario para usar este recurso.

  • Perfil Markdown en inglés para un asistente de texto o anfitrión de agentes. Aportar comandos actuales, usuarios, sistemas objetivo, ejemplos de fallos y scripts que dependan de la interfaz.
  • Los ejemplos mytool y las salidas son ilustrativos: no hay un ejecutable, instalador, framework de CLI ni implementación de --dry-run incluidos. Elegir y comprobar herramientas aparte si se pasa a desarrollo.
  • Definir por separado salida humana y salida de máquina, códigos de error y reglas de compatibilidad. Confirmar el comportamiento con pipes, archivos, terminales y plataformas que realmente se soporten.
  • El objetivo de arranque inferior a 100 ms y las mejoras de adopción del texto no están medidas. Establecer presupuesto y medición en el entorno propio; las cifras no demuestran rendimiento del recurso.
  • Comandos destructivos, caché de credenciales, telemetría, distribución y autoactualización requieren diseño de permisos, privacidad e integridad. El perfil no autoriza ejecutar, instalar ni publicar herramientas.
  • Archivo gratuito MIT. Modelo, CI, firma de binarios y canales de distribución pueden implicar costes. No se desarrolló ni ejecutó una CLI en esta revisión.

Compatibilidad declarada

Perfil Markdown agency-agents en inglés · herramientas e integración no ensayadas

Según la documentación de origen. La presencia en esta lista no implica una prueba de ejecución en cada entorno.

Una forma de empezar

EJEMPLO ILUSTRATIVO

Una solicitud para adaptar a tu contexto y usar con el recurso.

TU SOLICITUD

Caso ficticio: una CLI interna devuelve tablas con colores al usar pipes y el mismo código de salida para éxito y error. Diseña un contrato antes de cambiar código.

RESULTADO ORIENTATIVO

Proponer --json con esquema estable y sin códigos ANSI, errores por stderr y códigos distintos para éxito y fallo. Añadir ejemplos a --help y casos de aceptación para terminal y redirección. Mantener la salida anterior durante una migración explícita para no romper scripts existentes.

Ejemplo editorial ficticio y abreviado; no procede de una ejecución ni acredita eficacia o compatibilidad. Este ejemplo no es una salida observada de una prueba del recurso.

La fuente, a la vista

Recurso original
Developer Tooling Engineer
Autor
Contribuidores de msitarzewski/agency-agents · Copyright (c) 2025 AgentLand Contributors
Versión o revisión
b37b5bb33b78f2c1d6567d98e25ca818e3259219
Licencia
MIT

Licencia MIT raíz leída completa; original y aviso de copyright conservados íntegros junto a procedencia y nota editorial separada. La descarga no redistribuye las herramientas o servicios mencionados.

Ver fuente original