IA para desarrolladores y equipos
La idea: las aplicaciones de esta familia parten del código, de los paquetes, de los repositorios y de los sitios web, y no de documentos. La mayoría toma como entrada un repositorio de GitHub (no la subida de un archivo), y las más pesadas responden con una solicitud de extracción (pull request) que tú revisas.
Qué cubre este capítulo
Nueve páginas cubren once aplicaciones. Ocho están activas; tres (Release Notes, Fork Sync y Personal Engineer) están retiradas y se conservan solo como breves notas de estado para que no pierdas tiempo buscándolas.
Aplicaciones de este capítulo
| Aplicación | Qué recibe | Qué entrega | En una línea |
|---|---|---|---|
| Chat de Assembly (Assembly Chat) | una DLL/EXE de .NET o un paquete NuGet | diagramas, tablas, respuestas, diferencias entre versiones | Hazle preguntas a una biblioteca compilada |
| Code Graph | un repositorio de GitHub con un .sln | un único archivo .sqlite | Un mapa del código sobre el que se pueden hacer consultas |
| Documentos del repositorio (Repo Docs) | un repositorio de GitHub | pull request más un zip (Markdown, HTML, PDF) | Documentación contrastada con el código |
| Release Notes | – | – | Retirada |
| Asistente de refactorización (Refactor Assistant) | un repositorio de C# en GitHub | lista corta ordenada y después un pull request | Divide clases demasiado grandes |
| Actualizador de NuGet (NuGet Updater) | un repositorio de .NET en GitHub | un informe o un pull request | Sube de versión los paquetes desactualizados |
| Fork Sync | – | – | Retirada |
| Analizador SEO (Page SEO Checker) | la URL de una página o de un mapa del sitio | CSV con mejores títulos, H1 y meta descripciones | Auditoría SEO on-page de todo el sitio |
| Asesor (Advisor), Ingeniero de Documentación (Document Engineer), Personal Engineer | un mensaje de chat | consejo, o un zip con un proyecto .NET | Planifícalo o haz que te lo construyan |
Cómo elegir rápido
- ¿Qué hace esta DLL o este paquete? → Chat de Assembly
- ¿Qué cambió entre versiones de un paquete? → Chat de Assembly (Diff)
- Necesito un mapa de datos de un repositorio de C# → Code Graph
- Necesito documentación legible de un repositorio → Documentos del repositorio
- Mis dependencias están desactualizadas → Actualizador de NuGet (empieza con Solo informe)
- Esta clase es demasiado grande → Asistente de refactorización (primero, el escaneo)
- Nuestros títulos y descripciones son flojos → Analizador SEO
- No sé qué aplicación de Documentize usar → Asesor
- Quiero que me escriban un programa de utilidad → Ingeniero de Documentación
Reglas básicas
- Las aplicaciones de repositorio necesitan acceso. Los repositorios públicos funcionan directamente. Para uno privado, invita antes como colaborador a la cuenta de GitHub
arise-project. Ten presente que los servicios de Documentize leerán entonces el contenido del repositorio, y también un modelo de lenguaje cuando una aplicación use IA para escribir texto. - Primero, solo lectura. El escaneo, Solo informe y el Asesor no cambian nada. Aplicar, el modo pull request y Documentos del repositorio crean una rama y un pull request como
arise-project. - No se construye ni se ejecuta nada por ti. Documentos del repositorio, Asistente de refactorización, Actualizador de NuGet e Ingeniero de Documentación producen propuestas; tu CI y tus propios ojos son la comprobación final.
- Las ejecuciones gratuitas tienen límites de tiempo. Las aplicaciones de repositorio cortan una ejecución gratuita al llegar a un límite de tiempo (15 minutos en Documentos del repositorio y Analizador SEO); algunas pueden continuar. Las ejecuciones de Continuar de Documentos del repositorio no se contabilizan.
- Lo que produce la IA es un borrador. Consulta Confianza, verificación y límites de lo que produce la IA.
Cómo leerlo
Cada capítulo sigue las mismas doce secciones que el resto del libro. Aparecen notas de estado donde el texto de la página y el producto no coinciden; «(compruébalo en la aplicación en funcionamiento)» marca todo lo que el autor debe comprobar antes de publicar.