AIGuide Skills
Два скилла AIGuide: диаграммы draw.io из текста с экспортом в PNG и SVG, а также стандарты Java и Spring Boot
- 713 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- drawio-chart создает файлы .drawio в проекте и запускает команду drawio для экспорта
- java-coding-standards сам ничего не запускает, но при рефакторинге агент правит Java-код по его правилам, и такие изменения стоит смотреть в диффе
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/aiguide-skillsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- drawio-chart создает файлы .drawio в проекте и запускает команду drawio для экспорта
- java-coding-standards сам ничего не запускает, но при рефакторинге агент правит Java-код по его правилам, и такие изменения стоит смотреть в диффе
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AIGuide — китайскоязычный учебник по разработке с ИИ, и в его папке skills лежат два устанавливаемых скилла для Claude Code, Codex и Cursor. Каждый скилл — отдельный каталог с SKILL.md и файлом agents/openai.yaml, подробные правила вынесены в references и подгружаются по необходимости. drawio-chart превращает описание в файл .drawio: блок-схемы, архитектурные схемы, диаграммы последовательности, ER, состояний и ментальные карты. По просьбе скилл экспортирует PNG, SVG или PDF командой drawio, а исходный .drawio оставляет. Если дать ему статью, он выберет 2–6 структур и сделает по странице на каждую в одном файле. Когда drawio CLI на машине нет, скилл сообщает об этом и возвращает команду для ручного экспорта. java-coding-standards дает рабочую памятку для Java 17 и новее и Spring Boot. Он задает формат по Google Java Style, разделение на Controller, Service, Manager и DAO, объекты Form, VO, DTO и BO, правила для транзакций, исключений, логов, пулов потоков, безопасности и тестов. Если в репозитории есть AGENTS.md, CLAUDE.md, Checkstyle или Spotless, их правила приоритетнее. Скилл помогает писать и рефакторить код, проводить ревью и отвечать на вопросы о стандартах.
Для кого. Для разработчиков и технических авторов, которым нужны диаграммы draw.io из текста, и для Java-команд, где агент пишет Spring Boot по единым правилам.
Подходит, если
- Для технической статьи нужны схемы, и из текста надо получить несколько страниц в одном файле .drawio
- Нужна архитектурная схема микросервисов с шлюзом, Redis, MySQL и Kafka с экспортом в PNG
- Нужны диаграмма последовательности вызовов, ER-диаграмма таблиц или схема состояний заказа
- Агент должен проверить pull request на Spring Boot: слои, границы транзакций, обработку исключений, покрытие тестами
- Команде нужны единые правила для Entity, Form, VO, DTO и BO, которые агент соблюдает при генерации кода
Не подходит, если
- Хватит кода Mermaid: drawio-chart создает файлы .drawio и для одного Mermaid избыточен
- Нужна растровая иллюстрация или постер: скилл строит структурированные диаграммы
- Проект на Kotlin, Go или другом стеке: правила java-coding-standards рассчитаны на Java 17 и новее и Spring Boot
- Вы хотите навязать правила скилла вопреки конфигурации репозитория: AGENTS.md, CLAUDE.md и Checkstyle он ставит выше себя
Пример запроса к агенту
Используй $drawio-chart и нарисуй схему микросервисов с шлюзом, сервисами пользователей и заказов, Redis, MySQL и Kafka, экспортируй в PNGОграничения
- Экспорт в PNG, SVG и PDF требует установленного drawio CLI. Без него скилл отдает только .drawio и подсказывает команду.
- Тексты SKILL.md и справочных файлов на китайском, поэтому часть формулировок скиллов придется читать в переводе.
- Правила java-coding-standards рассчитаны на Java 17 и новее и Spring Boot со слоями Controller, Service, Manager и DAO. Если своих правил в репозитории нет, скилл предлагает адреса вида /module/submodule/action вместо RESTful.
- В репозитории нет файла лицензии.
- Ссылки на каталоги в skills/README.md ведут на локальные пути автора, поэтому опирайтесь на команды установки.
Как отключить. Удалите каталоги drawio-chart и java-coding-standards из папки скиллов агента: .claude/skills для Claude Code, .agents/skills или ~/.codex/skills для Codex. Уже созданные файлы .drawio и экспортированные картинки остаются на диске.
Частые вопросы
Как поставить drawio-chart в Claude Code?
Выполните npx skills add Snailclimb/AIGuide --path skills/drawio-chart и перезапустите агента. Затем напишите, например: «Используй $drawio-chart, сделай схему входа пользователя и экспортируй в PNG». Название скилла в запросе помогает ему сработать с первого раза.
Как поставить скиллы AIGuide в Codex?
Запустите install-skill-from-github.py из ~/.codex/skills/.system/skill-installer/scripts с параметрами --repo Snailclimb/AIGuide и --path skills/drawio-chart, для Java-правил укажите skills/java-coding-standards. После установки перезапустите Codex.
Нужен ли draw.io, чтобы получить PNG?
Для экспорта нужна команда drawio в системе. Скилл проверяет ее через which drawio или where drawio и запускает drawio -x -f png -e -b 10 -o файл.drawio.png исходник.drawio. Без команды вы получите только .drawio и подсказку, как экспортировать вручную.
Какие диаграммы умеет рисовать drawio-chart?
Блок-схемы, архитектурные схемы, диаграммы последовательности, ER-диаграммы, схемы состояний и ментальные карты. Файлы получают суффиксы вида -flow, -arch, -seq, -er, -state и -mind, например login-flow.drawio. По статье скилл строит несколько диаграмм как страницы одного файла.
Что делает java-coding-standards, если в проекте свои правила?
Уступает им. Если AGENTS.md, CLAUDE.md, настройки Checkstyle или Spotless и соседний код расходятся со скиллом, действует правило репозитория. Скилл указывает на расхождение, только когда оно влияет на результат.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыКоллекция скиллов Mindrally
Claude Code Skills Collection
Более двухсот скиллов с правилами кода под фреймворки и языки, переделанных из Cursor rules в формат SKILL.md
Маркетплейс Claude Code из 19 плагинов и 76 скиллов по фронтенду, бэкенду, DevOps и безопасности с командой сборки цепочек
Claude Code Skills, китайский набор
Claude Code Skills 中文精选集
Набор из 21 собственного скилла для Claude Code с китайским выводом: ревью кода, README, тесты API, рефакторинг, профилирование
Личный набор автора: общие правила для агентов и десятки скиллов для GitHub, браузера, macOS, сообщений и релизов, плюс скрипт синхронизации
Одиннадцать скиллов для Claude Code и Codex: аудит тестов, очистка git worktree, страницы планов, расшифровка записей экрана и вход через 1Password
Правила для агентов по книгам о программировании
AI agents Rules / Skills from Programming Books
Скиллы и правила AGENTS.md по классическим книгам: Clean Code, Refactoring, DDD, Clean Architecture, DDIA и другим
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| AIGuide Skills (эта запись) | нет | 713 | |
| drawio-skill | нет | 10 445 | делает draw.io диаграммы из текста, кода, Terraform, Kubernetes, SQL и OpenAPI, правил для Java в нем нет |
| claude-code-java | нет | 761 | большой набор Java-скиллов для ревью, Spring Boot, JPA и миграции версий, без диаграмм |
| spring-boot-skills | нет | 330 | учит агента писать Spring Boot по конвенциям и шаблонам вашего проекта, диаграмм не рисует |
Коротко о README
Главный README представляет AIGuide как открытый учебник для тех, кто строит приложения на LLM, агентах, RAG и MCP, и ведет на сайт javaguide.cn с материалами. Раздел Agent Skills перечисляет два скилла и две команды установки: через npx skills и через установщик Codex. Дальше идут порядок чтения (основы моделей, RAG, агенты, проектирование систем), дорожные карты и подборки вопросов для собеседований. Отдельный skills/README.md повторяет установку и дает пример запроса для каждого скилла.
Бейдж для README
Исходный SKILL.md
--- name: drawio-chart description: Draw.io 配图专家：用于生成和导出 `.drawio` 图表。在用户要求 draw.io、diagrams.net、流程图、架构图、时序图、ER 图、状态图、思维导图，或明确提到 `.drawio`、PNG、SVG、PDF 导出、技术文章配图时使用。默认输出专业技术风格，并遵循 floracat-architecture-diagram 的视觉规范。 --- # Draw.io 配图专家 这个 skill 负责把用户的图表需求转成 `.drawio` 文件，并在需要时导出为 PNG、SVG 或 PDF。 主文件只保留任务路由、工作流和验收规则。详细样式、XML 模板、导出命令和示例按需读取 `references/`。 ## 什么时候使用 在这些场景下优先使用本 skill： - 用户明确要求 `draw.io`、`diagrams.net` 或 `.drawio` - 用户要求生成流程图、架构图、时序图、ER 图、状态机图、思维导图 - 用户希望把图导出为 PNG / SVG / PDF - 用户要给技术文章、教程、系统设计文档配图 - 用户给出一篇文章，希望抽取多张技术图并放进同一个 draw.io 文件 不适合本 skill 的情况： - 用户只想要 Mermaid 代码，不需要 `.drawio` - 用户需要的是位图插画、海报或白板风正文配图，而不是结构化图表 - 用户只是讨论图表思路，还不想真正生成文件 ## 参考路由 按任务需要读取对应参考文件，不要默认把所有参考内容都塞进上下文： | 需求 | 读取文件 | | --- | --- | | 颜色、字体、节点语义、连线风格、视觉统一规范 | `references/style-spec.md` | | XML 结构规则、文本标签规则、节点/连线模板、不同图表类型的结构建议 | `references/xml-and-layout.md` | | 导出命令、文件命名、打开方式、交付规则 | `references/export-and-files.md` | | 常见提示词、单图/多图文章配图示例、批量页面生成方式 | `references/use-cases.md` | ## 核心规则 - 默认先生成 `.drawio` 原生文件，再根据用户要求决定是否导出。 - 如果用户明确要求导出 PNG / SVG / PDF，仍然先保留 `.drawio` 作为源文件，除非用户明确要求删除。 - 输出图表时，优先保证信息结构清晰，再保证视觉统一，不要为了“好看”牺牲可读性。 - 图表中的 `mxCell.value` 默认使用纯文本，避免嵌入 HTML 标签。 - 连线标签保持短小；长说明优先放到节点里或旁注节点里。 - 能不解释基础概念就不解释，把上下文留给真正影响绘图结果的约束。 ## 图表类型选择 按内容结构选择图表，不要机械套模板：