128 lines
4.0 KiB
Markdown
128 lines
4.0 KiB
Markdown
# INSTALL — pi-new-project
|
|
|
|
Instalación del paquete/skill `new-project` en pi, en este ordenador o en
|
|
cualquier otro.
|
|
|
|
## 1. Requisitos
|
|
|
|
| Componente | Versión mínima | Notas |
|
|
| --- | --- | --- |
|
|
| pi | 1.3.0 | Hace falta soporte de skills y de paquetes (`pi install`). |
|
|
| bash | 4.0 | El script usa arrays y `${var//}`. |
|
|
| 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)
|
|
|
|
Desde el directorio que contiene `pi-new-project/`:
|
|
|
|
```bash
|
|
pi install ./pi-new-project
|
|
```
|
|
|
|
O desde git/npm cuando se publique:
|
|
|
|
```bash
|
|
pi install git:github.com/<usuario>/pi-new-project@v0.1.0
|
|
```
|
|
|
|
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`.
|
|
|
|
## 3. Opción B — copiar la skill
|
|
|
|
Copia el directorio de la skill a una de las rutas que pi descubre:
|
|
|
|
```bash
|
|
mkdir -p ~/.agents/skills
|
|
cp -r pi-new-project/skills/new-project ~/.agents/skills/
|
|
```
|
|
|
|
o enlázalo para mantenerlo actualizado con el repositorio:
|
|
|
|
```bash
|
|
ln -s "$PWD/pi-new-project/skills/new-project" ~/.agents/skills/new-project
|
|
```
|
|
|
|
Rutas equivalentes: `~/.pi/agent/skills/` y, por proyecto, `.agents/skills/`.
|
|
|
|
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`):
|
|
|
|
```bash
|
|
mkdir -p ~/.pi/agent/extensions
|
|
cp pi-new-project/extensions/modelo-proyecto.ts ~/.pi/agent/extensions/
|
|
```
|
|
|
|
## 4. Opción C — exportar a otro ordenador
|
|
|
|
No hay más que copiar el directorio; no tiene dependencias.
|
|
|
|
```bash
|
|
# en el ordenador origen
|
|
tar -czf pi-new-project-0.1.0.tar.gz pi-new-project/
|
|
|
|
# en el ordenador destino
|
|
tar -xzf pi-new-project-0.1.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
|
|
|
|
```bash
|
|
bash -n pi-new-project/skills/new-project/scripts/new-project.sh
|
|
pi-new-project/skills/new-project/scripts/new-project.sh --dry-run --nombre Demo /tmp/demo
|
|
|
|
# prueba real en un directorio temporal
|
|
pi-new-project/skills/new-project/scripts/new-project.sh \
|
|
--nombre Demo --descripcion "Proyecto de prueba" --git /tmp/demo
|
|
ls -A /tmp/demo
|
|
```
|
|
|
|
Deben aparecer `AGENTS.md`, `README.md`, `CHANGELOG.md`, `TODO.md`, `INSTALL.md`
|
|
y `.gitignore`, sin marcadores `{{...}}` pendientes.
|
|
|
|
Modelo por defecto:
|
|
|
|
```bash
|
|
pi-new-project/skills/new-project/scripts/new-project.sh \
|
|
--nombre Demo --modelo anthropic/claude-sonnet-4-5 /tmp/demo2
|
|
cat /tmp/demo2/.pi/settings.json
|
|
```
|
|
|
|
En pi, dentro de `/tmp/demo2`, `/modelo-proyecto` debe mostrar el selector de
|
|
modelos y actualizar `.pi/settings.json`.
|
|
|
|
## 6. Actualización
|
|
|
|
```bash
|
|
git pull
|
|
pi update --extensions # si se instaló como paquete
|
|
```
|
|
|
|
## 7. Desinstalación
|
|
|
|
```bash
|
|
pi remove ./pi-new-project # si se instaló como paquete
|
|
rm -rf ~/.agents/skills/new-project # si se copió o enlazó
|
|
rm -f ~/.pi/agent/extensions/modelo-proyecto.ts
|
|
```
|
|
|
|
La skill no deja estado propio: no hay caché ni configuración que limpiar.
|
|
|
|
## 8. Resolución de problemas
|
|
|
|
| Síntoma | Causa probable | Solución |
|
|
| --- | --- | --- |
|
|
| La skill no aparece | Ruta no descubierta | Comprueba la ruta con `pi list` o colócala en `~/.agents/skills/`. |
|
|
| `no encuentro las plantillas` | Falta `templates/` | Reinstala el paquete completo, no solo el script. |
|
|
| `no puedo deducir el nombre` | Destino `.` o `/` | Pasa `--nombre`. |
|
|
| No sobreescribe mis ficheros | Protección por defecto | Usa `--force` tras revisar `--dry-run`. |
|
|
| El proyecto no arranca con su modelo | Proyecto no confiado: pi ignora `.pi/settings.json` | Ejecuta `/trust` en el proyecto. |
|
|
| `/modelo-proyecto` no existe | Solo se copió la skill | Instala el paquete o copia `extensions/modelo-proyecto.ts`. |
|
|
| El selector sale vacío | Ningún proveedor con credenciales | `/login` o configura la API key del proveedor. |
|