intake について
外部資料をИскрон グラフに取り込むエージェント向けのスキルです。issue、README、コード断片、会話を自動的に確定事実とせず、出典付きの主張として扱い、型の対応付け、重複排除、関連付け、段階的な照合を行います。
主な機能
- 01資料の形式をグラフノード型に対応付け
- 02出典と証拠の状態を記録
- 03書き込み前に意味的な重複を検索
- 04各ノードを出典とグラフ領域に関連付け
- 05グラフとの照合と現実との照合を区別
- 06取り込み範囲と除外対象を明示
活用シーン
- 01issue や RFC を追跡可能なグラフ記録に変換
- 02コードや文書から証拠の限界付きで主張を抽出
- 03他のエージェントやタスクへの伝達前に外部情報を照合
- 04過去の出来事について複数の出典を突き合わせ
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ iskron-ai/ skills --skill intakeインストール後、Claude Code で/intakeを入力して読み込まれたか確認します。
README(原文)English
プロジェクトの README よりこの README の日本語訳はまだありません。以下は英語の原文です。日本語の紹介はページ上部をご覧ください。
Впуск шабды в Искрон
Внешнее слово — issue, README, кусок исходников, разговор, RFC — это шабда: свидетельство с существованием вне графа. Оно ещё не твоё. Этот скилл впускает его как утверждение с происхождением, не как автоматически удостоверенный факт — отображённым в верный тип узла, помеченным провенансом, дедуплицированным, заякоренным — и затем сверенным. Когда его несут не в граф, а в дело или другому делателю, сверка с графом всё равно идёт прежде передачи (шаг 3).
Нить: шабда → сверка → тезис; given_as — по содержанию каждого утверждения, путь ding → sachverhalt не обязателен. Чужое становится своим через проверку, не через копирование: слово, впущенное массой как факты, затапливает граф мусором с видом авторитета.
Источник — адаптер; дисциплина впуска ниже — одна. product-roadmap соединяет её с GitHub-адаптером. Не впаивай источник в дисциплину.
Контракт адаптера источника
Добыть внешнее слово — работа адаптера, не этого скилла. Каким бы ни был источник (GitHub gh, чтение файла, транскрипт разговора), адаптер обязан отдать ядру, по каждому элементу:
- содержание — само утверждение (заголовок + обрезанное тело, или фрагмент прозы);
- форма — что это за высказывание (bug / feature-request / RFC / design-doc / факт-из-кода / решение) — по ней ядро отображает;
- провенанс — устойчивая обратная ссылка на исток (URL issue, путь+символ, «разговор 2026-…»), чтобы каждый узел мог
arose_fromк нему; - авторитет — кто свидетельствует, каким средством и в какой области (случайный issue vs решение владельца vs код, который можно прочесть сейчас); модус выбирается для выделенного суждения (шаг 2).
Не может адаптер дать провенанс — элемент не впускается: он лёг бы незаякоренным и невидимым.
Гранулярность парсинга — это структура графа: мелко нарежешь — много узлов, крупно — узлы-контейнеры. Режь по различениям, которые граф понесёт, а не по абзацам источника.
1. Отобрази форму в тип узла
Внешнее слово неоднородно; один элемент — не одна форма узла. Отображай по форме, с суждением агента (предложи → подтверди), никогда слепым импортом:
| Внешняя форма | Узел | Замечание |
|---|---|---|
| bug / сообщение о поломке | risk-вимарша, или 🔥 sachverhalt-инцидент, если уже сбылось | сообщение — утверждение, что что-то не так |
| фича / план / направление | bianhua («X становится Y») + ведущие вимарши — или kriya (anagata/chanda), если это одно деяние | одно желание — не превращение: сначала найди существующее превращение (assembly), не порождай по одному на элемент |
| RFC / design-обсуждение / открытый вопрос | samshaya-вимарша | узел — сам вопрос |
| заявленный факт о системе | phenomenon (given_as по тому, что это) | подлежит сверке до утверждения |
| labels / теги | подсказка жанра/контура, не узел | сигнал маршрутизации |
Именование, given_as и сами модусы — дисциплина скилла writing: вызывай его при каждой записи. Этот скилл решает, какую форму принимает внешнее слово.
2. Средство, заявка и исток
Ход, в котором агенты ошибаются. source_kind=shabda и arose_from — исток; модус — знание выделенного суждения. Не ставь модус по виду файла. Разведи: прочитанное (текст документа, кода, отчёта — видишь сам); сообщённое (наблюдение автора — для тебя «сообщили», с истоком); выведенное о предмете (по силе и независимости свидетельства); предполагаемое. Надёжность свидетельства существенна там, где на ней держится вывод, и не обнуляется внешним происхождением. Код как текст прочитан — его исполнение этим не наблюдалось. Содержание нормативного текста проверяется чтением самого текста. Предложение, план, RFC — предложение по содержанию, не «непроверенный факт». Онтика — по предмету, не по дате документа. Невоспроизводимое прошлое исследуется доступными свидетельствами: два пересказа одного измерения — одно свидетельство. Опровергнутое утверждение остаётся записью badhita — она учит, как не мыслить.
Воля владельца входит своим волевым модусом, только когда слово пришло от правомочного владельца (провенанс места и роли, не тело кадра) и в названной им области; пересказ его решения — сообщение о воле. Проверка исполнения этой воли — отдельная заявка.
Моделируй соответственно: attrs.source_kind="shabda", given_as по содержанию (шабда-документ как таковой — ding: вещь, существующая вне графа; имя — по содержанию, не по файлу: «⚙️ Брифинг factory-system-prompt», не «⚙️ factory-system-prompt.md»).
3. Дедуп до записи — и до передачи
Перед каждой вставкой — iskron_semantic_search(q=<утверждение фразой>, realm=…) против существующего графа (против почвы, не только прежнего бэклога). Дистанция около нуля — граф это уже несёт: свяжи или обнови, не дублируй. Сначала найди, потом пиши: провал впуска — N почти одинаковых узлов, по одному на пересказанный issue.
Передача — тот же гейт. Внешнее слово несут не только в граф: чужой разбор, фидбэк, письмо, пересказ отдают в дело, соседу или разносят по строкам. Прежде этого — сверка по каждому пункту: поиск по смыслу несколькими формулировками и чтение найденного — по entry (вход, шаг «по вопросу»), дела на найденных узлах — iskron_case(action="at", node=<узел>). У каждого пункта один ответ: «решено в #N», «открыто в #N у роли», «идёт в деле №N» или «в графе нет — вот вопрос». Решённое и идущее — ответом тому, кто принёс слово; в дело или соседу уходит только дельта — новое и открытое — со ссылками. Предел: слово, живущее лишь в деле (и решение, ещё не легшее в граф), поиск не находит — текстом по делам iskron_case не ищет; сверь дела на найденных узлах; узла предмета нет (граф отстал) — прочти открытые дела графа iskron_case(action="at") без node и спроси ведущего подходящего. Не нашёл и так — тогда «в графе нет». «Я только передаю, решают они» сверку не снимает: несверенный пункт тратит ход получателя на указание, где это уже решено.
4. Якори каждый узел к истоку
Впущенный узел без происхождения — слух. Каждому нужны:
arose_from→ провенанс (issue, файл, разговор) — трассируемый исток; провенанс живёт этим ребром иattrs, а кто впустил и по чьему слову —reasoningзаписи, не строкой в теле: тело несёт само утверждение;- дом его типа: вимарше —
vimarsha_ofв контур, о котором она (контур/феномен/крия, которых утверждение касается); феномену —context→ его контур.
Якорение — закон скилла inquiry (незаякоренная вимарша невидима): соблюдай при впуске, не задним числом.
5. Сверь — и объяви ступень
Впуск не закончен, когда утверждение записано, — он закончен, когда оно сверено. И у сверки есть ступени; «сверено» без названной ступени — не результат:
- Первая ступень — шабда против ГРАФА (этот скилл). Граф здесь — инструмент наблюдения: накопленное и ранее проверенное наблюдение мира, не сам мир. Срез — по вопросу: карточка
iskron_look— содержание и показанные связи; окрестностьiskron_orient(focus)— относящиеся вопросы и соседи;lens="trace"— поток предмета. Это не лестница и не три обязательных вызова: полный ответ на карточке достаточен для своей заявки; неполный срез — потолок, не «нет». - Вторая ступень — граф против МИРА — здесь не совершается: её несут крии свидетельствования (наблюдение перемены на её каноническом носителе). Совпадение шабды с графом НЕ есть подтверждение реальностью — это согласие слова с записанным. Закрывая вопрос словом «проверил», скажи, против чего сверял.
- Шабда о невоспроизводимом прошлом пратьякшей не сверяется в принципе — там сверка шабды шабдой с названными истоком, временным объёмом и зависимостью: схождение независимых свидетельств → pramanita (два пересказа общего наблюдения — не два наблюдения); вывод из документов при молчании прямых свидетельств → anumita; расхождение свидетельств → vyabhichara, не badhita. Это честный потолок рода, а не незавершённая сверка.
Затем градуируй:
- совпало — согласованность с записанным; модус меняется только у обоснованного суждения, не у заявки об исполнении;
- разошлось — различи предмет и стороны (ошибаться может и граф): прямой опровергающий случай —
vyabhichara, неразличённая несовместимость —samshaya;badhita— только опровергнутому тезису; сбывшееся — инцидентом; - модус просто сдвинулся → обнови модус записи.
6. Селективность — страж, не удобство
Никогда весь трекер, никогда «все доки». Объяви срез (открытые/размеченные, граница по дате, высокосигнальное подмножество), ограничь объём и скажи, что отброшено — молчаливый срез читается как «впустил всё». Отбор, модусы шабды и дедуп сдерживают впуск без разбора только вместе.
После записи
CHECKS: и not_orphan свежего феномена — по writing, «После записи»: прошей. Затем iskron_orient(lens="trace", focus=<seq>) на ключевых феноменах: жизненный цикл связался?