Огляд zcode-smart-skill: протокол менеджера, записаний в одному Markdown-файлі
Skill координує свіжі контексти через ledger, незалежні тести, checkpoints і виконання. Сила - дисципліна; Markdown не забезпечує власні правила.
ГЛИБОКИЙ ОГЛЯД · КОД
Чотири файли і жодного рантайму. Це весь репозиторій, і в цьому суть. Головний артефакт - один великий `SKILL.md`, що перетворює здібного кодового агента на менеджера свіжих робочих контекстів. Стан іде через журнал `.smart/
Що тут вдало
- Проєкт вирішує провал довгого чату, що накопичує старі припущення й полірує поганий підхід. Свіжі workers читають обмежений brief і ledger. Менеджер планує, незалежний автор пише tests, інший виконує задачу, менеджер запускає. Done потребує artifact і зеленої перевірки.
- Source repository
Як це влаштовано
Primary agent планує й перевіряє. Fresh subagents роблять ideation, тести або одну задачу. Файли - шина. `task.md` зберігає мету, `plan.md` стратегію, `tasks.json` обмежує, `notes.md` несе уроки, `tests_spec.md` передує коду, `verify.log` містить запуски. Hard tasks можуть змагати ізольовані worktrees.
Десять розширень, один цикл
V2 додає adversarial tests, reflection, parallel racing, scrutiny, бюджети, моделі за ролями, backtracking, self-attack, workflow memory і строгий handoff. Кожне змінює конкретний файл або рішення.
Що огляд коду тут може і не може перевірити
Виконуваного коду майже немає. Протокол і MIT-ліцензія прозорі. Але benchmark-ефект саме skill не доведений: немає harness, корпусу, результатів чи CI. Дослідження мотивують частини, не комбінацію.
{"id":"implement-1","difficulty":"hard","status":"in_progress","done_when":"artifact exists and tests pass"}Оригінальний пояснювальний фрагмент журналу, а не дослівний файл проєкту.
Безпека і довіра
Brief називає ledger даними, не владою. Checkpoints не руйнівні, boundaries явні. Але user task копіюється дослівно, а захист залежить від агента. Потрібні зовнішні sandbox, permissions, path validation та isolation.
Дизайн як досвід розробника
ASCII-схема пояснює manager, workers і ledger. README показує цикл до встановлення та два прості шляхи. Audit trail дає бачити провали й verify output. Зміна вартості оголошується.
Де він слабкий
Потрібен host із subagents, файлами, командами та вибором моделей. Сумісність між permission systems не проста. Markdown не гарантує бюджет, isolation, safe paths, serialized merge чи тести. Pruning може стерти докази, racing множить ціну, auto-trigger може бути широким.
Як перевірити його чесно
Створіть публічний suite з фіксованим бюджетом. Порівняйте long-context, базовий ledger і ablation кожного розширення. Публікуйте pass rate, час, tokens, false done, conflicts і prompt-injection tests разом із ledgers.
Вердикт
Це сильна операційна інструкція, не framework. Кращі ідеї - незалежний автор тестів, execution як істина, bounded handoff і відмова від мертвих підходів. Слабкість - enforcement у прозі. Використовуйте з sandbox і вимагайте відтворювані результати.
Демо й автор
Окреме live demo не вказане. Артефакт - публічний код і `SKILL.md`.
Сильні сторони
- Незалежний автор тестів до реалізації
- Bounded ledger makes handoffs auditable
- Явний відкат і перевірка через виконання
Компроміси
- Markdown cannot enforce its own guards
- No benchmark harness or reproduced results
- Parallel races can sharply increase cost
Для кого: хости агентів, де вже є пісочниця, свіжі робочі контексти й надійне виконання команд.
Часті запитання
Що таке zcode-smart-skill?
Це Markdown-протокол із чотирьох файлів, що координує свіжі контексти coding agents через файловий ledger.
Це виконуваний framework?
Ні. Є інструкції, але немає runtime, benchmark harness, тестів чи CI.
Головна перевага?
Незалежні тести, bounded handoff, checkpoints і перевірка виконання спрощують аудит.
Reviewed source at commit b847694 · No separate live demo listed