form-visual-requirements

Name: form-visual-requirements
Author: SteelMorgan/1c-agent-based-dev-framework

$npx mdskill add SteelMorgan/1c-agent-based-dev-framework/form-visual-requirements

Analyzes 1C form screenshots against visual layout and usability checklists to ensure compliance with design standards.

Helps developers verify form alignment, grouping, and element clarity in 1C applications.
Integrates with visual-check for analyzing screenshots to assess form design.
Uses predefined criteria like grid alignment, field widths, and tab order to evaluate forms.
Presents results as a checklist with actionable recommendations for improvements.

SKILL.md

.github/skills/form-visual-requirementsView on GitHub ↗

---
name: form-visual-requirements
description: Чек-лист и критерии проверки компоновки и удобства форм 1С. Используй для анализа скриншотов из visual-check.
---

# Визуальные требования к формам

Используй этот чек-лист для проверки форм 1С.

## 1. Разметка и выравнивание

- [ ] **Выравнивание**: элементы выровнены по сетке, без эффекта «лесенки».
- [ ] **Группировка**: логически связанные поля объединены в группы (рамка, страница).
- [ ] **Пустоты**: нет больших пустых областей (>150px), если это не задумано.
- [ ] **Ширина полей**:
  - `Код`, `Номер`, `Дата` — узкие.
  - `Описание`, `Комментарий`, `Адрес` — широкие (растянуты).
  - Колонки табличных частей — «Авто ширина» или явная ширина для заполнения пространства.

## 2. Элементы и подписи

- [ ] **Подписи**: у всех полей есть подписи (или явно указано `TitleLocation=None`).
- [ ] **Обрезание**: подписи и значения не должны обрезаться троеточием («…») при наличии места.
- [ ] **Надписи флажков**: подпись флажка должна быть понятной (например, «Активен», а не просто чекбокс).
- [ ] **Командная панель**: меню «Ещё» не должно скрывать основные действия.

## 3. Удобство использования

- [ ] **Порядок табуляции**: фокус перемещается слева направо и сверху вниз.
- [ ] **Ключевые поля**: важные идентификаторы (Наименование, Код, Дата) — в левом верхнем углу.
- [ ] **Табличные части**: разумная высота (минимум 5–10 видимых строк).
- [ ] **Горизонтальная прокрутка**: строго запрещена для основной области формы (вертикальная допускается).

## 4. Специфика по типам объектов

### Справочники
- Код/Наименование обычно сверху.
- Поле родителя (при иерархии) — заметное.

### Документы
- Дата/Номер — вверху.
- Статус/Организация/Склад — в заголовке.
- Табличные части — в теле формы.
- Итоги/Комментарий/Автор — внизу.

### Обработки
- Настройки/параметры — сверху или на отдельной вкладке.
- Кнопки действий — в командной панели или справа внизу.

---
depends_on: []
---

More from SteelMorgan/1c-agent-based-dev-framework

Skill	Description
1c-ai-agent-cli	CLI 1C BSL Agent Framework — tools/install.py (clone, install). Используй при клонировании репозитория, установке компонентов в проект, настройке IDE (Cursor, Claude Code, Windsurf, VS Code+Continue).
agent-debug	Паттерн отладочных сообщений для 1С BSL. Используй, когда стандартная диагностика (event-log, скриншоты) не даёт понять фактическое поведение системы — нужно вставить временные точки логирования в код, запустить тест и проанализировать записи ЖР.
agent-development	Create custom subagents for specialized AI tasks. Use when the user wants to create a new type of subagent, set up task-specific agents, configure code reviewers, debuggers, or domain-specific assistants with custom prompts.
agent-development-ext	>
agent-git-workflow	Standardizes git workflow for the AI agent in the sandbox devcontainer: work in agent/<task>-<yyyymmdd>, integrate via agent, never push to main/master, open PRs via GitHub CLI. Use when the user asks to create branches, push changes, open PRs, or follow this sandbox repo setup.
auto-skill-bootstrap	Deterministic helper to inventory existing project skills, detect missing capability coverage, search skills.sh via Skills CLI, and (optionally) install missing skills under a trust policy. Uses skills-manifest.json + state.json to stay idempotent across changing requirements.
code-navigation	Навигация по коду (Code Navigation). Навык учит агента эффективно перемещаться по BSL-коду с помощью LSP (Language Server Protocol).
config-operations	Операции с конфигурацией 1С (CF) — init, info, edit, validate. Используй при создании конфигурации, анализе структуры, изменении свойств и ChildObjects, валидации Configuration.xml.
epf-build	Собрать EPF/ERF из XML-исходников. Используй после внесения временных диагностических правок в разобранную обработку.
epf-dump	Разобрать EPF/ERF в XML-исходники. Используй, когда нужно быстро получить исходный код внешней обработки или отчета для анализа и временной модификации.