Skip to content

VidyFoo/antigravity-skill-engine / .agent/skills/1-dev/architecting

architecting

Verified

Architects new features through the full lifecycle. Use when designing, planning, implementing, or extending features. Triggers on 'new feature', 'design', 'plan', 'implement', 'architect', 'prd', 'spec'.

resources/anti-patterns.md

View on GitHub
# Architecture Anti-Patterns (架构反模式)

> 严禁触犯以下红线。

## 1. 状态管理反模式

### ❌ 手动同步 Server State 到 Client Store
```typescript
// BAD
const { data } = useQuery(...)
useEffect(() => {
  setStoreData(data) // ❌ 多余的同步,导致双重真理来源
}, [data])

// GOOD
const { data } = useQuery(...) // ✅ 直接使用 data
```

### ❌ Store 解构
```typescript
// BAD - 任何 state 变化都会触发重渲染
const { count, inc } = useStore()

// GOOD -只监听 count 变化
const count = useStore(s => s.count)
const inc = useStore(s => s.inc)
```

## 2. API 与异步反模式

### ❌ 裸奔的 Fetch
没有 Zod 校验的 API 调用是类型不安全的源头。
**必须**使用 `YourSchema.parse(response)` 确保运行时安全。

### ❌ `catch (error: any)`
TypeScript 4.4+ 默认 error 为 unknown。
**必须**检查类型或断言:
```typescript
if (error instanceof Error) { ... }
```

## 3. 结构反模式

### ❌ 循环依赖 (Circular Dependency)
Feature A 引用 Feature B,Feature B 引用 Feature A。
**解法**: 提取公共部分到 `src/features/shared` 或 `src/lib`。

### ❌ 深度穿透 (Prop Drilling) > 3 层
超过 3 层的 Prop 传递。
**解法**: 使用 Context 或 Composition (Slot pattern)。
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall