Merge pull request #1233 from objectstack-ai/claude/merge-objectui-copilot-skills

[WIP] Refactor objectui skills into single tree structure

Author: xuyushun441-sys

CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+
+- **Copilot Skills Architecture Unified** (`skills`): Consolidated 10 parallel ObjectUI Copilot skills (`objectui-auth-permissions`, `objectui-console-development`, `objectui-data-integration`, `objectui-i18n`, `objectui-mobile`, `objectui-plugin-development`, `objectui-project-setup`, `objectui-schema-expressions`, `objectui-sdui-page-builder`, `objectui-testing`) into a single tree-based `skills/objectui/` structure aligned with shadcn/ui best practices. The new architecture features:
+  - **Single entry point** (`skills/objectui/SKILL.md`): Unified skill manifest with core principles, architecture overview, and indexed references to guides and rules.
+  - **Global rules** (`skills/objectui/rules/`): Protocol compliance, styling constraints, component composition patterns, and no-touch zones as dedicated markdown files.
+  - **Domain guides** (`skills/objectui/guides/`): 10 specialized guides (page-builder, plugin-development, schema-expressions, data-integration, project-setup, testing, i18n, mobile, auth-permissions, console-development) for deep domain expertise.
+  - **Unified evals** (`skills/objectui/evals/`): All evaluation JSON files consolidated from parallel skill evals directories.
+  - **Updated skills-lock.json**: Now references only `objectui` (local) and `shadcn` (github) skills, removing fragmented cross-skill dependencies.
+  - This restructuring improves AI agent selection accuracy, reduces maintenance overhead, and aligns with shadcn/ui's single-skill tree model for better ecosystem compatibility.
+
 ### Improved
 
 - **Console UI design optimization sweep** (`@object-ui/console`): Comprehensive accessibility and design consistency improvements across all major console interfaces:

ROADMAP.md

@@ -1,11 +1,11 @@
 # ObjectUI Development Roadmap
 
-> **Last Updated:** April 1, 2026
+> **Last Updated:** April 14, 2026
 > **Current Version:** v0.5.x
 > **Spec Version:** @objectstack/spec v3.3.0
 > **Client Version:** @objectstack/client v3.3.0
 > **Target UX Benchmark:** 🎯 Airtable parity
-> **Current Priority:** AppShell Navigation · Designer Interaction · **View Config Live Preview Sync ✅** · Dashboard Config Panel · Airtable UX Polish · **Flow Designer ✅** · **App Creation & Editing Flow ✅** · **System Settings & App Management ✅** · **Right-Side Visual Editor Drawer ✅** · **Object Manager & Field Designer ✅** · **AI SDUI Chatbot (service-ai + vercel/ai) ✅** · **Unified Home Dashboard ✅**
+> **Current Priority:** AppShell Navigation · Designer Interaction · **View Config Live Preview Sync ✅** · Dashboard Config Panel · Airtable UX Polish · **Flow Designer ✅** · **App Creation & Editing Flow ✅** · **System Settings & App Management ✅** · **Right-Side Visual Editor Drawer ✅** · **Object Manager & Field Designer ✅** · **AI SDUI Chatbot (service-ai + vercel/ai) ✅** · **Unified Home Dashboard ✅** · **Unified Copilot Skills Architecture ✅**
 
 ---
 

skills-lock.json

@@ -1,20 +1,15 @@
 {
   "version": 1,
   "skills": {
-    "frontend-design": {
-      "source": "anthropics/skills",
-      "sourceType": "github",
-      "computedHash": "063a0e6448123cd359ad0044cc46b0e490cc7964d45ef4bb9fd842bd2ffbca67"
+    "objectui": {
+      "source": "local",
+      "sourceType": "local",
+      "path": "./skills/objectui"
     },
     "shadcn": {
       "source": "shadcn/ui",
       "sourceType": "github",
       "computedHash": "873c67922d80775a9fdf596db7964b579f0408c30ec6e3d11989f6055bbec89f"
-    },
-    "skill-creator": {
-      "source": "anthropics/skills",
-      "sourceType": "github",
-      "computedHash": "b122f4d1e91aa1d83027e050b5b37c3156203ee85458d7b1360bc48167c9e02a"
     }
   }
 }

skills/objectui/README.md

@@ -0,0 +1,104 @@
+# ObjectUI Copilot Skill
+
+This directory contains the unified ObjectUI Copilot skill, consolidating all ObjectUI development knowledge into a single tree-based structure aligned with [shadcn/ui](https://github.com/shadcn-ui/ui/tree/main/skills/shadcn) best practices.
+
+## Structure
+
+```
+skills/objectui/
+├── SKILL.md                  # Main entry point - core principles & architecture
+├── rules/                    # Global non-negotiable constraints
+│   ├── protocol.md          # JSON Protocol compliance rules
+│   ├── styling.md           # Tailwind & Shadcn styling rules
+│   ├── composition.md       # Component composition patterns
+│   └── no-touch-zones.md    # Protected upstream files
+├── guides/                   # Domain-specific expertise (10 guides)
+│   ├── page-builder.md              # Schema-driven page building
+│   ├── plugin-development.md        # Creating custom plugins
+│   ├── schema-expressions.md        # Expression syntax & debugging
+│   ├── data-integration.md          # DataSource & API integration
+│   ├── project-setup.md             # Project initialization & config
+│   ├── testing.md                   # Testing patterns (Vitest, Storybook, Playwright)
+│   ├── i18n.md                      # Internationalization & localization
+│   ├── mobile.md                    # Mobile responsiveness & PWA
+│   ├── auth-permissions.md          # Authentication & RBAC
+│   └── console-development.md       # Console app development
+├── evals/                    # Evaluation test cases (10 JSON files)
+└── agents/                   # Agent configurations (empty, reserved for future)
+```
+
+## Why This Structure?
+
+### Before (10 Parallel Skills)
+- `skills/objectui-auth-permissions/`
+- `skills/objectui-console-development/`
+- `skills/objectui-data-integration/`
+- `skills/objectui-i18n/`
+- `skills/objectui-mobile/`
+- `skills/objectui-plugin-development/`
+- `skills/objectui-project-setup/`
+- `skills/objectui-schema-expressions/`
+- `skills/objectui-sdui-page-builder/`
+- `skills/objectui-testing/`
+
+**Problems:**
+- Agent had to choose between 10+ skills
+- Cross-skill knowledge was fragmented
+- Maintenance overhead (10 separate manifests)
+- Inconsistent with shadcn/ui single-skill model
+
+### After (1 Tree-Based Skill)
+- `skills/objectui/` (single skill)
+  - `SKILL.md` - unified entry point
+  - `rules/` - global constraints
+  - `guides/` - domain expertise
+
+**Benefits:**
+- ✅ Single unified entry point
+- ✅ AI agent always knows where to look
+- ✅ Global rules apply consistently
+- ✅ Aligned with shadcn/ui architecture
+- ✅ Easier maintenance and updates
+
+## Usage
+
+When working with ObjectUI, the AI agent will:
+
+1. **Start with `SKILL.md`** - Core principles, architecture, and quick reference
+2. **Check `rules/`** - Ensure compliance with non-negotiable constraints
+3. **Consult `guides/`** - Get deep domain expertise for specific tasks
+
+### Example Flow
+
+**User:** "Help me build a dashboard page with ObjectUI"
+
+**Agent:**
+1. Reads `SKILL.md` → Understands core principles
+2. Checks `rules/protocol.md` → Learns JSON schema structure
+3. Checks `rules/styling.md` → Learns Tailwind requirements
+4. Reads `guides/page-builder.md` → Gets dashboard building patterns
+5. Reads `guides/schema-expressions.md` → Learns dynamic expressions
+
+## Maintenance
+
+When adding new content:
+
+- **Core principles or architecture changes** → Update `SKILL.md`
+- **New global rule** → Add to `rules/`
+- **New domain area** → Add guide to `guides/`
+- **New eval test** → Add JSON to `evals/`
+
+## Migration Notes
+
+This structure was created on April 14, 2026, consolidating:
+- 10 parallel skill directories
+- 10 SKILL.md files → 1 SKILL.md + 10 guides
+- 10 evals directories → 1 unified evals/
+- Cross-skill references unified into single namespace
+
+All content preserved and reorganized for better discoverability.
+
+## Reference
+
+- **shadcn/ui skill structure**: https://github.com/shadcn-ui/ui/tree/main/skills/shadcn
+- **Issue**: [#架构优化-将-objectui-多-Copilot-skill-合并为单-skill-树状体系](https://github.com/objectstack-ai/objectui/issues)