BF acpx-bridge-troubleshooting-guide
Решение проблем с таймаутом моста acpx и настройкой нескольких учетных записей Lark. Используется при возникновении проблем, таких как таймаут подключения acpx к Gateway, зависание initialize, ошибка WebSocket 1005, отсутствие gateway.token, ошибка конфигурации acpx, настройка нескольких ботов Lark, сбой разбора протокола ACP, неработающие маршруты bindings и т. д. Включает такие ключевые шаги, как создание файла token, исправление конфигурации acpx, обновление версии acpx, правильная настройка нескольких учетных записей Lark (использование структуры accounts вместо создания нового канала), использование команды openclaw config set вместо прямого изменения JSON с помощью jq.
машинный переводПоказать оригиналСкрыть оригинал«解决 acpx 桥接超时问题和 OpenClaw 飞书多账户配置。当遇到 acpx 连接 Gateway 超时、initialize 卡住、…»
解决 acpx 桥接超时问题和 OpenClaw 飞书多账户配置。当遇到 acpx 连接 Gateway 超时、initialize 卡住、WebSocket 1005 错误、gateway.token 缺失、acpx 配置错误、飞书多机器人配置、ACP 协议解析失败、bindings 路由不生效等问题时使用。包括创建 token 文件、修复 acpx 配置、更新 acpx 版本、正确配置飞书多账户（使用 accounts 结构而非新建 channel）、使用 openclaw config set 命令而非 jq 直接修改 JSON 等关键步骤。
Решение проблем с таймаутом моста acpx и настройкой нескольких учетных записей Lark.
Как процесс F 35/100 · Не запустится — Скилл ссылается на файлы, которых нет в архиве: scripts/gateway-token-check.sh, references/feishu-multi-account-config.md, references/acp-protocol-troubleshooting.md
Как улучшить
- Скажите в description, КОГДА применять скилл («используй, когда…», примеры запросов): это главный сигнал для агента.
- В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 8. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
description-no-whendescription не говорит, КОГДА применять скилл (нет "use when / используй когда") - предупреждение
missing-refссылка на отсутствующий файл: scripts/gateway-token-check.sh - предупреждение
missing-refссылка на отсутствующий файл: references/feishu-multi-account-config.md - предупреждение
missing-refссылка на отсутствующий файл: references/acp-protocol-troubleshooting.md
Процессный рейтинг: все десять параметров 35/100
- 0Инструменты и файлы. Не хватает 3 файла(ов): scripts/gateway-token-check.sh, references/feishu-multi-account-config.md, references/acp-protocol-troubleshooting.md
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 0Ошибки и развилки. Линейный процесс без обработки сбоев
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 20Когда включается. Не сказано, при каком запросе скилл включается
- 100Шаги. Шагов: 31
- 100Согласованность. Имя и обязательные поля на месте
- 100Стоимость исполнения. Тело инструкции 1241 токенов
- 100Повторный запуск. Изменяющих операций нет
- medium Тестов 4, и все положительные: нет ни одного случая «должен отказать» или «должен переспросить»
- low Среди тестов нет случая на инъекцию через данные
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Формат ответа не описан: модель каждый раз решает сама
- -218 эмодзи в инструкциях: шум для модели
- +1Лицензия не указана
- +2Инструкции на одном языке
- +3Длина description 277 символов: достаточно сигнала, не съедает бюджет
- +4Структура: 18 заголовков
- +3Пошаговые инструкции: 31 пунктов
- +4Есть примеры (9 блоков кода)
- +4Справочные файлы упоминаются в инструкциях (3 из 3)
- +3Все 3 скриптов описаны в инструкциях
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 65.