iii-observe — скилл для Claude Code и Cursor: наблюдатели и события
Скилл для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — учит агента подписывать одну iii-функцию на вызовы другой через iii.observe.
лицензия не указана 1 100 установок ★ 18 938 обновлён 2026-11-09
npx skills add iii-hq/iii --skill iii-observe -a claude-codeЧто делает iii-observe
Скилл покрывает весь цикл наблюдений в фреймворке iii: от простой связки iii.observe(a, b) до настройки фильтров, capture-полей и параметров вроде max_in_flight и expires_in_ms. Работает на TypeScript, Python, Rust, Go и в браузерном SDK.
Каждое событие в iii — это вызов функции: HTTP-запрос запускает http::on-request, тик cron — cron::on-tick, изменение строки — database::on-row-changed. Подписаться на событие значит наблюдать за соответствующей источниковой функцией с нужными args. Поле capture определяет, какие части вызова (вход, выход, ошибка, caller) дойдут до целевой функции: пустой capture срабатывает при успехе, но не передаёт данные; capture: ["error"] без input или output ловит только ошибки.
Если нужно написать собственный источник событий, скилл знает четыре хука: onObserverAdded, onObserverRemoved, onObservationMatch и onObservationDeliver. capture: [] без одного из input, output, error вернёт INVALID_ARGS — это поведение движка, не баг кода.
Какие задачи решает
- подписать функцию оповещения на успешные вызовы другой функции
- запустить обработчик на HTTP-запрос через
http::on-request - настроить cron-задачу через наблюдение за
cron::on-tick - отлавливать только ошибочные вызовы с фильтром по полю входа
- написать собственный источник событий с хуками
onObserverAddedиonObservationDeliver
Примеры запросов агенту
- Подпиши
alerts::big-orderна каждый успешный вызовorders::createчерезiii.observe - Настрой наблюдатель на
payments::chargeс фильтромinput.amount >= 500иcapture: ["error", "caller"] - Добавь HTTP-маршрут POST
/ordersчерезhttp::on-requestи привяжи к нему функциюorders::create
Как установить iii-observe
1Через Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-observe -a claude-code2Вручную: положить файлы
~/.claude/skills/iii-observe/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/iii-observe/
1Через Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-observe -a codex2Вручную: положить файлы
.agents/skills/iii-observe/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-observe -a cursor2Вручную: положить файлы
.cursor/skills/iii-observe/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install iii-hq/iii skills/iii-observe2Вручную: положить файлы
.github/skills/iii-observe/SKILL.md1Через Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-observe -a gemini-cli2Командой платформы
gemini skills install https://github.com/iii-hq/iii --path skills/iii-observeВручную: положить файлы
.devin/skills/iii-observe/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-observe -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об iii-observe
Как установить iii-observe в Claude Code?
Выполни npx skills add iii-hq/iii --skill iii-observe -a claude-code — скилл появится в ~/.claude/skills/iii-observe/SKILL.md.
Что делает скилл iii-observe?
Он объясняет агенту, как работает система наблюдений iii: как связать две функции через iii.observe, как подписаться на события HTTP, cron, очереди, состояния и базы данных, как настроить фильтры и capture, как написать собственный источник.
Какие языки поддерживает iii-observe?
TypeScript (Node и браузер), Python, Rust и Go — для каждого из них в скилле есть примеры вызовов iii.observe с фильтрами и capture.