codymaster 4.1.4 → 4.4.1

package/skills/cm-ux-master/README-ru.md

@@ -0,0 +1,135 @@
+<div align="center">
+
+# ✦ MasterDesign Agent
+
+> **Вы мечтаете. AI создаёт красоту.**
+
+[English](README.md) • [Tiếng Việt](README-vi.md) • [中文](README-zh.md) • [Русский](README-ru.md)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+![Platforms](https://img.shields.io/badge/platforms-6-brightgreen.svg)
+![Entries](https://img.shields.io/badge/design%20rules-838%2B-purple.svg)
+![UX Laws](https://img.shields.io/badge/UX%20Laws-48-ff69b4.svg)
+![Tests](https://img.shields.io/badge/tests-7%20suites-green.svg)
+
+</div>
+
+---
+
+## 🛑 Настоящая проблема
+
+У вас есть отличная идея. Вы описываете её AI-инструменту. Но сгенерированный интерфейс выглядит... **ужасно**.
+Он выглядит шаблонно, «сделано нейросетью», без единой системы дизайна. Формы слишком длинные, кнопки слишком маленькие, а пользовательский опыт — сплошное разочарование.
+
+Это реальность, с которой сталкиваются 90% основателей, разработчиков и продакт-менеджеров. Отличный код с уродливым интерфейсом = мёртвый продукт.
+
+## ✨ Магическое решение
+
+**MasterDesign Agent** превращает любой AI-инструмент для кодинга в **профессиональную дизайн-студию**.
+Он работает незаметно в фоновом режиме вашей любимой IDE или CLI. Вы просто говорите свои идеи, а AI автоматически применяет мировые стандарты дизайна.
+
+| ❌ Без MasterDesign Agent | ✦ С MasterDesign Agent |
+|---------------------|--------------|
+| AI генерирует типовой «нейро-стиль» | Интерфейс студийного качества |
+| Непоследовательные цвета и отступы | Целостная профессиональная дизайн-система |
+| Крошечные кнопки, запутанные меню | Оптимизация по 48 научным UX-законам |
+| Нет проверки качества | 37 автоматизированных дизайн-тестов |
+| Нанять дизайнера: $3K–$15K, ждать недели | **$0, результат за 60 секунд** |
+
+---
+
+## 🚀 Что нового в v2.0
+
+Мы кардинально обновили инструментарий:
+
+- 🧬 **Harvester v3 (Полная экстракция):** Извлечение 50-80+ дизайн-токенов с любого сайта. Цветовые гистограммы, семантические цвета, шкала серого, типографика, отступы и метрики макета. Клонируйте ДНК лучших сайтов за 5 минут.
+- 🗂️ **Реестр проектов (Project Registry):** Лёгкое управление множеством дизайн-систем. Объединение данных из нескольких страниц в один проект.
+- 📖 **Генератор документации:** Автоматическое создание HTML-документации с палитрами, образцами шрифтов и примерами компонентов.
+- 🔗 **Token Mapper & Semi MCP Bridge:** Маппинг дизайн-токенов в переменные CSS Semi Design UI. Автогенерация CSS-переопределений, JSON для Figma и шаблонов React-компонентов.
+- 🧪 **7 полных тест-наборов:** Полное покрытие TDD для дизайна.
+
+---
+
+## 🧠 Полный дизайн-интеллект
+
+MasterDesign Agent — это не шаблон. Это мощная матрица интеллекта, включающая **838+ дизайн-правил** для **13 технологических стеков** и **13 отраслей** (финтех, SaaS, электронная коммерция и др.).
+
+- **67 стилей UI:** От глассморфизма до брутализма.
+- **96 цветовых палитр и 57 сочетаний шрифтов:** Тщательно подобраны для максимального визуального эффекта.
+- **48 UX-законов:** Автоматическое применение закона Хика (уменьшить выбор), закона Фиттса (увеличить области нажатия), порога Доэрти (быстрый отклик) и многих других.
+- **37 дизайн-тестов:** Строгий QA-фильтр перед выдачей кода.
+
+---
+
+## ⚡ Начните за 60 секунд
+
+### Шаг 1: Проверьте Python
+Убедитесь, что установлен Python 3:
+```bash
+python3 --version
+```
+
+### Шаг 2: Клонирование и установка
+```bash
+git clone https://github.com/relukdev/ux-master.git
+cd ux-master
+python3 scripts/install.py
+```
+
+Установщик автоматически обнаружит ваши AI-инструменты и настроит их.
+*Хотите указать конкретную платформу?*
+```bash
+python3 scripts/install.py --platform cursor
+python3 scripts/install.py --platform amp --global
+# Или установить для всех:
+python3 scripts/install.py --platform all --global
+```
+
+### Шаг 3: Увидьте магию
+Откройте AI-инструмент (например, Cursor) и напишите:
+> *"Создай лендинг для премиального спа-салона, современный минимализм."*
+
+Если AI упомянет **дизайн-систему, UX-законы или дизайн-тесты** — MasterDesign Agent активирован! 🎉
+
+---
+
+## 🔌 Поддерживаемые AI-платформы
+
+Бесшовная интеграция с вашим рабочим процессом:
+- **Cursor** (`--platform cursor`) — Самая популярная AI IDE.
+- **Claude / Amp** (`--platform amp`) — Мощный CLI от Anthropic.
+- **Gemini CLI** (`--platform gemini`) — AI-ассистент от Google.
+- **Antigravity** (`--platform antigravity`) — Расширение VS Code от Google.
+- **OpenCode** (`--platform opencode`) — Альтернатива с открытым кодом.
+- **Claude Code** (`--platform claude`) — Поддержка старой версии.
+
+---
+
+## 💎 Бесплатная vs Про версия
+
+| Функция | Бесплатная | Про |
+|---------|------|-----|
+| Цена | **$0** | **$39** (единоразовый платёж) |
+| Дизайн-правила и UX-законы | 838+ и 48 | 838+ и 48 |
+| Дизайн-тесты | 37 | 37 |
+| Harvester (экстрактор) | **v1 (~15 токенов)** | **v3 (80+ токенов)** 🔥 |
+| Token Mapper | ❌ | ✅ CSS/Figma |
+| Генератор документации | ❌ | ✅ HTML |
+| Реестр проектов | ❌ | ✅ |
+| Поддержка | Сообщество | Приоритетная |
+
+> **Перейти на Про:** 👉 [ux-master.dev/pro](https://ux-master.dev/pro)
+
+---
+
+## 🤝 Вклад в проект
+Мы приветствуем вашу помощь! Если вы хотите улучшить AI-правила, добавить новые гайдлайны или расширить UX-законы:
+1. Форкните репозиторий и создайте ветку (`git checkout -b feature/amazing-idea`).
+2. Зафиксируйте изменения.
+3. Запушьте ветку и откройте Pull Request.
+
+## 📄 Лицензия
+MIT License — свободное использование в любом проекте.
+
+---
+> **MasterDesign Agent** — 1 человек = целая дизайн-команда. ✦

package/skills/cm-ux-master/README-vi.md

@@ -0,0 +1,135 @@
+<div align="center">
+
+# ✦ MasterDesign Agent
+
+> **Bạn kể ý tưởng. AI tạo ra kiệt tác.**
+
+[English](README.md) • [Tiếng Việt](README-vi.md) • [中文](README-zh.md) • [Русский](README-ru.md)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+![Platforms](https://img.shields.io/badge/platforms-6-brightgreen.svg)
+![Entries](https://img.shields.io/badge/design%20rules-838%2B-purple.svg)
+![UX Laws](https://img.shields.io/badge/UX%20Laws-48-ff69b4.svg)
+![Tests](https://img.shields.io/badge/tests-7%20suites-green.svg)
+
+</div>
+
+---
+
+## 🛑 Vấn đề thực sự
+
+Bạn có một ý tưởng tuyệt vời. Bạn mô tả nó cho AI. Nhưng giao diện mà AI tạo ra lại... **quá tệ**.
+Nó trông đại trà, mang đậm "mùi AI", và thiếu vắng một hệ thống thiết kế đồng nhất. Nút bấm thì nhỏ, form nhập liệu dài lê thê, và trải nghiệm người dùng đầy ức chế.
+
+Đây là thực tế cay đắng của 90% nhà sáng lập, lập trình viên và quản lý dự án. Mã nguồn có xuất sắc đến đâu mà mặt tiền bệ rạc thì dự án cũng coi như bỏ đi.
+
+## ✨ Phép màu công nghệ
+
+**MasterDesign Agent** biến mọi công cụ AI (Cursor, Claude, Gemini...) của bạn thành một **buồng thiết kế cao cấp**.
+Nó hoạt động âm thầm phía sau. Bạn chỉ cần ra lệnh, và AI sẽ tự động áp dụng các tiêu chuẩn thiết kế hàng đầu thế giới để nhào nặn ra sản phẩm.
+
+| ❌ Không có MasterDesign Agent | ✦ Với MasterDesign Agent |
+|---------------------|--------------|
+| AI tạo UI đại trà, giả tạo | Giao diện choáng ngợp, chốt gục khách hàng |
+| Mỗi trang một kiểu, lộn xộn | Hệ thống thiết kế đồng bộ tuyệt đối |
+| Nút bấm vô hình, menu mê cung | Áp dụng 48 định luật tâm lý học hành vi |
+| Không biết design tốt hay xấu | 37 lưới lọc kiểm định khắt khe tự động |
+| Đốt $3K–$15K thuê designer, chờ đợi | **0 đồng, 0 giây chờ, kết quả xuất sắc** |
+
+---
+
+## 🚀 Có gì mới trong v2.0?
+
+Chúng tôi đã nâng cấp toàn diện sức mạnh của bộ kit:
+
+- 🧬 **Harvester v3 (Trích xuất toàn diện):** Bóc tách 50-80+ design tokens từ bất kỳ website nào. Chụp lại biểu đồ màu, hệ màu semantic, thang màu xám, tỷ lệ chữ, khoảng cách và thông số layout. Biến DNA của đối thủ thành của bạn trong 5 phút.
+- 🗂️ **Project Registry:** Quản lý hàng loạt dự án thiết kế dễ dàng. Trộn (merge) dữ liệu harvest từ nhiều trang vào một dự án duy nhất.
+- 📖 **Design Doc Generator:** Tự động gen ra trang HTML Tàit liệu thiết kế (Documentation) hiển thị bảng màu, font chữ, components mẫu.
+- 🔗 **Token Mapper & Semi MCP Bridge:** Chuyển hóa design tokens sang biến CSS của Semi Design. Tự động sinh code CSS overrides, JSON cho Figma và template React component.
+- 🧪 **7 Bộ Test Suites toàn diện:** Đảm bảo chất lượng bằng phương pháp TDD for Design.
+
+---
+
+## 🧠 Bộ não thiết kế đích thực
+
+MasterDesign Agent không phải là một cái template. Nó là một ma trận trí tuệ chứa **838+ quy tắc thiết kế**, bao phủ **13 tech stacks** và **13 ngành hàng** (Fintech, SaaS, Thương mại điện tử...).
+
+- **67 Phong cách UI:** Từ Glassmorphism thanh lịch tới Brutalism táo bạo.
+- **96 Bảng màu & 57 Cặp font chữ:** Chọn lọc khắt khe cho hiệu ứng thị giác tối đa.
+- **48 Định luật UX:** Tự động áp dụng Định luật Hick (giảm lựa chọn), Định luật Fitts (tăng kích thước vùng bấm), Ngưỡng Doherty (phản hồi siêu tốc), v.v.
+- **37 Bài Design Tests:** Đóng vai trò như một màng lọc QA trước khi AI nhả code cho bạn.
+
+---
+
+## ⚡ Bắt đầu trong 60 giây
+
+### Bước 1: Kiểm tra Python
+Đảm bảo máy bạn đã cài Python 3:
+```bash
+python3 --version
+```
+
+### Bước 2: Clone & Cài đặt
+```bash
+git clone https://github.com/relukdev/ux-master.git
+cd ux-master
+python3 scripts/install.py
+```
+
+Trình cài đặt sẽ tự động tìm các AI tool hiện có và cấu hình ngay lập tức.
+*Bạn muốn cài riêng cho 1 tool?*
+```bash
+python3 scripts/install.py --platform cursor
+python3 scripts/install.py --platform amp --global
+# Hoặc cài cho tất cả:
+python3 scripts/install.py --platform all --global
+```
+
+### Bước 3: Chiêm ngưỡng phép màu
+Mở AI tool của bạn (vd: Cursor) và gõ:
+> *"Tạo landing page cho dịch vụ spa thượng lưu, phong cách modern minimal."*
+
+Nếu AI bắt đầu nhắc đến **design systems, UX Laws, hoặc design tests** — Chúc mừng, MasterDesign Agent đã thức tỉnh! 🎉
+
+---
+
+## 🔌 Nền tảng AI hỗ trợ
+
+Hòa hợp kỳ diệu cùng luồng làm việc của bạn:
+- **Cursor** (`--platform cursor`) - IDE code bằng AI số 1 hiện nay.
+- **Claude / Amp** (`--platform amp`) - CLI siêu mạnh từ Anthropic.
+- **Gemini CLI** (`--platform gemini`) - Công cụ của Google.
+- **Antigravity** (`--platform antigravity`) - Extension nội bộ của Google.
+- **OpenCode** (`--platform opencode`) - Lựa chọn mã nguồn mở.
+- **Claude Code** (`--platform claude`) - Hỗ trợ phiên bản cũ.
+
+---
+
+## 💎 Phiên bản Free và Pro
+
+| Tính năng | Free | Pro |
+|---------|------|-----|
+| Mức Giá | **$0** | **$39** (One-time) |
+| Design Rules & UX Laws | 838+ & 48 | 838+ & 48 |
+| Design Tests | 37 | 37 |
+| Harvester (Trích xuất) | **v1 (~15 tokens)** | **v3 (80+ tokens)** 🔥 |
+| Token Mapper | ❌ | ✅ CSS/Figma |
+| Design Doc Generator | ❌ | ✅ HTML Output |
+| Project Registry | ❌ | ✅ |
+| Hỗ trợ | Cộng đồng | Ưu tiên |
+
+> **Thăng hạng lên Pro ngay hôm nay:** 👉 [ux-master.dev/pro](https://ux-master.dev/pro)
+
+---
+
+## 🤝 Đóng góp
+Dự án luôn chào đón sự đóng góp của bạn! Nếu bạn muốn cải thiện ruleset, thêm framework mới hay bổ sung UX laws:
+1. Fork repo và tạo branch mới (`git checkout -b feature/y-tuong-hay`).
+2. Commit thay đổi của bạn.
+3. Push lên branch và mở Pull Request.
+
+## 📄 Giấy phép
+Sử dụng MIT License - bạn được quyền tự do dùng trong bất kỳ dự án nào.
+
+---
+> **MasterDesign Agent** — 1 cái đầu cân cả phòng thiết kế. ✦

package/skills/cm-ux-master/README-zh.md

@@ -0,0 +1,135 @@
+<div align="center">
+
+# ✦ MasterDesign Agent
+
+> **你构思，AI美化。**
+
+[English](README.md) • [Tiếng Việt](README-vi.md) • [中文](README-zh.md) • [Русский](README-ru.md)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+![Platforms](https://img.shields.io/badge/platforms-6-brightgreen.svg)
+![Entries](https://img.shields.io/badge/design%20rules-838%2B-purple.svg)
+![UX Laws](https://img.shields.io/badge/UX%20Laws-48-ff69b4.svg)
+![Tests](https://img.shields.io/badge/tests-7%20suites-green.svg)
+
+</div>
+
+---
+
+## 🛑 真正的问题
+
+你有一个绝妙的想法。你把它描述给 AI 工具。但 AI 生成的界面……**丑得不忍直视**。
+看起来千篇一律，"AI味"十足，没有统一的设计系统。表单太长、按钮太小、用户体验一塌糊涂。
+
+这是 90% 创始人、开发者和产品经理面临的残酷现实。再好的代码，界面丑陋等于白做。
+
+## ✨ 魔法解决方案
+
+**MasterDesign Agent** 把你的任何 AI 编码工具变成一个**专业设计工作室**。
+它在你常用的 IDE 或 CLI 后台默默运行。你只需说出你的想法，AI 就会自动应用世界一流的设计标准。
+
+| ❌ 没有 MasterDesign Agent | ✦ 有了 MasterDesign Agent |
+|---------------------|--------------|
+| AI 生成千篇一律的"AI味"界面 | 工作室品质的UI，让客户眼前一亮 |
+| 间距和颜色混乱不一致 | 统一的专业设计系统 |
+| 按钮太小，菜单像迷宫 | 基于48条科学UX法则自动优化 |
+| 没有自动质量检测 | 37项自动化设计测试 |
+| 请设计师：$3K–$15K，等好几周 | **$0，60秒内出成果** |
+
+---
+
+## 🚀 v2.0 新功能
+
+我们对工具包进行了全面的重磅升级：
+
+- 🧬 **Harvester v3（全面提取）：** 从任意网站提取50-80+设计令牌。捕获色彩直方图、语义色彩、灰度梯度、字体比例、间距和布局参数。5分钟内克隆顶级网站的设计DNA。
+- 🗂️ **项目注册表（Project Registry）：** 轻松管理多个设计系统项目。将多个页面的采集数据合并为一个统一项目。
+- 📖 **设计文档生成器：** 自动生成精美的HTML设计文档（色板、字体样本、组件示例）。
+- 🔗 **Token Mapper & Semi MCP Bridge：** 将设计令牌直接映射到 Semi Design UI 变量。自动生成CSS覆盖、Figma JSON 和 React 组件模板。
+- 🧪 **7套完整测试：** 全面的设计TDD（测试驱动设计）覆盖。
+
+---
+
+## 🧠 完整的设计智能
+
+MasterDesign Agent 不是一个模板。它是包含 **838+ 设计规则**的庞大智能矩阵，覆盖 **13 技术栈**和 **13 个行业**（金融科技、SaaS、电商等）。
+
+- **67种UI风格：** 从玻璃拟态到粗犷主义。
+- **96种配色方案 & 57种字体搭配：** 精心挑选，视觉效果拉满。
+- **48条UX法则：** 自动应用希克定律（减少选择）、费茨定律（增大点击区域）、多赫蒂阈值（快速反馈）等。
+- **37项设计测试：** 在AI生成代码前充当严格的QA过滤器。
+
+---
+
+## ⚡ 60秒快速上手
+
+### 第一步：检查 Python
+确保已安装 Python 3：
+```bash
+python3 --version
+```
+
+### 第二步：克隆 & 安装
+```bash
+git clone https://github.com/relukdev/ux-master.git
+cd ux-master
+python3 scripts/install.py
+```
+
+安装程序会自动检测你的AI工具并立即配置。
+*想指定特定平台？*
+```bash
+python3 scripts/install.py --platform cursor
+python3 scripts/install.py --platform amp --global
+# 或者全部安装：
+python3 scripts/install.py --platform all --global
+```
+
+### 第三步：见证魔法
+打开你的AI工具（如Cursor），输入提示：
+> *"创建一个高端水疗中心的着陆页，现代简约风格。"*
+
+如果 AI 提到了 **设计系统、UX法则或设计测试** — 恭喜，MasterDesign Agent 已经激活了！🎉
+
+---
+
+## 🔌 支持的AI平台
+
+与你的工作流程无缝集成：
+- **Cursor** (`--platform cursor`) - 最受欢迎的AI IDE。
+- **Claude / Amp** (`--platform amp`) - Anthropic 强大的CLI工具。
+- **Gemini CLI** (`--platform gemini`) - Google 的AI助手。
+- **Antigravity** (`--platform antigravity`) - Google 的VS Code扩展。
+- **OpenCode** (`--platform opencode`) - 开源替代方案。
+- **Claude Code** (`--platform claude`) - 旧版支持。
+
+---
+
+## 💎 免费版 vs 专业版
+
+| 功能 | 免费版 | 专业版 |
+|---------|------|-----|
+| 价格 | **$0** | **$39**（一次性付费） |
+| 设计规则 & UX法则 | 838+ & 48 | 838+ & 48 |
+| 设计测试 | 37 | 37 |
+| Harvester（提取器） | **v1（~15令牌）** | **v3（80+令牌）** 🔥 |
+| Token Mapper | ❌ | ✅ CSS/Figma |
+| 设计文档生成器 | ❌ | ✅ HTML输出 |
+| 项目注册表 | ❌ | ✅ |
+| 支持 | 社区 | 优先 |
+
+> **立即升级专业版：** 👉 [ux-master.dev/pro](https://ux-master.dev/pro)
+
+---
+
+## 🤝 参与贡献
+欢迎贡献！如果你想改进AI推理规则、添加新的技术栈指南或扩展UX法则：
+1. Fork 仓库并创建分支（`git checkout -b feature/amazing-idea`）。
+2. 提交更改。
+3. 推送分支并创建 Pull Request。
+
+## 📄 许可证
+MIT License — 可自由用于任何项目。
+
+---
+> **MasterDesign Agent** — 一个人 = 整个设计团队。 ✦