Инструменты, плагины, навыки и сценарии FoneClaw: как выбрать слой

Tool, Plugin, Skill, Workflow и Shortcut в одной карте

Инструменты плагины навыки сценарии FoneClaw легче понять через один вопрос: какой слой владеет изменением? Мы строим FoneClaw как Android phone agent, где настроенная модель понимает цель пользователя, а разные capability layers помогают выполнить ее безопасно и повторяемо. Эти слои не взаимозаменяемы. У каждого есть свой owner verb: Tool действует, Plugin добавляет, Skill направляет, Workflow упорядочивает, Shortcut запускает.

На странице возможностей FoneClaw мы описываем текущие слои продукта и 100+ built-in tools. В этой статье мы не перечисляем каталог, а даем decision model: выбирайте самый маленький слой, который действительно владеет изменением. Если нужен один Android-шаг — Tool. Если нужна новая capability — Plugin. Если нужно знание — Skill. Если нужен повторяемый порядок — Workflow. Если нужен быстрый запуск — Shortcut.

Атомарные Tools и устанавливаемые Plugins

Tool — это атомарная исполнительная единица. У него есть контракт: какие аргументы принимает, что делает, какой результат возвращает, какие permissions или approvals могут понадобиться, как выглядит ошибка. В FoneClaw tools работают через governed Android workflows и policy metadata. Официальная документация FoneClaw о tool catalog описывает явные контракты, visibility и approval controls. Для пользователя это означает: действие не растворяется в фразе «AI сделает», оно проходит через понятный инструмент.

Built-in Tools нужны для базовых возможностей агента: текущий экран, открытие приложений, поддерживаемые системные действия, задачи, workflows, shortcuts и другие управляемые области. Мы используем стабильную формулировку 100+ built-in tools, потому что каталог развивается. Важнее не число, а принцип: Tool — это место, где модельная просьба превращается в проверяемое действие.

Plugin — другой слой. Он добавляет capability через устанавливаемый пакет, подпись, проверку, permissions и собственные plugin-contributed tools. Plugin может принести новые действия, но он работает через explicit contract, Android permissions и FoneClaw approvals. Установка расширяет поверхность возможностей, а runtime controls продолжают решать, что можно выполнить сейчас.

Два практических примера помогают увидеть разницу. File Manager Plugin добавляет файловые операции, которые требуют отдельного installable Android package, доступа и preview/approval flow; подробный разбор есть в статье Плагин ИИ-агента для управления файлами Android: установка, доступ и безопасные операции. YouTube Downloader Plugin показывает другой тип installable capability; его контракт разобран в материале Бесплатный FoneClaw и локальный плагин загрузки YouTube на Android. В обоих случаях Plugin добавляет возможности, а Tool выполняет конкретные действия внутри поддержанного контракта.

Guidance, повторяемые процедуры и быстрые входы

Skill — это reusable guidance. Он помогает агенту понять, как вести определенный тип задач: какие правила учитывать, как структурировать ответ, какие проверки выполнить, какой стиль использовать, какие ограничения помнить. Официальный FoneClaw Skill Format описывает Skills как instruction packages с metadata. Важно: Skill направляет поведение, а не сам по себе получает Android authority.

Workflow — сохраненная ordered procedure. Он нужен, когда задача повторяется: подготовить встречу, проверить уведомления, открыть нужный набор экранов, собрать статус, настроить режим работы, создать заметку и напоминание. Официальный FoneClaw Workflow Format описывает workflows как saved ordered procedures. Workflow задает порядок, но выполнение шагов остается под tool contracts, permissions и approvals.

Shortcut — быстрый вход. Он нужен, когда цель частая и ее не хочется каждый раз формулировать заново. Shortcut может запускать команду, Workflow или привычный сценарий, но не делает действие бесконтрольным. Если внутри запуска есть чувствительный шаг, FoneClaw сохраняет approvals, stopping и permission recovery как часть исполнения.

Одна цель может существовать в трех слоях. Например, «подготовить встречу». Skill хранит правила: проверить календарь, DND, уведомления, заметки и нужный чат. Workflow хранит порядок: открыть контекст, включить режим, подготовить заметку, показать подтверждение. Shortcut запускает все это быстро перед созвоном. Если нужны общие примеры многошаговых Android-задач, используйте Как автоматизировать задачи Android одной голосовой командой; здесь мы фиксируем слой, который должен владеть каждым изменением.

Как слои возможностей FoneClaw соединяются в задаче

Реальный запрос редко использует только один слой. Пользователь говорит: «Подготовь телефон к встрече с клиентом». FoneClaw получает request и context. Skill может подсказать, что для встречи важны DND, громкость, календарь, заметки и видимые approvals. Workflow может дать сохраненный порядок шагов. Tool выполняет конкретные действия: проверить состояние, изменить volume, открыть приложение, сделать screenshot, подготовить заметку. Plugin может добавить дополнительную capability, если задача требует внешнего пакета.

Композиция не передает authority автоматически. Если Workflow включает действие, это действие все равно идет через Tool contract. Если Skill советует использовать файл, доступ к файлам все равно проходит через Android permission и plugin policy. Если Shortcut запускает задачу, он ускоряет вход, но не отменяет approvals. Такая дисциплина помогает FoneClaw оставаться понятным: быстрый путь не становится скрытым путем.

Внутренний маршрут может выглядеть так: request → context → Skill guidance → Workflow steps → Tool selection → Plugin capability → approval → execution → verification → recovery. Но это не единственный фиксированный routing path. Простая команда может сразу перейти к Tool. Новый доменный сценарий может начать со Skill. Повторяемый рабочий ритуал — с Workflow или Shortcut.

Эта модель хорошо сочетается с broader app capability ecosystem. Когда приложения открывают machine-callable capabilities, агенту становится проще выбирать структурированные действия вместо GUI-навигации. Архитектурный контекст раскрыт в статье App Intents и приложения, вызываемые машиной: что это значит для AI-агентов. Для FoneClaw главное правило остается тем же: слой выбирается по тому, кто владеет изменением.

Разрешения, approvals и владение данными по слоям

Инструменты и навыки ИИ-агента становятся безопасными только тогда, когда полномочия разделены. Android permission отвечает за системный доступ: микрофон, файлы, экран, уведомления, настройки, Bluetooth и другие категории. FoneClaw approval отвечает за действие в текущей задаче: отправить, изменить, удалить, применить, открыть внешний сервис. Plugin contract отвечает за то, какие capability, permissions, inputs, outputs и errors приносит установленный пакет.

Skill и Workflow содержат знания и порядок. Они могут описывать, что делать и как проверять, но runtime authority остается у инструментов, Android permissions и FoneClaw approvals. Это особенно важно для телефона: импортированный Skill может помочь с правилами, а сохраненный Workflow — повторить процедуру, но чувствительный шаг по-прежнему должен быть видимым и reviewable.

Data ownership тоже нельзя сводить к одному правилу. Built-in Tool может работать с текущим экраном или системным состоянием. Plugin может требовать собственные permissions и иметь свою data policy. Skill может содержать инструкции, а Workflow — шаги и параметры. Пользователь должен видеть, какой слой участвует, какие данные нужны, какой результат создается и как удалить или отключить лишнюю capability.

Для более глубокого security model полезна статья Безопасность навыков AI-агентов: почему телефону нужны проверки разрешений. В этой taxonomy достаточно помнить: установка, импорт или сохранение процедуры — это подготовка capability; выполнение чувствительного Android-действия проходит через runtime checks.

Три сквозных примера FoneClaw

Первый пример — DND setting. Пользователь говорит: «Включи режим встречи на час». Shortcut может быстро запускать эту частую цель. Workflow может хранить порядок: проверить календарь, включить DND, оставить важные уведомления, показать итог. Tool выполняет системное действие. Approval появляется, если изменение влияет на состояние телефона. Текущая доступная база FoneClaw уже поддерживает такие задачи: floating assistant, current-screen attachment, task continuity, approvals, stopping, permission recovery и quick actions. Актуальную сборку можно получить на странице загрузки FoneClaw.

Второй пример — meeting preparation. Skill задает правила: проверить время, уведомления, заметки и возможные follow-up. Workflow сохраняет ordered procedure. Shortcut запускает ее за минуту до встречи. Tools проверяют volume, DND, открывают нужные приложения, создают заметку или screenshot в поддерживаемом сценарии. Если permission отсутствует, FoneClaw использует recovery и возвращает пользователя к задаче.

Третий пример — plugin-backed file task. Пользователь просит: «Переименуй файлы встречи и покажи preview». Здесь Plugin добавляет файловую capability, Tool внутри plugin готовит preview, approval подтверждает изменение, execution применяет его, verification показывает результат. Подробный case study находится в статье Плагин ИИ-агента для управления файлами Android: установка, доступ и безопасные операции. Если похожую структуру нужно применить к media download, смотрите Бесплатный FoneClaw и локальный плагин загрузки YouTube на Android.

Во всех трех примерах слои не спорят. Shortcut запускает, Workflow упорядочивает, Skill направляет, Plugin добавляет, Tool действует, approval защищает, permission recovery возвращает задачу в рабочий маршрут.

Как выбрать правильный слой расширения FoneClaw

Выбирайте самый маленький слой, который владеет нужным изменением. Нужен один конкретный Android-шаг — используйте Tool. Нужна новая capability, которой нет в built-in surface, — выбирайте Plugin. Нужны reusable правила, стиль или domain guidance — создавайте Skill. Нужна повторяемая последовательность — сохраняйте Workflow. Нужен быстрый запуск частой цели — делайте Shortcut.

Типичные ошибки классификации выглядят так. Не стоит превращать Skill в исполнительный механизм: он направляет, а не нажимает. Не стоит делать Plugin ради короткой процедуры, если хватит Workflow. Не стоит помещать чувствительный step в Shortcut без approval; быстрый вход должен сохранять контроль. Не стоит дублировать Tool как Workflow, если нет порядка из нескольких шагов.

Начните с обратимого теста: Shortcut запускает Workflow «подготовка встречи», Workflow вызывает supported DND и volume tools, Skill дает правила проверки, а итог показывается пользователю перед применением. Если позже понадобится новая внешняя capability, добавьте Plugin. Для понимания broader machine-callable app layer возвращайтесь к App Intents и приложения, вызываемые машиной: что это значит для AI-агентов. Хорошая архитектура FoneClaw расширяется не количеством терминов, а ясным владением: кто направляет, кто добавляет, кто упорядочивает, кто запускает и кто выполняет.