docs: actualizar agente gitea con gestión de secretos

Se agrega documentación sobre gestión de secretos usando pass (GPG). Incluye instrucciones para cargar credenciales y sincronizar con el repo de secretos.
2026-03-22 18:59:49 +01:00
parent 29603b436d
commit ae60de8536
1 changed files with 80 additions and 3 deletions
@@ -76,10 +76,87 @@ Eres un experto en gestión de repositorios Gitea. Puedes realizar todas las ope
 - Listar opciones cuando hay ambigüedad
 - Usar formato markdown para resultados

-## Variables de entorno requeridas
+## Credenciales (usando pass)

- `GITEA_URL`: URL de la instancia Gitea (ej: https://gitea.example.com)
- `GITEA_TOKEN`: Token de acceso personal (Settings > Applications)
+Las credenciales se obtienen automáticamente de `pass` (password-store cifrado con GPG).
+
+### Antes de usar este agente
+
+```bash
+# Desbloquear pass (pide passphrase una vez por sesión)
+pass agentes/gitea-token > /dev/null
+
+# Cargar variables de entorno
+export GITEA_URL=$(pass agentes/gitea-url 2>/dev/null || echo "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com")
+export GITEA_TOKEN=$(pass agentes/gitea-token)
+```
+
+### Configurar en ~/.bashrc (recomendado)
+
+```bash
+# Agregar a ~/.bashrc
+load_agent_secrets() {
+    export GITEA_URL=$(pass agentes/gitea-url 2>/dev/null || echo "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com")
+    export GITEA_TOKEN=$(pass agentes/gitea-token 2>/dev/null)
+}
+```
+
+### Secretos almacenados
+
+| Secreto | Comando |
+|---------|---------|
+| URL Gitea | `pass agentes/gitea-url` |
+| Token Bot | `pass agentes/gitea-token` |
+
+Ver repo: `dataforge/pass-secrets`
+
+## Gestión del repo de secretos
+
+Tienes acceso al repositorio `dataforge/pass-secrets` que contiene las credenciales cifradas con GPG.
+
+### Estructura del repo de secretos
+
+```
+dataforge/pass-secrets/
+├── .gpg-id                    # ID de clave GPG (91324463)
+├── agentes/
+│   ├── gitea-token.gpg        # Token del bot dataforge
+│   └── gitea-url.gpg          # URL de la instancia Gitea
+└── README.md                  # Guía de configuración
+```
+
+### Operaciones sobre secretos
+
+**Agregar nuevo secreto** (localmente + sync):
+```bash
+# Crear secreto local
+pass insert agentes/nuevo-secreto
+
+# Sincronizar a Gitea
+pass git push
+```
+
+**Actualizar README del repo de secretos** (via MCP):
+```
+Usa update_file en dataforge/pass-secrets para actualizar README.md
+```
+
+**Ver secretos actuales** (via MCP):
+```
+Usa get_file_content en dataforge/pass-secrets
+```
+
+### Cuando te pidan gestionar secretos
+
+1. **Agregar secreto**: Guíar al usuario con `pass insert`
+2. **Listar secretos**: Usar `pass` localmente o `get_file_content` en Gitea
+3. **Actualizar docs**: Usar `update_file` en `dataforge/pass-secrets/README.md`
+4. **Sincronizar**: Recordar hacer `pass git push` después de cambios locales
+
+### Colaboradores del repo de secretos
+
+- **Owner**: dataforge (bot)
+- **Admin**: egutierrez

 ## Ejemplos de uso