docs(skills): point pi sections to OpeItcLoc03/pi-extensions repo

source of truth for the three pi extensions moved from .common/lib/pi-extensions
(dev-copies) to the new pi-extensions repo; deploy via just install. Updated:
session-inbox-monitor §Pi, session-handoff Headless(pi), vision-subagent
+ realization section. Cross-link AC#5.
This commit is contained in:
2026-08-20 11:29:53 +03:00
parent 53fc942c21
commit 37beda7508
3 changed files with 12 additions and 3 deletions

View File

@@ -121,7 +121,7 @@ Forward-looking, не timeline: handoff = связка новых вещей к
**Триггер:** ритуал на session-end фразе; на substantive commit'е — только handoff-write, ритуал НЕ гонять (mid-session коммит ≠ конец сессии, иначе спам предложений). **Триггер:** ритуал на session-end фразе; на substantive commit'е — только handoff-write, ритуал НЕ гонять (mid-session коммит ≠ конец сессии, иначе спам предложений).
**Headless (pi):** pi-extension `session-close-ritual` (источник: `.common/lib/pi-extensions/session-close-ritual.ts`, деплой `~/.pi/agent/extensions/`) инжектит «прогони ритуал» один раз за сессию на `agent_end` в print-режиме (`pi -p`), с дедуп-гардом и opt-in (та же trigger-строка + `.tasks/` + git). Почему `agent_end`, а не `agent_settled`: settle = «no follow-up left», процесс в teardown — followUp уже не обработается (проверено live); `agent_end` срабатывает сразу после рана, пока followUps ещё доставляются. Интерактив — фразовый триггер (ниже), не инжекция. **Headless (pi):** pi-extension `session-close-ritual` (источник: `~/projects/pi-extensions/extensions/session-close-ritual.ts` — репо `OpeItcLoc03/pi-extensions`, деплой `just install` в клоне → `~/.pi/agent/extensions/`) инжектит «прогони ритуал» один раз за сессию на `agent_end` в print-режиме (`pi -p`), с дедуп-гардом и opt-in (та же trigger-строка + `.tasks/` + git). Почему `agent_end`, а не `agent_settled`: settle = «no follow-up left», процесс в teardown — followUp уже не обработается (проверено live); `agent_end` срабатывает сразу после рана, пока followUps ещё доставляются. Интерактив — фразовый триггер (ниже), не инжекция.
## Failure modes ## Failure modes

View File

@@ -138,8 +138,9 @@ other projects' inboxes (vitya's rule: an agent may only read its own
directory's inbox). Installed globally so *every* pi session has the directory's inbox). Installed globally so *every* pi session has the
capability, but each session only ever touches its own project's inbox. capability, but each session only ever touches its own project's inbox.
- **Source of truth:** `.common/lib/pi-extensions/inbox-monitor.ts` (Node - **Source of truth:** `~/projects/pi-extensions/extensions/inbox-monitor.ts`
built-ins only, no npm deps). Deploy: copy to (репо `OpeItcLoc03/pi-extensions`, Gitea — дом pi-расширений). Deploy:
`just install` в клоне репо — копирует с затираанием в
`~/.pi/agent/extensions/inbox-monitor.ts` (global → every pi, every `~/.pi/agent/extensions/inbox-monitor.ts` (global → every pi, every
directory), hot-reload with `/reload`. Test: directory), hot-reload with `/reload`. Test:
`node --experimental-strip-types .common/lib/pi-extensions/inbox-monitor.test.mjs` `node --experimental-strip-types .common/lib/pi-extensions/inbox-monitor.test.mjs`

View File

@@ -56,3 +56,11 @@ describe_image:
2. файл `~/.pi/vision-model.json``{ "model": "routerai/minimax-m3" }` 2. файл `~/.pi/vision-model.json``{ "model": "routerai/minimax-m3" }`
Авто-выбора нет — если модель не задана, `describe_image` вернёт ошибку с подсказкой. Авто-выбора нет — если модель не задана, `describe_image` вернёт ошибку с подсказкой.
## Реализация тула
Тул `describe_image` — pi-расширение:
`~/projects/pi-extensions/extensions/vision-subagent.ts` (репо
`OpeItcLoc03/pi-extensions`, дом pi-расширений). Правки — в клоне репо →
`commit + push``just install` (затирает home-копию). Конфиг-example:
`~/projects/pi-extensions/config/vision-model.json.example`.