BB repo-explainer
Декодирует репозиторий GitHub **или локальный каталог кода** в отчет, не предназначенный для разработчиков, предоставляемый в виде готовой страницы HTML **И** документа Markdown. Получив URL репозитория GitHub или путь к локальному каталогу, этот навык подготавливает исходный код (быстрое клонирование для URL, на месте для локальных путей), сканирует ФАКТИЧЕСКИЙ исходный код (не только README) и создает два синхронизированных отчета, содержащих: обзор проекта, таблицу технологического стека, диаграмму архитектуры, таблицу ключевых модулей, диаграмму последовательности основного пользовательского потока, таблицу поверхностей API/CLI, таблицу сторонних зависимостей и раздел «что на самом деле делает этот проект простым языком». HTML оформлен и готов к печати; Markdown встраивает нативные блоки Mermaid и чисто вставляется в Feishu / Notion / GitHub. Каждое заключение подкреплено ссылками `путь:строка` — для URL GitHub (и локальных клонов с удаленным репозиторием github) ссылки отображаются как кликабельные постоянные ссылки, привязанные к SHA коммита; для локальных каталогов, не являющихся Git, они отображаются как моноширинный текст. АКТИВИРОВАТЬ, когда пользователь предоставляет URL `github.com/<owner>/<repo>` **ИЛИ** путь к локальному каталогу (абсолютный / относительный / с префиксом `~`) и запрашивает любой из следующих вариантов: «解读这个项目» (интерпретировать этот проект), «分析这个仓库» (анализировать этот репозиторий), «分析这个目录» (анализировать этот каталог), «讲讲这个 GitHub 项目» (расскажи об этом проекте GitHub), «帮我看下这个 repo / 这个文件夹做什么» (помоги мне понять, что делает этот репозиторий / эту папку), «explain this repo» (объясни этот репозиторий), «analyze this github project» (проанализируй этот проект GitHub), «analyze this folder» (проанализируй эту папку), «what does this repository do» (что делает этот репозиторий), «understand this codebase» (пойми эту кодовую базу), «画一下这个项目的架构» (нарисуй архитектуру этого проекта). НЕ АКТИВИРОВАТЬ для: приватных/внутренних URL GitLab, gist из одного файла или когда пользователь просто хочет запустить/установить проект (а не понять его). Режим локального каталога ВКЛЮЧЕН — включая монорепозитории (используйте `--subpath`) и еще не отправленные рабочие копии.
машинный переводПоказать оригиналСкрыть оригинал«Decode a GitHub repository **or a local code directory** into a non-de…»
Decode a GitHub repository **or a local code directory** into a non-developer-friendly report, delivered as BOTH a polished HTML page AND a Markdown document. Given either a GitHub repo URL or a local directory path, this skill prepares the source (shallow-clone for URLs, in-place for local paths), scans the ACTUAL source code (not just README), and produces two synchronized reports containing: project overview, tech stack table, architecture diagram, key module table, main user-flow sequence diagram, API/CLI surface table, third-party dependency table, and a "what this project actually does in plain language" section. The HTML is themed and print-ready; the Markdown embeds native Mermaid blocks and pastes cleanly into Feishu / Notion / GitHub. Every conclusion is backed by `path:line` references — for GitHub URLs (and local clones with a github remote), references render as clickable permalinks anchored to the commit SHA; for non-git local dirs they render as monospace text. TRIGGER WHEN the user gives a `github.com/<owner>/<repo>` URL **OR** a local directory path (absolute / relative / `~`-prefixed) AND asks any of: "解读这个项目"、"分析这个仓库"、"分析这个目录"、"讲讲这个 GitHub 项目"、 "帮我看下这个 repo / 这个文件夹做什么"、"explain this repo"、 "analyze this github project"、"analyze this folder"、 "what does this repository do"、"understand this codebase"、 "画一下这个项目的架构"。 DO NOT TRIGGER for: private/internal GitLab URLs, single-file gists, or when the user only wants to run/install the project (not understand it). Local-directory mode IS in-scope — including monorepos (use `--subpath`) and not-yet-pushed work-in-progress checkouts.
Декодирует репозиторий GitHub или локальный каталог кода в отчет, не предназначенный для разработчиков, предоставляемый в виде готовой страницы HTML И…
Как процесс B 71/100 · Почти готов — слабые места: результат и критерий готовности, повторный запуск, отчётность по ходу
Как улучшить
- Сократите description до 1024 символов.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 11. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- ошибка
description-longdescription 1621 символов, лимит 1024 - заметка
description-budgetdescription занимает 1621 из общего бюджета ~15000 символов на все скиллы
Процессный рейтинг: все десять параметров 71/100
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 30Повторный запуск. Изменяющих операций: 7, без проверки текущего состояния
- 60Инструменты и файлы. Используются инструменты (bash, web, git, node), но во frontmatter они не объявлены
- 70Входы и предусловия. Входные данные и предусловия перечислены
- 100Шаги. Шагов: 55
- 100Когда включается. Сказано, когда применять и когда не применять
- 100Ошибки и развилки. Развилок: 1, есть раздел про ошибки
- 100Согласованность. Имя и обязательные поля на месте
- 100Стоимость исполнения. Тело инструкции 3240 токенов
- low Ответ описан самодельной разметкой (12 тегов): типизированный вызов надёжнее
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Длина description 1620: рекомендуется 120–800 символов
- +3Формат ответа не описан: модель каждый раз решает сама
- -5В тексте остались TODO / заглушки
- -4Абсолютные локальные пути (C:\Users, /home/…): скилл не переносим
- +1Лицензия не указана
- +2Инструкции на одном языке
- +5В description 11 примера фраз-триггеров в кавычках
- +4Структура: 11 заголовков
- +3Пошаговые инструкции: 55 пунктов
- +4Есть примеры (8 блоков кода)
- +3Все 5 скриптов описаны в инструкциях
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 52.