From 7246805992a42b7bba37d4cac83b01416f0c6c44 Mon Sep 17 00:00:00 2001 From: XiaOldMan Date: Mon, 12 Oct 2026 19:08:03 +0800 Subject: [PATCH] feat: add OpenClaw platform support (#527) * feat: add OpenClaw platform support Add OpenClaw as an install target so the skill can be installed with `uipro init --ai openclaw` and removed via `uipro uninstall`. OpenClaw discovers AgentSkills-format skills from `.agents/skills` in the agent workspace and from `~/.agents/skills` (personal library on the default state dir), so the platform config reuses the `.agents` layout already used by the universal/codex targets with its own display name, detection entry, and docs. - new platform config src/ui-ux-pro-max/templates/platforms/openclaw.json (synced to cli/assets via sync:assets) - register 'openclaw' in AIType, AI_TYPES, AI_FOLDERS, AI_TO_PLATFORM - detect the shared .agents workspace directory and describe the platform - keep the .agents-family suggestion on codex when all four .agents consumers are detected (length 2-3 -> 2-4) - cover openclaw in the dry-run, template-script-paths, and agent-query-contract e2e specs - document OpenClaw in README and cli/README * chore: bump version to 2.15.0 in skill metadata files Aligns skill.json, marketplace.json, and plugin.json with the latest v2.15.0 release; main was still at 2.13.0. CLI package version stays on its own npm release track. * fix: cover OpenClaw in offline validator and detection regression - bump scripts/validate-agent-guide.py PLATFORM_COUNT 21 -> 23 (main already had 22 configs with a stale count of 21; OpenClaw widens the gap to 23, so update the gate and keep it meaningful) - add e2e regression: a sole .agents directory detects all four consumers (antigravity, codex, universal, openclaw) and still suggests codex rather than all --- .claude-plugin/marketplace.json | 4 ++-- .claude-plugin/plugin.json | 2 +- README.md | 3 ++- cli/README.md | 1 + cli/assets/templates/platforms/openclaw.json | 21 ++++++++++++++++++ cli/src/types/index.ts | 5 +++-- cli/src/utils/detect.ts | 5 ++++- cli/src/utils/template.ts | 1 + cli/tests/e2e/agent-query-contract.spec.ts | 2 +- cli/tests/e2e/detect.spec.ts | 22 +++++++++++++++++++ cli/tests/e2e/dry-run.spec.ts | 13 +++++++++++ cli/tests/e2e/template-script-paths.spec.ts | 1 + scripts/validate-agent-guide.py | 2 +- skill.json | 2 +- .../templates/platforms/openclaw.json | 21 ++++++++++++++++++ 15 files changed, 95 insertions(+), 10 deletions(-) create mode 100644 cli/assets/templates/platforms/openclaw.json create mode 100644 cli/tests/e2e/detect.spec.ts create mode 100644 src/ui-ux-pro-max/templates/platforms/openclaw.json diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index d90ca1c..f4417fa 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -6,14 +6,14 @@ }, "metadata": { "description": "UI/UX design intelligence skill with 79 styles, 192 palettes, 74 font pairings, 25 charts, and 22 stack guidelines", - "version": "2.13.0" + "version": "2.15.0" }, "plugins": [ { "name": "ui-ux-pro-max", "source": "./", "description": "Professional UI/UX design intelligence for AI coding assistants. Includes searchable databases of styles, colors, typography, charts, and UX guidelines for React, Next.js, Astro, Vue, Nuxt.js, Nuxt UI, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, Jetpack Compose, Angular, Laravel, JavaFX, and Three.js.", - "version": "2.13.0", + "version": "2.15.0", "author": { "name": "nextlevelbuilder" }, diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 477a5c2..8d2c6c0 100755 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "ui-ux-pro-max", "description": "UI/UX design intelligence. Searchable local database with 79 styles, 192 palettes, 74 font pairings, 25 charts, and 22 stacks (React, Next.js, Vue, Nuxt.js, Nuxt UI, Svelte, Astro, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, Jetpack Compose, Angular, Laravel, JavaFX, WPF, WinUI, Avalonia, Uno Platform, UWP, Three.js). Use when designing, building, or reviewing UI: pages, components, color schemes, typography, layout, accessibility, animation, or data visualization.", - "version": "2.13.0", + "version": "2.15.0", "author": { "name": "nextlevelbuilder" }, diff --git a/README.md b/README.md index 5744329..2f13c93 100755 --- a/README.md +++ b/README.md @@ -290,6 +290,7 @@ uipro init --ai augment # Augment uipro init --ai codewhale # CodeWhale uipro init --ai zcode # ZCode uipro init --ai amazonq # Amazon Q Developer +uipro init --ai openclaw # OpenClaw (.agents/skills/) uipro init --ai universal # Universal / Agent Standard (.agents/skills/) uipro init --ai all # All assistants ``` @@ -334,7 +335,7 @@ If it is missing, install it yourself from [python.org](https://www.python.org/d ### Skill Mode (Auto-activate) -**Supported:** Claude Code, Cursor, Windsurf, Antigravity, Codex CLI, Continue, Gemini CLI, OpenCode, Qoder, CodeBuddy, Droid (Factory), KiloCode, Warp, Augment, CodeWhale, ZCode, Amazon Q Developer +**Supported:** Claude Code, Cursor, Windsurf, Antigravity, Codex CLI, Continue, Gemini CLI, OpenCode, Qoder, CodeBuddy, Droid (Factory), KiloCode, Warp, Augment, CodeWhale, ZCode, Amazon Q Developer, OpenClaw The skill activates automatically when you request UI/UX work. Just chat naturally: diff --git a/cli/README.md b/cli/README.md index 7f79ce4..a88f51a 100644 --- a/cli/README.md +++ b/cli/README.md @@ -25,6 +25,7 @@ uipro init --ai gemini # Gemini CLI uipro init --ai trae # Trae uipro init --ai opencode # OpenCode uipro init --ai amazonq # Amazon Q Developer +uipro init --ai openclaw # OpenClaw (.agents/skills/) uipro init --ai universal # Universal / Agent Standard (.agents/skills/) uipro init --ai all # All assistants diff --git a/cli/assets/templates/platforms/openclaw.json b/cli/assets/templates/platforms/openclaw.json new file mode 100644 index 0000000..cfea9f2 --- /dev/null +++ b/cli/assets/templates/platforms/openclaw.json @@ -0,0 +1,21 @@ +{ + "platform": "openclaw", + "displayName": "OpenClaw", + "installType": "full", + "folderStructure": { + "root": ".agents", + "skillPath": "skills/ui-ux-pro-max", + "filename": "SKILL.md" + }, + "scriptPath": "skills/ui-ux-pro-max/scripts/search.py", + "frontmatter": { + "name": "ui-ux-pro-max", + "description": "UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks." + }, + "sections": { + "quickReference": false + }, + "title": "ui-ux-pro-max", + "description": "UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.", + "skillOrWorkflow": "Skill" +} diff --git a/cli/src/types/index.ts b/cli/src/types/index.ts index 564c425..6ff9e81 100755 --- a/cli/src/types/index.ts +++ b/cli/src/types/index.ts @@ -1,4 +1,4 @@ -export type AIType = 'claude' | 'cursor' | 'windsurf' | 'antigravity' | 'copilot' | 'kiro' | 'roocode' | 'codex' | 'qoder' | 'gemini' | 'trae' | 'opencode' | 'continue' | 'codebuddy' | 'droid' | 'kilocode' | 'warp' | 'augment' | 'codewhale' | 'zcode' | 'amazonq' | 'universal' | 'all'; +export type AIType = 'claude' | 'cursor' | 'windsurf' | 'antigravity' | 'copilot' | 'kiro' | 'roocode' | 'codex' | 'qoder' | 'gemini' | 'trae' | 'opencode' | 'continue' | 'codebuddy' | 'droid' | 'kilocode' | 'warp' | 'augment' | 'codewhale' | 'zcode' | 'amazonq' | 'openclaw' | 'universal' | 'all'; export type ConcreteAIType = Exclude; export type InstallType = 'full' | 'reference'; @@ -43,7 +43,7 @@ export interface PlatformConfig { skillOrWorkflow: string; } -export const AI_TYPES: AIType[] = ['claude', 'cursor', 'windsurf', 'antigravity', 'copilot', 'roocode', 'kiro', 'codex', 'qoder', 'gemini', 'trae', 'opencode', 'continue', 'codebuddy', 'droid', 'kilocode', 'warp', 'augment', 'codewhale', 'zcode', 'amazonq', 'universal', 'all']; +export const AI_TYPES: AIType[] = ['claude', 'cursor', 'windsurf', 'antigravity', 'copilot', 'roocode', 'kiro', 'codex', 'qoder', 'gemini', 'trae', 'opencode', 'continue', 'codebuddy', 'droid', 'kilocode', 'warp', 'augment', 'codewhale', 'zcode', 'amazonq', 'openclaw', 'universal', 'all']; // Legacy folder mapping for backward compatibility with ZIP-based installs. // Note: .shared is included for platforms that used ZIP installs. Post-ZIP platforms @@ -70,5 +70,6 @@ export const AI_FOLDERS: Record = { codewhale: ['.codewhale', '.shared'], zcode: ['.zcode', '.shared'], amazonq: ['.amazonq', '.shared'], + openclaw: ['.agents', '.shared'], universal: ['.agents', '.shared'], }; diff --git a/cli/src/utils/detect.ts b/cli/src/utils/detect.ts index cddc2f3..b053706 100755 --- a/cli/src/utils/detect.ts +++ b/cli/src/utils/detect.ts @@ -23,6 +23,7 @@ export function detectAIType(cwd: string = process.cwd()): DetectionResult { detected.push('antigravity'); detected.push('codex'); detected.push('universal'); + detected.push('openclaw'); } else if (existsSync(join(cwd, '.agent'))) { detected.push('antigravity'); } @@ -83,7 +84,7 @@ export function detectAIType(cwd: string = process.cwd()): DetectionResult { if (detected.length === 1) { suggested = detected[0]; } else if ( - (detected.length === 2 || detected.length === 3) && + (detected.length >= 2 && detected.length <= 4) && detected.includes('antigravity') && detected.includes('codex') ) { @@ -140,6 +141,8 @@ export function getAITypeDescription(aiType: AIType): string { return 'ZCode (.zcode/skills/)'; case 'amazonq': return 'Amazon Q Developer (.amazonq/rules/)'; + case 'openclaw': + return 'OpenClaw (.agents/skills/)'; case 'universal': return 'Universal (.agents/skills/)'; case 'all': diff --git a/cli/src/utils/template.ts b/cli/src/utils/template.ts index aff9108..2d54d77 100755 --- a/cli/src/utils/template.ts +++ b/cli/src/utils/template.ts @@ -56,6 +56,7 @@ const AI_TO_PLATFORM: Record = { codewhale: 'codewhale', zcode: 'zcode', amazonq: 'amazonq', + openclaw: 'openclaw', universal: 'universal', }; diff --git a/cli/tests/e2e/agent-query-contract.spec.ts b/cli/tests/e2e/agent-query-contract.spec.ts index 67f98d5..830ff1d 100644 --- a/cli/tests/e2e/agent-query-contract.spec.ts +++ b/cli/tests/e2e/agent-query-contract.spec.ts @@ -6,7 +6,7 @@ const DESCRIPTION = test('all platform metadata uses one accurate activation description', async () => { const configs = await loadAllPlatformConfigs(); - expect(configs.size).toBe(22); + expect(configs.size).toBe(23); for (const [platform, config] of configs) { expect(config.description, platform).toBe(DESCRIPTION); if (config.frontmatter?.description) { diff --git a/cli/tests/e2e/detect.spec.ts b/cli/tests/e2e/detect.spec.ts new file mode 100644 index 0000000..c157ab3 --- /dev/null +++ b/cli/tests/e2e/detect.spec.ts @@ -0,0 +1,22 @@ +import { expect, test } from '@playwright/test'; +import { mkdir, mkdtemp } from 'node:fs/promises'; +import { tmpdir } from 'node:os'; +import { join } from 'node:path'; +import { detectAIType, getAITypeDescription } from '../../src/utils/detect.js'; + +test('a sole .agents directory detects every consumer and still suggests codex', async () => { + const scratch = await mkdtemp(join(tmpdir(), 'uipro-detect-agents-')); + await mkdir(join(scratch, '.agents')); + + const { detected, suggested } = detectAIType(scratch); + + // All four .agents consumers are detected, OpenClaw included. + expect(detected).toEqual(['antigravity', 'codex', 'universal', 'openclaw']); + // The shared folder must not degrade the suggestion to "all" now that a + // fourth consumer exists — it stays on the .agents-family default. + expect(suggested).toBe('codex'); +}); + +test('openclaw has a platform description', async () => { + expect(getAITypeDescription('openclaw')).toBe('OpenClaw (.agents/skills/)'); +}); diff --git a/cli/tests/e2e/dry-run.spec.ts b/cli/tests/e2e/dry-run.spec.ts index ffc9af7..643c875 100644 --- a/cli/tests/e2e/dry-run.spec.ts +++ b/cli/tests/e2e/dry-run.spec.ts @@ -58,6 +58,19 @@ test('dry-run plan keeps amazonq data and sub-skills out of the rules folder', a expect(actions[2].endsWith(`: ${join(scratch, '.amazonq', 'skills')}`)).toBe(true); }); +test('dry-run plan supports the openclaw platform layout', async () => { + const scratch = await mkdtemp(join(tmpdir(), 'uipro-dry-run-openclaw-')); + + const actions = await planPlatformInstallActions(scratch, 'openclaw'); + + const joined = actions.join('\n'); + expect(joined).toContain( + join(scratch, '.agents', 'skills', 'ui-ux-pro-max', 'SKILL.md') + ); + expect(joined).toContain('Would copy data + scripts:'); + expect(joined).toContain('Would copy 6 sub-skills ('); +}); + test('dry-run plan for all platforms covers every unique layout', async () => { const scratch = await mkdtemp(join(tmpdir(), 'uipro-dry-run-all-')); diff --git a/cli/tests/e2e/template-script-paths.spec.ts b/cli/tests/e2e/template-script-paths.spec.ts index 8f961f7..50721b4 100644 --- a/cli/tests/e2e/template-script-paths.spec.ts +++ b/cli/tests/e2e/template-script-paths.spec.ts @@ -9,6 +9,7 @@ const cases = [ ['droid', '.factory/skills/ui-ux-pro-max/scripts/search.py'], ['zcode', '.zcode/skills/ui-ux-pro-max/scripts/search.py'], ['amazonq', '.amazonq/skills/ui-ux-pro-max/scripts/search.py'], + ['openclaw', '.agents/skills/ui-ux-pro-max/scripts/search.py'], ] as const; const SEARCH_COMMAND_COUNT = 17; diff --git a/scripts/validate-agent-guide.py b/scripts/validate-agent-guide.py index 60db8e4..0ea0f96 100644 --- a/scripts/validate-agent-guide.py +++ b/scripts/validate-agent-guide.py @@ -28,7 +28,7 @@ FLAGS = { "-f", "--persist", "--page", "--output-dir", "-o", "--force", "--variance", "--motion", "--density", } -PLATFORM_COUNT = 21 +PLATFORM_COUNT = 23 GUIDE_REQUIREMENTS = ( "## Query Contract", "one dominant intent", "Retry once", "Do not persist unverified output", "explicit accessibility outcome terms", diff --git a/skill.json b/skill.json index 1c2649e..396d417 100644 --- a/skill.json +++ b/skill.json @@ -2,7 +2,7 @@ "name": "ui-ux-pro-max", "displayName": "UI/UX Pro Max", "description": "AI-powered design intelligence with 79 UI styles, 192 color palettes, 74 font pairings, 119 UX guidelines, and 25 chart types across 22 tech stacks.", - "version": "2.13.0", + "version": "2.15.0", "author": "NextLevelBuilder", "license": "MIT", "homepage": "https://uupm.cc", diff --git a/src/ui-ux-pro-max/templates/platforms/openclaw.json b/src/ui-ux-pro-max/templates/platforms/openclaw.json new file mode 100644 index 0000000..cfea9f2 --- /dev/null +++ b/src/ui-ux-pro-max/templates/platforms/openclaw.json @@ -0,0 +1,21 @@ +{ + "platform": "openclaw", + "displayName": "OpenClaw", + "installType": "full", + "folderStructure": { + "root": ".agents", + "skillPath": "skills/ui-ux-pro-max", + "filename": "SKILL.md" + }, + "scriptPath": "skills/ui-ux-pro-max/scripts/search.py", + "frontmatter": { + "name": "ui-ux-pro-max", + "description": "UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks." + }, + "sections": { + "quickReference": false + }, + "title": "ui-ux-pro-max", + "description": "UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.", + "skillOrWorkflow": "Skill" +}