Stefano Fiorini
70 lines
1.7 KiB
Markdown
70 lines
1.7 KiB
Markdown
# PI COMMON REVIEWER
|
|
|
|
## Purpose
|
|
|
|
This document covers the shared reviewer-runtime helpers used by the Pi workflow skills.
|
|
|
|
It is intentionally separate from [PI-SUPERPOWERS.md](./PI-SUPERPOWERS.md). Superpowers are skill dependencies; reviewer-runtime is helper-script setup.
|
|
|
|
## Required Files
|
|
|
|
The workflow-heavy Pi skills expect these helper files from `skills/reviewer-runtime/pi/`:
|
|
|
|
- `run-review.sh`
|
|
- `notify-telegram.sh`
|
|
|
|
Supported install locations:
|
|
|
|
1. `.pi/skills/reviewer-runtime/pi/`
|
|
2. `~/.pi/agent/skills/reviewer-runtime/pi/`
|
|
|
|
## Verify An Existing Install
|
|
|
|
Project-local:
|
|
|
|
```bash
|
|
test -x .pi/skills/reviewer-runtime/pi/run-review.sh
|
|
test -x .pi/skills/reviewer-runtime/pi/notify-telegram.sh
|
|
```
|
|
|
|
Global:
|
|
|
|
```bash
|
|
test -x ~/.pi/agent/skills/reviewer-runtime/pi/run-review.sh
|
|
test -x ~/.pi/agent/skills/reviewer-runtime/pi/notify-telegram.sh
|
|
```
|
|
|
|
## Install The Common Reviewer Helpers
|
|
|
|
Global install:
|
|
|
|
```bash
|
|
mkdir -p ~/.pi/agent/skills/reviewer-runtime/pi
|
|
cp -R skills/reviewer-runtime/pi/* ~/.pi/agent/skills/reviewer-runtime/pi/
|
|
chmod +x ~/.pi/agent/skills/reviewer-runtime/pi/*.sh
|
|
```
|
|
|
|
Project-local install:
|
|
|
|
```bash
|
|
mkdir -p .pi/skills/reviewer-runtime/pi
|
|
cp -R skills/reviewer-runtime/pi/* .pi/skills/reviewer-runtime/pi/
|
|
chmod +x .pi/skills/reviewer-runtime/pi/*.sh
|
|
```
|
|
|
|
## Telegram
|
|
|
|
If you want the workflow skills to send completion messages, configure:
|
|
|
|
- `TELEGRAM_BOT_TOKEN`
|
|
- `TELEGRAM_CHAT_ID`
|
|
|
|
The Pi helper uses the same notification behavior documented in [TELEGRAM-NOTIFICATIONS.md](./TELEGRAM-NOTIFICATIONS.md).
|
|
|
|
## What This Doc Does Not Cover
|
|
|
|
- installing Obra Superpowers
|
|
- Pi package layout decisions
|
|
|
|
Those belong in [PI-SUPERPOWERS.md](./PI-SUPERPOWERS.md) and [PI.md](./PI.md).
|