tasks: 2 new using-yt-tools findings from concurrent-session observation

- [using-yt-tools-skill-body-venv-invocation]: SKILL.md Prereq/Steps не упоминает venv-activation / full-path invocation; concurrent сессия упёрлась в `yt-frames: command not found`.
- [using-yt-tools-windows-powershell-path-doc-fix]: prior fix покрыл только git-bash subshell, PowerShell subshell имеет ту же restart-after-winget проблему симметрично.

Origin: real-time observation в concurrent CC сессии после /reload-plugins (vitya@DESKTOP-NSEF0UK, 2026-05-20). Local-write workaround — gitea down.
This commit is contained in:
2026-05-20 14:34:12 +03:00
parent c7ee3d80d5
commit 70078999b0

View File

@@ -1,5 +1,5 @@
# Task Board
_Updated: 2026-05-20 (using-yt-tools cluster fully closed: 3 baseline 🟢; 3 finding fixes 🟢; skill-body-fill 🟢 [SKILL.md 0.2.0]; trigger-smoke-clean-session 🟢 [13/13]; review 🟢 by fresh-eyes subagent — Flow A/B/Failure-modes/NOT all PASS; all 3 nice-to-have findings 🟢 — empty-cache-dir-on-failure & warning-mojibake fixed in `common@fc400b7` [yt-tools 0.1.5]; frames-multiline-stdout spec-fixed in `claude-skills@b2c1a21` [SKILL.md 0.2.2])_
_Updated: 2026-05-20 (using-yt-tools — 2 new ⚪ findings from concurrent-session observation: skill-body-venv-invocation, windows-powershell-path-doc-fix. Prior closure of cluster stands; surface gaps in env-bootstrap docs.)_
<!--
Canonical layout. One block per task. Per-task deep context lives in
@@ -14,6 +14,48 @@ _Updated: 2026-05-20 (using-yt-tools cluster fully closed: 3 baseline 🟢; 3 fi
🔵 Blocked — waiting on external input
-->
## ⚪ [using-yt-tools-skill-body-venv-invocation] — SKILL.md не документирует venv-activation / full-path CLI invocation; concurrent сессия после `/reload-plugins` упёрлась в `command not found` на bare `yt-frames`.
**Observed (2026-05-20):** в concurrent CC-сессии (после `/reload-plugins` + Skill(using-yt-tools)) агент попытался Flow B напрямую — `yt-frames URL --timestamps ...` через Bash. Результат: `bash: yt-frames: command not found`. Далее `Get-Command yt-frames` пусто. Агент попытался `python -m pip install -e ~/projects/.common/lib/yt-tools/` в **системный** Python — wrong path (ломает global env, дублирует уже-настроенный venv в `.common/lib/yt-tools/.venv/`).
**Корень:** `pip install -e` в taзе `[yt-tools-impl]` положил entry-point'ы (`yt-transcript`, `yt-frames`, `yt-watch`, `yt-tools`) в `.venv/Scripts/` (Windows) / `.venv/bin/` (Linux/macOS), а не на user PATH. Без активации venv агент бинарь по имени не находит. SKILL.md body (Prereq / Inputs / Steps) этого требования не упоминает — обещает «вызови `yt-frames URL --timestamps T1,T2`», как будто на PATH. Имплементер в своей сессии случайно работал в активированном venv shell'е и проблему не увидел.
**Acceptance:**
- SKILL.md Prereq явный block (≥1 из):
- (a) активация venv: `& ~/projects/.common/lib/yt-tools/.venv/Scripts/Activate.ps1` (Windows PS) / `source ~/projects/.common/lib/yt-tools/.venv/bin/activate` (Linux/macOS),
- (b) full-path invocation: `& ~/projects/.common/lib/yt-tools/.venv/Scripts/yt-frames.exe URL ...`,
- (c) обе альтернативы с trade-off-комментом.
- Steps-примеры (Flow A + Flow B) обновлены: либо активация в первом шаге, либо full-path в каждом вызове. Не оставлять bare `yt-frames` в Steps.
- bump `version: 0.2.2``0.2.3` (PATCH — docs-fix без поведенческих изменений).
- `scripts/install.ps1 -Names using-yt-tools` пройден, новая версия в `~/.claude/skills/using-yt-tools/`.
**Status:** ready
**Where I stopped:** заведено по real-time observation в concurrent CC сессии (2026-05-20)
**Next action:** Edit SKILL.md Prereq + Steps; bump version; reinstall.
**Branch:** master
<!-- created-by: vitya@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-05-20 / via: local-file (gitea down) / origin: concurrent CC session post-/reload-plugins -->
---
## ⚪ [using-yt-tools-windows-powershell-path-doc-fix] — README warn про restart-shell-after-winget покрывает только git-bash subshell CC, та же проблема симметрично у PowerShell-subshell.
**Observed (2026-05-20):** в concurrent CC-сессии PowerShell-subshell не видел ffmpeg (`where.exe ffmpeg``INFO: Could not find files`), хотя ffmpeg уже установлен через `winget install Gyan.FFmpeg` на user PATH. Симметричная проблема: env унаследован от родительского shell процесса CC, до его рестарта новый user-PATH не подтягивается ни в bash-subshell, ни в PowerShell-subshell.
**Корень:** `[using-yt-tools-windows-path-doc-fix]` (закрыта 2026-05-20, README warn добавлен про bash-subshell) формулировка пропустила PowerShell-кейс. Subshell-семантика Windows process-env одинакова для обоих shell flavors — нужно покрыть оба.
**Acceptance:**
- README пакета `~/projects/.common/lib/yt-tools/README.md` warn-block расширен: явная пометка «restart CC требуется для **обоих** shell flavors внутри сессии — git-bash subshell И PowerShell subshell — потому что process-env унаследован от родительского CC-процесса».
- bump `~/projects/.common/lib/yt-tools/pyproject.toml` version `0.1.5``0.1.6` (PATCH — docs-only).
- commit в `.common`.
**Status:** ready
**Where I stopped:** заведено по real-time observation в concurrent CC сессии (2026-05-20)
**Next action:** Edit README warn-block; bump pyproject; commit.
**Branch:** master
<!-- created-by: vitya@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-05-20 / via: local-file (gitea down) / origin: concurrent CC session post-/reload-plugins -->
---
## 🟢 [using-yt-tools-install] — Install env deps (ffmpeg + python venv + 3 pip libs) for using-yt-tools on agent machine.
**Этапы:**