Compétences material-component-dev
📦

material-component-dev

Sûr

Создание React-компонентов FlowGram с соблюдением лучших практик

Создание React-компонентов для FlowGram требует следования определенным паттернам и соглашениям. Этот навык направляет Claude Code через полный рабочий процесс разработки компонентов с TypeScript, Semi UI и тестированием в Storybook.

Prend en charge: Claude Codex Code(CC)
📊 69 Adéquat
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "material-component-dev". Создай новый компонент ColorPicker для выбора цветов в схемах форм.

Résultat attendu:

Я создам компонент ColorPicker, следуя соглашениям FlowGram. Сначала я создам структуру директорий в packages/materials/form-materials/src/components/color-picker/ с основным файлом компонента, использующим Semi UI ColorPicker, правильными интерфейсами TypeScript, именованными экспортами, затем добавлю его в основные экспорты index. Наконец, я создам историю Storybook в apps/demo-materials/src/stories/components/ для демонстрации использования компонента.

Utilisation de "material-component-dev". Добавь историю для существующего компонента DataTable, показывающую пагинацию и сортировку.

Résultat attendu:

Я создам полную историю Storybook в apps/demo-materials/src/stories/components/data-table.stories.tsx. История будет включать демо-компонент, который управляет состоянием для пагинации и сортировки, демонстрировать DataTable с примерами данных и включать правильную конфигурацию Meta с описанием компонента и тегами для autodocs.

Audit de sécurité

Sûr
v6 • 1/21/2026

This skill is a pure documentation guide for React component development. All static findings are false positives from markdown documentation containing example commands, local URLs, and relative import paths. No executable code or security risks present.

2
Fichiers analysés
1,199
Lignes analysées
0
résultats
6
Total des audits
Aucun problème de sécurité trouvé

Score de qualité

38
Architecture
100
Maintenabilité
87
Contenu
21
Communauté
100
Sécurité
83
Conformité aux spécifications

Ce que vous pouvez construire

Создание нового компонента материала формы

Создание нового переиспользуемого компонента формы для FlowGram с правильными типами TypeScript, интеграцией Semi UI и документацией Storybook, следующей соглашениям проекта.

Добавление компонента с интеграцией редактора кода

Разработка компонентов, интегрирующих JSON или редакторы кода из внутренних пакетов FlowGram с правильной типобезопасностью и обработкой ошибок.

Генерация документации Storybook

Создание полной документации историй Storybook, демонстрирующих использование компонента с интерактивными примерами и правильной конфигурацией метаданных.

Essayez ces prompts

Создание базового компонента
Создай новый компонент DataPicker в пакете form-materials, который позволяет пользователям выбирать поля данных из схемы.
Добавление истории Storybook
Создай историю Storybook для компонента SchemaValidator с примерами, показывающими успешную валидацию и состояния ошибок.
Интеграция редактора кода
Создай компонент QueryBuilder, который использует JsonCodeEditor из внутренних пакетов и валидирует формат JSON Schema v7.
Отладка ошибок типов
Исправь ошибки TypeScript в компоненте FormBuilder. Ошибка говорит, что тип IJsonSchema не найден, а React ссылается на глобальный UMD.

Bonnes pratiques

  • Всегда используйте именованные экспорты вместо экспортов по умолчанию, чтобы обеспечить tree shaking и улучшить оптимизацию бандла.
  • Импортируйте React явно во всех файлах компонентов, чтобы избежать ошибок ссылки на глобальный UMD в TypeScript.
  • Держите свойства компонентов минимальными и сфокусированными на основной функциональности, а не добавляйте избыточные опции конфигурации.

Éviter

  • Не создавайте отдельные npm-пакеты для отдельных компонентов. Храните все компоненты в пакете form-materials.
  • Избегайте использования внешних типов json-schema. Всегда импортируйте IJsonSchema из внутренних пакетов.
  • Не пишите unit-тесты для компонентов. Используйте вместо этого Storybook для ручного тестирования и проверки.

Foire aux questions

Почему использовать именованные экспорты вместо экспортов по умолчанию?
Именованные экспорты обеспечивают лучший tree shaking в бандлерах, облегчая устранение неиспользуемого кода и уменьшение размера бандла. Это соглашение для всего проекта для всех компонентов FlowGram.
Какую библиотеку UI-компонентов следует использовать?
Всегда используйте компоненты Semi UI из пакета @douyinfe/semi-ui. Это обеспечивает визуальную согласованность во всем приложении FlowGram и предоставляет полный набор готовых компонентов.
Как протестировать мой компонент после создания?
Запустите rush build:watch в одном терминале для компиляции пакета, затем запустите Storybook с помощью yarn dev в apps/demo-materials. Получите доступ к истории вашего компонента на localhost:6006 для интерактивного тестирования.
Какой правильный способ импорта типов JSON Schema?
Используйте тип IJsonSchema из пакета @flowgram.ai/json-schema. Не используйте внешние типы json-schema или JSONSchema7 из других пакетов, так как они несовместимы со структурой проекта.
Где следует размещать вспомогательные функции для моего компонента?
Создайте поддиректорию utils внутри папки вашего компонента и размещайте там вспомогательные функции с правильными типами TypeScript и заголовками авторских прав. Экспортируйте функции, используя именованные экспорты.
Как исправить ошибки ссылки на глобальный UMD React?
Добавьте явный импорт import React в начало вашего файла. Эта ошибка возникает, когда React используется как глобальный в UMD-сборках, но ваш файл является ES-модулем.

Détails du développeur

Structure de fichiers

📄 SKILL.md