agentleFS
Sign inStart free
irpsvirpsv/ai-bro/skills/bro-give-me-spec/SKILL.md

bro-give-me-spec

Skill9 starsChanged 12 days agoMITView on GitHub

Создаёт однозначную спецификацию результата без шагов реализации. Используй, когда пользователь хочет зафиксировать задачу и контекст, целевой результат, рамки и критерии приемки. Не используй для выбора решения, составления плана реализации, непосредственной реализации или ревью изменений кода.

The file

Create a free account to mount
Files
SKILL.md

Bro Give Me Spec

Твоя задача — создать спецификацию результата: зафиксировать, что и зачем должно измениться и по каким наблюдаемым условиям результат готов, не определяя шаги реализации. НЕ ПИШИ код и НЕ СОСТАВЛЯЙ шаги реализации.

ОБЩИЕ ПРАВИЛА

  • ОБЯЗАТЕЛЬНО соблюдай правила диалога!
  • ОБЯЗАТЕЛЬНО соблюдай порядок работы!
  • Спецификация ДОЛЖНА быть однозначной, без вариаций и открытых вопросов. Продуктовые неоднозначности НУЖНО решить с человеком.
  • Критерии приемки ДОЛЖНЫ покрывать целевой результат наблюдаемыми утверждениями. Способ проверки (автотест, ручная проверка, сборка и т.п.) в критерии НЕ указывай.
  • Спецификация не задаёт порядок написания тестов и реализации и не требует TDD.

ОГРАНИЧЕНИЯ / STOP

  • ЗАПРЕЩЕНО добавлять в спецификацию шаги, этапы, задачи исполнителя, код, diff, патчи, псевдокод. Существующие и новые пути, типы, классы и имена допустимы.
  • ЗАПРЕЩЕНО добавлять разделы сверх структуры шаблона. Раздел Принятые решения допустим только при закрытой договорённости о предмете работы: результате, рамках, критериях или подходе. Сведения о подготовке самого артефакта в раздел НЕ записывай.
  • ЗАПРЕЩЕНО придумывать факты или критерии. Неоднозначность результата, рамок или приемки ДОЛЖНА быть решена до готовности спецификации.
  • ЗАПРЕЩЕНО предлагать план реализации или /bro-give-me-plan как продолжение спецификации.
  • Когда спецификация сформирована и ревью пройдено, подскажи ровно один следующий шаг: /bro-do-it. Меню следующих шагов не предлагай.

ПОРЯДОК РАБОТЫ

  1. СОБЕРИ из кода и контекста сведения, необходимые для однозначного описания текущего состояния, целевого результата, рамок и проверок.
  2. ЗАПРОСИ недостающую информацию у человека. Закрытые развилки при необходимости готовь для раздела Принятые решения.
  3. ПРОВЕРЬ, что каждый изменяемый сценарий из целевого результата покрыт критерием приемки и что каждый критерий наблюдаем без описания способа проверки.
  4. ОПРЕДЕЛИ какой workflow нужно использовать, следуя правилам определения workflow.
  5. ПОДКЛЮЧИ файл с инструкциями выбранного workflow. СОБЛЮДАЙ все инструкции из выбранного workflow.

ПРАВИЛА ОПРЕДЕЛЕНИЯ WORKFLOW

Ниже описаны правила как определить какой workflow использовать. НЕ ЧИТАЙ файл с инструкциями до выбора workflow. ВЫБЕРИ workflow на основе критерия.

file-spec

Используй если:

  • создание новой спецификации

Файл с инструкциями: file-spec

delta-spec

Используй если:

  • внесение правок в спецификацию

Файл с инструкциями: delta-spec

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free