Vision skill
Скилл пишет VISION.md по истории ваших PR и коммитов, проверяет его трудными вопросами и дорабатывает вместе с вами на интерактивной доске
- 334 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Скилл читает историю репозитория и тексты PR через `gh` или `gh-axi`, то есть обращается к GitHub от вашего имени
- Доска запускается командой `npx -y lavish-axi`: пакет скачивается из npm и выполняется на вашем компьютере
- Агент создает или правит `VISION.md` в репозитории
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/vision-skillОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скилл читает историю репозитория и тексты PR через `gh` или `gh-axi`, то есть обращается к GitHub от вашего имени
- Доска запускается командой `npx -y lavish-axi`: пакет скачивается из npm и выполняется на вашем компьютере
- Агент создает или правит `VISION.md` в репозитории
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл `vision` пишет для репозитория файл `VISION.md`: проверяемую политику того, что проект принимает и от чего отказывается. Он запускается командой `/vision` внутри нужного репозитория или `/vision owner/repo`, а также по просьбе написать или уточнить видение проекта. Сначала агент изучает данные: читает описание проекта, архитектуру и заявленные нецели, затем берет от 30 до 100 заголовков слитых PR автора и читает полные тексты 8–15 из них. Если PR недоступны, он идет по истории коммитов в основной ветке. Из этого собирается внутренний лист доказательств: каждая строка черновика должна опираться на реальные PR, коммиты или файлы. По листу агент пишет черновик на 40–70 строк: смысл проекта, 3–6 разделов принципов, нецели и два итоговых теста, когда изменение подходит и когда ему стоит сопротивляться. Затем придумывает 8–12 гипотетических предложений на спорных границах, где можно ответить и да и нет, например соблазнительная функция не по миссии или расширение на новых пользователей. Если ответ автора предсказуем, вопрос заменяется. Вопросы собираются на доске из шаблона `review-template.html` и стилей `review.css`: черновик виден целиком слева, карточки выдаются по одной справа. Доску запускает `npx -y lavish-axi`. Каждый ответ агент вплетает в текст `VISION.md` и отмечает в журнале правок. Если `VISION.md` уже есть, скилл работает в режиме дельты и предлагает только отдельные правки на основе свежих данных.
Для кого. Для авторов и мейнтейнеров открытых проектов, которым нужен письменный критерий, по которому они, участники и агенты принимают или отклоняют изменения.
Подходит, если
- К проекту приходят предложения, и вы каждый раз заново объясняете, почему одни функции принимаете, а другие нет
- Нужен `VISION.md`, на который можно сослаться при отказе в PR
- Старый `VISION.md` устарел, и надо добавить в него то, что проект сделал за последнее время
- В репозитории работают кодовые агенты, и им нужен короткий документ о том, что проект принимает и от чего отказывается
- Нужно проверить собственное видение на спорных примерах до того, как его опубликовать
Не подходит, если
- У проекта нет читаемой истории PR или коммитов: скилл остановится и не станет придумывать ваши ценности
- Нужна дорожная карта, список функций или рекламное описание: правила скилла запрещают такие разделы в `VISION.md`
- Вы не готовы отвечать на трудные вопросы: вердикты по карточкам может дать только автор, а молчание скилл за согласие не считает
- В среде нельзя запустить `npx` и открыть страницу в браузере: без этого доска не заработает
- Нужно описание продукта для пользователей: `VISION.md` рассчитан на рецензента, который решает, принять изменение или нет
Пример запроса к агенту
Помоги написать VISION.md для этого репозитория по моим слитым PR и проверь его на спорных предложенияхОграничения
- Для работы нужен доступ к репозиторию и его истории: слитые PR через `gh` или `gh-axi`, а без них журнал коммитов основной ветки.
- Доска запускается через `npx -y lavish-axi` без отдельной установки, поэтому пакет скачивается из npm при первом запуске. Если запуск не удался, скилл сообщает о блокировке.
- Результат зависит от качества истории: по правилу скилла каждый принцип должен опираться на конкретные PR или коммиты, и при скудной истории документ получится коротким.
- Скилл не одобряет документ за автора. Утверждение, ответы на карточки и решение о коммите остаются за вами.
- Репозиторий небольшой: в нем `SKILL.md`, шаблон доски и стили, а тестов и примеров запуска нет. Образец результата автор показывает по ссылке на `VISION.md` другого своего проекта. Лицензия MIT.
Как отключить. Удалите папку `vision` из папки скиллов агента: для глобальной установки через `npx skills add -g` это папка скиллов в вашем домашнем каталоге. Созданный `VISION.md` в репозитории остается, его можно удалить как обычный файл.
Частые вопросы
Что такое VISION.md и чем он отличается от README?
По формуле скилла это политика приема изменений: на что проект существует, какие у него 3–6 принципов, что в него не входит и когда изменение подходит или ему нужно сопротивляться. Рецензент, который не видел доски, должен принять или отклонить PR по одному этому файлу. Дорожной карты, списка функций и рекламы в нем быть не должно.
Откуда скилл берет ценности проекта?
Из ваших слитых PR: от 30 до 100 заголовков и 8–15 полных текстов. Он извлекает повторяющееся, например что вы строите, от чего отказываетесь и какие ошибки чините в корне. Если PR недоступны, скилл читает журнал коммитов основной ветки. Общие добродетели вроде «мы ценим качество» запрещены, пока история не подтверждает их.
Что за гипотетические вопросы на доске?
Их 8–12 на каждое видение. Это конкретные предложения изменений на границе принципов: соблазнительные функции не по миссии, столкновения вроде простоты и возможностей, скользкие склоны и расширение на новых пользователей. Для каждого скилл излагает обе стороны, и вы выносите вердикт, который попадает в текст документа.
Что будет, если VISION.md уже есть?
Скилл включает режим дельты. Существующий файл на основной ветке считается утвержденной основой, а скилл предлагает построчные правки по более свежим данным, каждую можно принять отдельно. Конкурирующий документ он не создает.
Куда попадают ответы с доски?
Только в текст `VISION.md`: рассуждения вплетаются в прозу, а сами вопросы, номера карточек и протоколы доски в репозиторий не коммитятся. Если рядом лежит старый файл `VISION-ANSWERS.md`, скилл переносит его содержание в `VISION.md`, удаляет файл и убирает ссылки на него.
Как оформлен готовый документ?
Одно предложение на строку, настоящее время, простые дефисы вместо длинных тире и объем в страницу-две. Образец структуры: вступление о том, зачем существует проект, разделы принципов, раздел нецелей, и два завершающих теста о соответствии и сопротивлении.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл адаптации научной статьи под журнал: по набору опубликованных статей строит правила письма и правит рукопись по разделам с журналом правок
Скилл paper-spine: по теме, материалам и данным ведет научную статью от поиска литературы и текста до иллюстраций, рецензии и файлов Word, LaTeX и PDF
Learn from materials
learn-from-materials
Скилл превращает книги, PDF, презентации и документы в проверяемую базу знаний и интерактивную учебную страницу с источниками, схемами и самопроверкой
Скилл ведет агента от темы до обзорной статьи для arXiv в LaTeX IEEEtran: план на согласование, проверка каждой ссылки по живому источнику, сборка PDF
Скилл верстает по шаблонам резюме, одностраничники, письма, отчеты и слайды в PDF, PNG и PPTX и проверяет результат скриптами до выдачи
Скилл собирает презентацию из статьи, отчета или заметок как серию цельных слайдов-картинок и склеивает их в pptx
Коротко о README
Описание открывается вопросом о том, от чего проект отказывается. Затем идут четыре тезиса: доказательства из истории, проверка трудными гипотезами, оформление доски и единый документ вместо протоколов. Дальше следуют быстрый запуск в две команды, требования к доступу, схема из семи шагов, таблица способов вызова, структура пакета и команды для локальной проверки. Ссылка на `VISION.md` проекта firstmate служит образцом результата.
Бейдж для README
Исходный SKILL.md
---
name: vision
description: >
Draft and stress-test a VISION.md for a repository, then iterate with the
author on an interactive review board until approved. Use on /vision or when
asked to create or refine a project vision.
user-invocable: true
metadata:
short-description: "Evidence-mined, stress-tested VISION.md for any repo"
---
# /vision
You are running the **vision** skill. Produce a VISION.md the author can
approve: an acceptance policy for the project's future, grounded in what they
actually build, and sharpened by hypotheticals they answer on an interactive
review board.
VISION.md is the only committed alignment surface. A reviewer who has never
seen the board must be able to accept or resist a change from it alone.
This is not a writing exercise. Follow this file top to bottom.
## Host requirement
You need read access to the target repository and its real history:
- Prefer merged-PR history via a GitHub-class CLI (gh, gh-axi).
- If PRs are not accessible, fall back to git commit history on the default
branch (git log): titles and messages still reveal what the author builds.
- Only if no real history is readable at all, **stop** and say so. Never
fabricate the author's values, PR titles, or evidence. A vision built on
invented evidence is worse than no vision.
The review loop runs on lavish-axi, executed directly through
`npx -y lavish-axi` - no install requirement. Simply try to launch it, and
report a blocker only if the launch itself fails.
## Hard rules
1. **Evidence over vibes.** Every principle in the draft must be traceable to
concrete evidence: named PRs or commits, files, docs, or reasoning the
author approved into VISION.md. Generic engineering virtues ("we value
quality") are banned unless the history demonstrates them specifically.
2. **Check for an existing VISION.md first.** If one exists on the default