Вопросы, которые рецензенты действительно задавали.

Собрано из обратной связи до запуска. Каждый ответ — честный, а не маркетинговый.

Список FAQ

Чем SpecScore отличается от spec-kit?

spec-kit — это методология, процесс написания спецификаций.SpecScore — это формат хранения для спецификаций, которые вы пишете, плюс CLI для запросов и редактирования. Они сочетаются: spec-kit умеет производить файлы SpecScore, а расширение spec-kit, пишущее в формате SpecScore, уже в работе.

Берите spec-kit, когда нужен процесс. Берите SpecScore, когда нужны спецификации, которые ИИ-агенты могут линтовать, запрашивать и менять, не читая каждый файл в репозитории. Используйте оба, если нужно и то и другое.

Чем SpecStudio Skills отличаются от Superpowers и agent-skills?

По духу — похоже. Все три — это библиотеки навыков, которые ведут ИИ-агентов через ideate → specify → plan → implement. Разница механическая, не философская.

SpecStudio Skills пишут артефакты в формате SpecScore(определённая структура из Markdown + YAML) и вызывают CLIspecscore для запросов, линта и смены статусов. Superpowers и agent-skills в основном читают и пишут файлы напрямую из текста навыка.

Берите SpecStudio Skills, когда важен расход токенов: CLI возвращает структурированный ответ на запрос «все открытые фичи с нерешёнными вопросами» за один вызов, тогда как файловый навык, чтобы ответить на то же, читает N документов.

Зачем CLI — нельзя просто поставить навыки?

Навыки умеют читать и писать файлы. Они не могут надёжно:

  • обеспечивать ссылочную целостность по дереву спецификаций (ссылки разрешаются, ID уникальны, индексы остаются синхронными);
  • возвращать отфильтрованный список «открытых фич с нерешёнными вопросами», не читая каждый файл;
  • менять нужное поле статуса в нужный момент в каждом артефакте.

CLI даёт агентам один аккуратный вызов на задачу — так же, как jq даёт вам один аккуратный вызов для запроса к JSON. Одни только навыки расходуют больше токенов, чаще расходятся и забывают обновлять индекс.

Почему называется «SpecScore» — что он оценивает?

«Score» читается двумя способами, и оба намеренные.

Музыкальная партитура (score) структурирует партии, голоса и временные отношения. Открыв дерево SpecScore, его должно быть можно прочитать так, как дирижёр читает партитуру: иерархия, партии, ссылки — всё видно сразу.

Буквальная оценка качества. CLI-линтер — это детерминированная оценка (держится ли структура спецификации?).Навык /score— это AI-оценка: готовность артефакта от A до F с пообъектной обратной связью для автора. Половина «Score» в названии становится фичей, которую инструмент производит, а не только декларацией.

Покажите цифры по экономии токенов.

Измеренное сравнение бок о бок готовится и будет опубликовано до поста на Хабре — одна и та же задача («над чем мне работать дальше?»), запущенная дважды: один раз — обычный агент читает документы, второй раз — тот же агент вызывает CLI SpecScore. Подсчёт токенов и время до ответа для обоих случаев.

Пока эти цифры не приземлились — утверждение структурное: агент, запрашивающий у CLI открытые фичи и нерешённые вопросы, получает небольшой структурированный ответ. Тот же агент без CLI читает N документов — N часто исчисляется десятками. CLI-интерфейс спроектирован ровно так, чтобы избежать этого веерного чтения.

Есть ещё вопросы или более точная формулировка одного из этих? Откройте issue вspecscore/specscore — эта страница каноническая для FAQ и растёт из реальных вопросов рецензентов.

Спеки, которые проходят линтер.

или читать документацию

★ Поставьте звезду на GitHub — это помогает другим находить проект.GitHub stars

Нашли ошибку в переводе или знаете как улучшить эту страницу? Сообщите нам.