wenjunduan Knowledge Bridge Skill
知识桥接，连接外部规范和项目约定。
外部规范索引
## 公司规范（按需配置路径）
- **前端规范**: .claude/references/frontend-standards.md
- **后端规范**: .claude/references/backend-standards.md
- **API规范**: [配置路径]
反模式库 (Anti-Patterns)
通用反模式
// ❌ 禁止: 使用 any 类型
const data: any = response.data;
// ✅ 正确: 明确类型
const data: UserResponse = response.data;
// ❌ 禁止: 硬编码 Secret
const apiKey = 'sk-xxx';
// ✅ 正确: 环境变量
const apiKey = process.env.API_KEY;
数据库反模式
// ❌ 禁止: N+1查询
for (const user of users) {
const orders = await db.query('...', [user.id]);
}
// ✅ 正确: 批量查询
const orders = await db.query('... WHERE user_id IN (?)', [userIds]);
安全反模式
// ❌ 禁止: 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 中记录项目特定约定。
规范更新
代码审查意见应沉淀为规则：
- 发现问题
- 记录到反模式库
- 更新自动化检查
- 形成改进闭环