OpeItcLoc03/claude-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(skills): session-handoff yaml desc, double-quote [v0.2.1]

Browse Source 
Bare-scalar description contained `: ` (colon-space) inside backticks
(`Триггер-строка CLAUDE.md ` + literal trigger-line containing `: `).
Strict YAML parser treated the inner `: ` as nested mapping → description
field dropped → harness fallback to H1 → skill listing showed
"session-handoff: session-handoff" (trigger phrases non-functional).

Fix: wrap entire description in double-quotes. Shrink 650→462 chars
(865→555 bytes) by moving substantive-commit heuristic, sliding-overwrite
detail, and project-scope clause to body Steps/Side/Failure sections
(already documented there). All 6 session-end triggers + 4 skip phrases
+ trigger-line preserved verbatim.

Bump 0.2.0 → 0.2.1 PATCH (frontmatter wording, no behavior change).
Closes [session-handoff-install]; unblocks [session-handoff-test-trigger].

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
vitya
2026-05-24 21:56:30 +03:00
parent 30330df63a
commit 90c5be7c88
3 changed files with 44 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
.tasks/STATUS.md
View File

@@ -1,5 +1,5 @@
# Task Board
_Updated: 2026-05-22 (interns-grep-audit-skill-updates closed 🟢 — using-interns v0.2.2→0.3.0 with 3 routing rows for `grep_audit` deterministic intern plus consistency adds; unblocks half of `[interns-grep-audit-review]`.)_
_Updated: 2026-05-24 (session-handoff-install закрыт 🟢 — fix description YAML `: ` ambiguity, bump 0.2.0→0.2.1, reinstall, listing рендерит полный description.)_
<!--
Canonical layout. One block per task. Per-task deep context lives in
@@ -1338,21 +1338,18 @@ Findings — отдельные follow-up tasks (`using-vds-ops-<gap>-fix` ил
---
## ⚪ [session-handoff-install] — Установить скил session-handoff в активный CC: запустить install.sh из ~/projects/claude-skills/, выполнить /reload-plugins, убедиться что скил активируется в новой сессии.
## 🟢 [session-handoff-install] — Установить скил session-handoff в активный CC: запустить install.sh из ~/projects/claude-skills/, выполнить /reload-plugins, убедиться что скил активируется в новой сессии.
**Источник дизайна:** ~/projects/.workshop/.archive/2026-05-24-session-handoff-skill.md (Round 1 + Round 2 resolved Q1-Q10).
**SKILL.md status:** v0.1.0, только skeleton (header + 6 empty sections). Тело каркаса дописывается отдельно (второй проход workshop-promote-brainstorm, source — архивный буфер). Install активирует скил даже с пустым каркасом — триггерится по description.
**SKILL.md status:** v0.2.1 (body full + YAML-fix). Install активирует скил по description.
**Status:** ready
**Where I stopped:** (not started)
**Next action:** 1. cd ~/projects/claude-skills
2. Запустить install.sh (PowerShell-эквивалент на Windows если нужно).
3. /reload-plugins в активной сессии.
4. Открыть новую CC сессию → /skills → убедиться что session-handoff listed.
5. Smoke: вставить в CLAUDE.md тестового проекта строку `session handoff: read on start, write on end` → перезапустить сессию → убедиться что скил активируется через trigger-line.
**Branch:** n/a
**Status:** done
**Where I stopped:** done
**Closed by:** install прошёл (`scripts\install.ps1 -Names session-handoff` → `~/.claude/skills/session-handoff/`); harness auto-discovered (без `/reload-plugins`) — listing рендерит полный description. **Bug найден и пофикшен**: исходный description (v0.2.0) содержал `: ` (colon-space) внутри bare-scalar YAML (`Триггер-строка CLAUDE.md \`session handoff: read on start, write on end\``) → strict YAML parser ломался → harness fallback на H1 (`- session-handoff: session-handoff` в листинге). Fix: wrap description в `"..."` double-quotes + shrink с 650→462 chars (865→555 bytes) убирая technical detail который уже в Steps body. Все 6 session-end triggers + 4 skip-phrases + trigger-line сохранены 1-в-1. Bump 0.2.0 → 0.2.1 PATCH (wording-only, поведение то же). Findings saved в memory: `feedback_skill_description_yaml_colon_gotcha.md` (новый entry), `feedback_skill_description_length_limit.md` (cross-ref добавлен). Acceptance step 5 (CLAUDE.md trigger-line activation smoke в новой сессии) — это работа `[session-handoff-test-trigger]`, не блокер этой таски.
**Branch:** master
<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-05-24T18:20:25.525Z -->
<!-- closed-by: vitya@DESKTOP-NSEF0UK / 2026-05-24 / install pipeline ✓; description rendering ✓ (YAML `: ` fix); test-trigger acceptance отдельной таской -->
---