Об этом проекте

Jules Prompts — это подобранная библиотека машиночитаемых промптов задач, Agent Skills и фикстур с заложенными сбоями, предназначенная для агентов-кодировщиков. Название носит исторический характер; инструкции не зависят от конкретного харнесса и не привязаны к какому-либо продукту, такому как Jules, Claude Code, Codex или Cursor. Репозиторий организован в несколько слоёв: - `_prompts/`: канонический текст процедур, включая веб-сайт, JSON-индекс и MCP slash-команды. - `skills/`: тот же текст, отформатированный как Agent Skills, сгенерированный из `_prompts/`, готовый к копированию в `.claude/skills/` или `.agents/skills/`. - `fixtures/`: миниатюрные репозитории с заложенными дефектами для демонстрации того, как скиллы дают сбой. - `plugin/`: вся библиотека в виде устанавливаемого бандла с манифестом, скиллами и slash-командами. - `library.json`: машиночитаемый список всех процедур, их категорий и уровней (tier). Все сгенерированные выходные данные проверяются в CI побайтово, чтобы гарантировать их синхронность с исходником. Добавление нового формата вывода — это одна запись в списке `TARGETS` в `scripts/emit.py`. Процедуры классифицируются как `core`, если не помечены `status: legacy`. Основные (core) процедуры направлены на сбои, которые агенты действительно испытывают, тогда как устаревшие (legacy) процедуры — это универсальный текст задач из 2025 года, который остаётся полезным, но не является тем, что делает эту библиотеку уникальной. Библиотека включает постоянную доктрину для `AGENTS.md` в `harness/AGENTS.md`, чтобы гарантировать её срабатывание, когда ни один скилл не выбран. Руководства по началу работы представлены в `PROMPTS_GUIDE.md` (объясняет каждый промпт и рекомендуемую последовательность) и `ENVIRONMENT_SETUP.md` (подготовка репозитория к клонированию агентом, установке и тестированию). Варианты использования включают: - Как Agent Skills: скопируйте директории скиллов в `.claude/skills/` и вставьте `harness/AGENTS.md` в `AGENTS.md` проекта. - Как MCP-сервер: настройте сервер в `mcpServers`, чтобы предоставлять промпты как slash-команды в Claude Code, Claude Desktop, VS Code/Copilot Chat, Windsurf и Zed. Сервер читает репозиторий в реальном времени, а плейсхолдеры вроде `<PR_URL_OR_DIFF_RANGE>` предоставляются как аргументы. - Для людей: скопируйте тело файла промпта после YAML front matter и вставьте его во вход инструкций агента. - Для агентов: загрузите `https://jules-prompts.wecanuseai.com/prompts.json`, выберите промпт по заголовку/описанию/категории и получите отрендеренный промпт по его URL или прочитайте `_prompts/<slug>.md`. - На фикстурах: используйте `python scripts/score_fixture.py fixtures/unfailable-tests path/to/REPORT.md` для оценки фикстуры, с вердиктами holds/broken/skipped и строкой покрытия. Рекомендации по внесению вклада подчёркивают: добавлять промпты только для повторяющихся задач, которые ещё не покрыты, сохранять согласованность YAML front matter, писать инструкции, не зависящие от харнесса, перегенерировать скиллы, обновлять руководства и workflow, добавлять фикстуры для промптов, ловящих сбои, и проходить проверки целостности.