Hogar

Skill

Revisión de código

difit

yoshiko-pg/difit

Solicita al usuario una revisión del código a través de difit tras realizar cambios en el mismo.

...Expandir todo

Tiempo actualizado 26 de agosto de 2026

# cli # code-review # developer-tools # git # Code ReviewGit & Version Control # diff

Acerca de «difit»

La skill «difit» solicita al usuario una revisión del código a través de «difit», una herramienta local de visualización de diferencias, una vez que se han realizado cambios en el código. Resuelve el problema de incorporar los comentarios de la revisión humana al flujo de trabajo del agente: el agente ejecuta difit con un objetivo de diferencias seleccionado, el usuario deja comentarios de revisión en la interfaz de usuario de difit y esos comentarios se envían a la salida estándar (stdout) cuando difit finaliza su ejecución, de modo que el agente pueda continuar trabajando y abordarlos. Si el servidor se apaga sin comentarios, el agente lo interpreta como si no se hubieran proporcionado comentarios de revisión.

La habilidad define un conjunto reducido de comandos. Selecciona el binario difit si está disponible; de lo contrario, recurre a npx difit, y si el recurso npx requiere acceso a la red en un entorno aislado, solicita primero permisos elevados y la aprobación del usuario en lugar de continuar de forma silenciosa. Los objetivos de revisión incluyen cambios no confirmados, la confirmación HEAD, cambios preparadas, cambios no preparadas, una única confirmación o una comparación entre dos confirmaciones o ramas. Se pueden adjuntar comentarios opcionales de inicio mediante --comment como objetos de hilo JSON vinculados a rutas de archivo y rangos de líneas, lo cual resulta útil para mostrar los resultados de la revisión directamente en el diff, y se pueden incluir archivos no controlados con --include-untracked. Solo se puede utilizar dentro de un directorio gestionado por Git.

Los usuarios a los que va dirigido son desarrolladores que desean un punto de control de revisión con intervención humana después de que el agente edite el código. La skill tiene en cuenta la seguridad: indica explícitamente que nunca se deben copiar secretos, tokens, contraseñas, claves de API, claves privadas u otro material similar a credenciales del diff en el cuerpo de los comentarios o en los argumentos de la línea de comandos. Sus acciones se limitan a ejecutar una herramienta de revisión local sobre las diferencias de Git, lo que la hace inofensiva.

Preguntas frecuentes

¿Cómo llega el comentario de revisión al agente?

Cuando el usuario deja comentarios en difit, estos se envían a stdout al finalizar el comando difit, y el agente continúa entonces con su trabajo para abordarlos. Si difit se cierra sin comentarios, se considera que no se han proporcionado comentarios de revisión.

¿Qué ocurre si difit no está instalado?

La skill utiliza difit si el comando `-v difit` se ejecuta correctamente; de lo contrario, recurre a `npx difit`. Si ese recurso alternativo de npx necesitara acceso a la red en un entorno aislado sin permiso, solicitaría permisos elevados y la aprobación del usuario antes de ejecutarse.

¿Qué puedo revisar con ella?

Cambios no confirmados, la confirmación HEAD, cambios preparados, cambios no preparados, una sola confirmación o una comparación entre dos confirmaciones o ramas, incluyendo opcionalmente archivos no rastreados con --include-untracked.

¿Existen restricciones de uso?

Sí, solo se puede utilizar dentro de un directorio gestionado por Git, ya que opera con diferencias de Git.

¿Cómo gestiona los datos confidenciales en las diferencias?

Indica explícitamente que nunca se copien secretos, tokens, contraseñas, claves API, claves privadas u otro material similar a credenciales del diff en los cuerpos de --comment ni en ningún argumento de la línea de comandos.

Todos los archivos

2 archivosagents/openai.yaml0,2 KBVerSKILL.md2,6 KBVer

Ver en GitHub

Overview

This skill requests a code review from the user using difit.Before running commands, choose <difit-command> using the following rule:

If command -v difit succeeds, use difit.
Otherwise, use npx difit.
If falling back to npx difit would require network access in a sandboxed environment without network permission, request escalated permissions and user approval before running it.

If the user leaves review comments, they are printed to stdout when the chosen difit command exits.When review comments are returned, continue work and address them.If the server is shut down without comments, treat it as "no review comments were provided." Restarting it is unnecessary.Manual verification of whether the page launched correctly is also unnecessary.

Commands

Review uncommitted changes before commit: <difit-command> .
Review the HEAD commit: <difit-command>
Review staging area changes: <difit-command> staged
Review unstaged changes only: <difit-command> working

Basic Usage:

<difit-command> <target>                    # View single commit diff. ex: difit 6f4a9b7<difit-command> <target> [compare-with]     # Compare two commits/branches. ex: difit feature main

Optional Startup Comments

If there is something you want to tell the user when difit opens, attach it as startup comments with --comment.This is useful for review findings, explanations, and any context the user should see directly on the diff.

<difit-command> <target> [compare-with] \  --comment '{"type":"thread","filePath":"src/foobar.ts","position":{"side":"old","line":102},"body":"line 1line 2"}' \  --comment '{"type":"thread","filePath":"src/example.ts","position":{"side":"new","line":{"start":36,"end":39}},"body":"Range comment for L36-L39"}'

Use type: "thread" for each comment.
Write comment bodies in the language the user is using.
Use position.side: "new" for lines that exist on the target side of the diff.
Use position.side: "old" for lines that exist only on the deleted side.
Use range comments for issues that span multiple lines.
Never copy secrets, tokens, passwords, API keys, private keys, or other credential-like material from the diff into --comment bodies or any command-line arguments.