BD feishu-doc-skill
Используйте, когда пользователь предоставляет ссылку на вики, docx, страницу базы знаний Feishu и хочет прочитать, обобщить, сравнить, извлечь контент, записать результат обратно в документ Feishu или вставить локальное изображение в документ Feishu. Этот навык сначала извлечет идентификатор документа из ссылки и в первую очередь прочитает основной текст через Feishu OpenAPI; при анализе требований он в первую очередь выведет Markdown, а при отладке структуры интерфейса — JSON.
машинный переводПоказать оригиналСкрыть оригинал«当用户提供飞书 wiki、docx、知识库页面链接,并希望读取、总结、比对、抽取内容、把结果写回飞书文档,或把本地图片插入飞书文档时使用。这…»
当用户提供飞书 wiki、docx、知识库页面链接,并希望读取、总结、比对、抽取内容、把结果写回飞书文档,或把本地图片插入飞书文档时使用。这个技能会先从链接中提取文档标识,优先通过飞书 OpenAPI 读取正文;做需求分析时优先输出 Markdown,调试接口结构时再输出 JSON。
Используйте, когда пользователь предоставляет ссылку на вики, docx, страницу базы знаний Feishu и хочет прочитать, обобщить, сравнить, извлечь контент…
Как процесс D 46/100 · Процесс не доведён — слабые места: результат и критерий готовности, когда включается, входы и предусловия
Чем это грозит
Находки средней серьёзности: скорее всего скилл честный, но прочитайте, что именно насторожило сканер.
Ниже описан худший случай для этой категории. Здесь находка средней серьёзности: guard увидел признак, но не доказательство.
Инструкции или скрипты отправляют данные наружу: переменные окружения, ключи, содержимое файлов, историю чата. Вы можете не заметить этого в диалоге, потому что агент выполнит отправку как «часть задачи».
Если отправка не нужна для задачи, уберите её: каталоги помечают такие скиллы как подозрительные и снимают с выдачи. Если нужна, назовите адрес явно, объясните, что именно уходит, и дайте пользователю выключатель.
Как улучшить
- Скажите в description, КОГДА применять скилл («используй, когда…», примеры запросов): это главный сигнал для агента.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 3
✓ Критических и высоких находок нет
Средние и низкие: 3
-
средняя Утечка данных
net-credential-usescripts/insert_feishu_local_image.js:51Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис)const response = await fetch(`${BASE_URL}/docx/v1/documents/${docToken}/blocks/${docToken}/children`, { -
средняя Утечка данных
net-credential-usescripts/insert_feishu_local_image.js:100Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис)const response = await fetch(`${BASE_URL}/docx/v1/documents/${docToken}/blocks/${blockId}`, { -
средняя Утечка данных
net-credential-usescripts/insert_feishu_local_image.js:120Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис)const response = await fetch(`${BASE_URL}/docx/v1/documents/${docToken}/blocks/${docToken}/children`, {
Просканировано файлов: 12. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
description-no-whendescription не говорит, КОГДА применять скилл (нет "use when / используй когда")
Процессный рейтинг: все десять параметров 46/100
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 0Ошибки и развилки. Линейный процесс без обработки сбоев
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 20Когда включается. Не сказано, при каком запросе скилл включается
- 60Инструменты и файлы. Используются инструменты (node), но во frontmatter они не объявлены
- 100Шаги. Шагов: 34
- 100Согласованность. Имя и обязательные поля на месте
- 100Стоимость исполнения. Тело инструкции 380 токенов
- 100Повторный запуск. Изменяющих операций нет
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Формат ответа не описан: модель каждый раз решает сама
- +4Нет примеров входа/выхода
- -2Ссылки на localhost: у другого пользователя не заработает
- +1Лицензия не указана
- +2Инструкции на одном языке
- +3Длина description 142 символов: достаточно сигнала, не съедает бюджет
- +4Структура: 5 заголовков
- +3Пошаговые инструкции: 34 пунктов
- +3Все 6 скриптов описаны в инструкциях
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 69.