# Knowledge Bridge

> 知识桥接，公司规范索引，反模式库

- Skill: `wenjunduan/knowledge-bridge-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wenjunduan/knowledge-bridge-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wenjunduan/knowledge-bridge-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: wenjunduan (https://skillmd.com/u/wenjunduan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wenjunduan/knowledge-bridge-2

---


# Knowledge Bridge Skill

知识桥接，连接外部规范和项目约定。

## 外部规范索引

```markdown
## 公司规范（按需配置路径）

- **前端规范**: .claude/references/frontend-standards.md
- **后端规范**: .claude/references/backend-standards.md
- **API规范**: [配置路径]
```

## 反模式库 (Anti-Patterns)

### 通用反模式

```typescript
// ❌ 禁止: 使用 any 类型
const data: any = response.data;

// ✅ 正确: 明确类型
const data: UserResponse = response.data;
```

```typescript
// ❌ 禁止: 硬编码 Secret
const apiKey = 'sk-xxx';

// ✅ 正确: 环境变量
const apiKey = process.env.API_KEY;
```

### 数据库反模式

```typescript
// ❌ 禁止: N+1查询
for (const user of users) {
  const orders = await db.query('...', [user.id]);
}

// ✅ 正确: 批量查询
const orders = await db.query('... WHERE user_id IN (?)', [userIds]);
```

### 安全反模式

```typescript
// ❌ 禁止: SQL拼接
const sql = `SELECT * FROM users WHERE id = ${userId}`;

// ✅ 正确: 参数化查询
const user = await db.query('SELECT * FROM users WHERE id = $1', [userId]);
```

## 项目约定

在 `project_document/.ai_state/conventions.md` 中记录项目特定约定。

## 规范更新

代码审查意见应沉淀为规则：
1. 发现问题
2. 记录到反模式库
3. 更新自动化检查
4. 形成改进闭环