This commit is contained in:
sargatxet committed 2026-10-18 18:39:26 +02:00
1 parent 3911d71529
commit 0a6b2af1d7
5 files changed
+77 -22

No files matched your search

+43 -17
View File
@@ -3,6 +3,8 @@
Instalación del paquete/skill `new-project` en pi, en este ordenador o en
cualquier otro.
Repositorio: <https://git.sargatxet.cloud/sargatxet/pi-new-project>
## 1. Requisitos
| Componente | Versión mínima | Notas |
@@ -12,23 +14,37 @@ cualquier otro.
| git | cualquiera | Opcional: `--git` y autor por defecto. |
| shellcheck | opcional | Para validar el script (`shellcheck new-project.sh`). |
## 2. Opción A — instalarlo como paquete de pi (recomendado)
## 2. Opción A — instalarlo como paquete de pi desde git (recomendado)
Desde el directorio que contiene `pi-new-project/`:
pi clona el repositorio y lo instala directamente:
```bash
pi install ./pi-new-project
pi install git:git.sargatxet.cloud/sargatxet/pi-new-project
# equivalente, con la URL completa:
pi install https://git.sargatxet.cloud/sargatxet/pi-new-project
```
O desde git/npm cuando se publique:
```bash
pi install git:github.com/<usuario>/pi-new-project@v0.1.0
```
Para fijar una versión concreta, añade una etiqueta o un commit:
`pi install git:git.sargatxet.cloud/sargatxet/pi-new-project@<etiqueta-o-commit>`.
Añade `-l` (`--local`) para declararlo solo en el proyecto actual
(`.pi/settings.json`) en lugar de en `~/.pi/agent/settings.json`.
Comprueba con `pi list` y arranca pi: la skill aparecerá como `new-project` y
estará disponible la orden `/modelo-proyecto`.
Para una prueba puntual sin instalarlo: `pi -e ./pi-new-project`.
Para una prueba puntual sin instalarlo:
`pi -e git:git.sargatxet.cloud/sargatxet/pi-new-project`.
### Desde una copia local
Si prefieres descargar antes el repositorio (para revisarlo o modificarlo):
```bash
git clone https://git.sargatxet.cloud/sargatxet/pi-new-project.git
pi install ./pi-new-project
```
Una instalación local se carga desde ese directorio sin copiarlo: los cambios
(o un `git pull`) se aplican en la siguiente sesión de pi.
## 3. Opción B — copiar la skill
@@ -47,6 +63,9 @@ ln -s "$PWD/pi-new-project/skills/new-project" ~/.agents/skills/new-project
Rutas equivalentes: `~/.pi/agent/skills/` y, por proyecto, `.agents/skills/`.
En estos ejemplos, `pi-new-project/` es una copia del repositorio obtenida con
`git clone https://git.sargatxet.cloud/sargatxet/pi-new-project.git`.
La skill sola no incluye la orden `/modelo-proyecto` ni la herramienta
`elegir_modelo_proyecto`; cópialas también (o la skill usará el plan B,
`pi --list-models` + `--modelo`):
@@ -56,20 +75,21 @@ mkdir -p ~/.pi/agent/extensions
cp pi-new-project/extensions/modelo-proyecto.ts ~/.pi/agent/extensions/
```
## 4. Opción C — exportar a otro ordenador
## 4. Opción C — exportar a otro ordenador sin acceso al repositorio
No hay más que copiar el directorio; no tiene dependencias.
Si el ordenador destino tiene acceso a
<https://git.sargatxet.cloud/sargatxet/pi-new-project>, basta con la opción A.
Si no, copia el directorio; no tiene dependencias.
```bash
# en el ordenador origen
tar -czf pi-new-project-0.1.0.tar.gz pi-new-project/
tar -czf pi-new-project-0.2.0.tar.gz pi-new-project/
# en el ordenador destino
tar -xzf pi-new-project-0.1.0.tar.gz
tar -xzf pi-new-project-0.2.0.tar.gz
pi install ./pi-new-project # o la opción B
```
Alternativa sin `tar`: publicar el repositorio y usar `pi install <url-de-git>`.
## 5. Verificación
@@ -100,14 +120,20 @@ modelos y actualizar `.pi/settings.json`.
## 6. Actualización
```bash
git pull
pi update --extensions # si se instaló como paquete
pi update --extensions # instalado desde git: actualiza el clon gestionado por pi
# instalado desde una copia local o copiado (opción B):
cd pi-new-project && git pull
```
Si se instaló con una etiqueta o un commit fijo (`@<ref>`), `pi update` no lo
mueve: reinstala con la nueva referencia.
## 7. Desinstalación
```bash
pi remove ./pi-new-project # si se instaló como paquete
pi remove git:git.sargatxet.cloud/sargatxet/pi-new-project # paquete desde git
pi remove ./pi-new-project # paquete desde una copia local
rm -rf ~/.agents/skills/new-project # si se copió o enlazó
rm -f ~/.pi/agent/extensions/modelo-proyecto.ts
```