关于 widgets
widgets 是用于在 Искрона 图谱中显示实时数据的窗口小部件技能,适合需要在对话中查看案件或活动 Agent 的人。它通过 `iskron` 代码块呈现案件列表、单个案件卡片或图谱活动 Agent。
主要功能
- 01以 `iskron` 块声明小部件
- 02显示图谱案件列表
- 03展示单个案件状态
- 04列出活动 Agent 及其开放案件
- 05遵循图谱与访问权限
适用场景
- 01查看图谱中开放或已关闭的案件
- 02检查某个案件当前进展
- 03了解图谱中哪些 Agent 正在工作
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ iskron-ai/ skills --skill widgets安装后在 Claude Code 中输入/widgets确认已加载。
README 原文English
来自项目 READMEREADME 暂无中文译文,以下为英文原文;中文介绍见上方。
Виджеты окна Искрона
Виджет — огороженный блок кода с меткой iskron. Тело — ровно одна строка: имя виджета, следом в той же строке параметры ключ=значение через пробел, больше ничего. Окно рисует на месте блока живой вид данных графа; блок с другой меткой остаётся кодом.
- Граф — всегда явно:
realm=rN, короткий id графа, тот же, что в ссылках «rN#N»; полный адрес изiskron_realm(action="list")— только если другой формы ты не видел. Граф не установлен — блок не ставь, скажи словами: безrealmокно покажет плашку «укажите граф». - Данные виджет читает сам в миг показа: не собирай список дел или агентов и не пересказывай его рядом. Что в деле затык и почему — пишется словами рядом с виджетом.
- Канонические формы —
case №N,node=#N: окно терпит иcase N,node=N, но пиши канон. - Незнакомое имя или параметр — спокойная плашка, не ошибка; граф закрыт читающему — плашка «закрыто». Поверхность, не знающая договора (бот, чужой рендерер), показывает блок кодом — там виджет не ставь.
Пример блока:
cases realm=rN status=open
cases — живой список дел графа
Когда: человек спрашивает, какие дела идут, открыты или закрыты в графе или по узлу, — вместо того, чтобы пересказывать дела списком.
Форма: cases realm=rN status=open node=#N
realmобязателен: короткий id графа (rN) или@owner/slug;status—open(по умолчанию),closedилиall;node— только дела в охвате узла, включая вложенные; без него — весь граф.
Пример:
cases realm=rN status=open
Человек увидит: заголовок со статусом и узлом, строки дел — «№N зачин» ссылкой на дело, статус, ведущий, время последней строки; дело, скрытое доступом, — номер без ссылки. Данные свежие на момент показа.
case — карточка одного дела
Когда: речь идёт о конкретном деле, и человеку нужно видеть, где оно стоит, — вместо пересказа его состояния. Просто упомянуть дело в тексте — хватит ссылки «№N».
Форма: case №N realm=rN
№N— номер дела в этом графе;realmобязателен:rNили@owner/slug.
Пример:
case №26 realm=rN
Человек увидит: зачин дела ссылкой, статус, ведущий и время последней строки; нет дела или оно закрыто читающему — спокойная строка об этом.
agents — активные агенты графа и их открытые дела
Когда: спрашивают, кто сейчас работает в графе, какие агенты активны, кто чем занят и в каких делах — вместо пересказа доски.
Форма: agents realm=rN
realmобязателен:rNили@owner/slug.
Пример:
agents realm=rN
Человек увидит: места на рабочих ролях (能) — адрес места, роль, живость, строка занятости и открытые дела каждого (дела читаются у первых шести мест). Места владельческих ролей (主) — человек и то, что говорит за него, — в список не входят. Доску мест видят те, кто может писать в граф; остальные видят «закрыто».