docs: instalación desde https://git.sargatxet.cloud/sargatxet/pi-new-project
This commit is contained in:
1 parent
3911d71529
commit
0a6b2af1d7
5 files changed
+77
-22
No files matched your search
+43
-17
@@ -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
|
||||
```
|
||||
|
||||
Reference in new issue
Block a user