dev-engineer
Adds logic, state management, TypeScript types, and CRUD operations to UI. Works AFTER ui-first-builder creates the interface. Implements Zustand stores, form handling with React Hook Form + Zod, and prepares for backend connection. Triggers: add logic, add functionality, make it work, state management, form validation, data operations, TypeScript types.
wasintoh · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add wasintoh/toh-framework --skill dev-engineer技能说明
name: dev-engineer description: > Adds logic, state management, TypeScript types, and CRUD operations to UI. Works AFTER ui-first-builder creates the interface. Implements Zustand stores, form handling with React Hook Form + Zod, and prepares for backend connection. Triggers: add logic, add functionality, make it work, state management, form validation, data operations, TypeScript types.
Dev Engineer
Add brains to the beauty. Connect logic to UI seamlessly.
<core_principle>
The Enhancement Promise
UI exists (from ui-first-builder) → Add state/logic → UI becomes functional
We don't create UI. We make existing UI work. </core_principle>
<default_to_action> NEVER ask:
- "What state management should I use?" → Use Zustand (our standard)
- "What validation library?" → Use Zod (our standard)
- "What form library?" → Use React Hook Form (our standard)
ALWAYS do:
- When scaffolding a NEW project, run
npm view [package] versionfor each dependency to get the latest STABLE before pinning — check live, never hardcode a version number here (the framework must not go stale; internalize the principle, not the digits) - Create TypeScript types FIRST
- Create Zustand store for state
- Add form validation with Zod
- Prepare CRUD operations (mock first, real later) </default_to_action>
<typescript_patterns>
Type Definitions
Location
Always create: src/types/index.ts or src/types/[feature].ts
Pattern
// src/types/index.ts
// Entity types
export interface User {
id: string
name: string
email: string
role: "admin" | "user" | "editor"
avatar?: string
createdAt: Date
updatedAt: Date
}
export interface Product {
id: string
name: string
description: string
price: number
stock: number
category: string
images: string[]
isActive: boolean
createdAt: Date
updatedAt: Date
}
// Form types (for create/update)
export type CreateProductInput = Omit<Product, "id" | "createdAt" | "updatedAt">
export type UpdateProductInput = Partial<CreateProductInput>
// API response types
export interface PaginatedResponse<T> {
data: T[]
total: number
page: number
pageSize: number
totalPages: number
}
// Common utility types
export type ID = string | number
export type Nullable<T> = T | null
Naming Conventions
- Entity:
User,Product,Order(singular, PascalCase) - Input:
CreateUserInput,UpdateUserInput - Response:
UserResponse,PaginatedResponse<User> - Props:
UserCardProps,ProductListProps</typescript_patterns>
<zustand_patterns>
State Management with Zustand
Location
Create: src/stores/[feature]-store.ts
Basic Store Pattern
// src/stores/product-store.ts
import { create } from 'zustand'
import { Product, CreateProductInput } from '@/types'
import { mockProducts } from '@/lib/mock-data'
interface ProductState {
// State
products: Product[]
selectedProduct: Product | null
isLoading: boolean
error: string | null
// Actions
fetchProducts: () => Promise<void>
addProduct: (input: CreateProductInput) => Promise<void>
updateProduct: (id: string, input: Partial<Product>) => Promise<void>
deleteProduct: (id: string) => Promise<void>
selectProduct: (product: Product | null) => void
}
export const useProductStore = create<ProductState>((set, get) => ({
// Initial state
products: [],
selectedProduct: null,
isLoading: false,
error: null,
// Actions
fetchProducts: async () => {
set({ isLoading: true, error: null })
try {
// TODO: Replace with real API call
await new Promise(resolve => setTimeout(resolve, 500)) // Simulate delay
set({ products: mockProducts, isLoading: false })
} catch (error) {
set({ error: 'Failed to fetch products', isLoading: false })
}
},
addProduct: async (input) => {
set({ isLoading: true, error: null })
try {
// TODO: Replace with real API call
const newProduct: Product = {
...input,
id: crypto.randomUUID(),
createdAt: new Date(),
updatedAt: new Date(),
}
set(state => ({
products: [...state.products, newProduct],
isLoading: false
}))
} catch (error) {
set({ error: 'Failed to add product', isLoading: false })
}
},
updateProduct: async (id, input) => {
set({ isLoading: true, error: null })
try {
// TODO: Replace with real API call
set(state => ({
products: state.products.map(p =>
p.id === id ? { ...p, ...input, updatedAt: new Date() } : p
),
isLoading: false
}))
} catch (error) {
set({ error: 'Failed to update product', isLoading: false })
}
},
deleteProduct: async (id) => {
set({ isLoading: true, error: null })
try {
// TODO: Replace with real API call
set(state => ({
products: state.products.filter(p => p.id !== id),
isLoading: false
}))
} catch (error) {
set({ error: 'Failed to delete product', isLoading: false })
}
},
selectProduct: (product) => set({ selectedProduct: product }),
}))
Using Store in Components
// In component
import { useProductStore } from '@/stores/product-store'
export function ProductList() {
const { products, isLoading, fetchProducts } = useProductStore()
useEffect(() => {
fetchProducts()
}, [fetchProducts])
if (isLoading) return <LoadingSkeleton />
return (
<div>
{products.map(product => (
<ProductCard key={product.id} product={product} />
))}
</div>
)
}
</zustand_patterns>
<form_patterns>
Forms with React Hook Form + Zod
Validation messages should match the project's language setting in CLAUDE.md.
Schema Definition
// src/lib/validations/product.ts
import { z } from 'zod'
export const createProductSchema = z.object({
name: z.string()
.min(2, 'Product name must be at least 2 characters')
.max(1
阅读完整来源 ↗