Knowledge Bridge Skill
知识桥接，连接外部规范和项目约定。
🔗 外部规范索引
注意: 请将以下路径修改为你实际的本地路径。
## 公司规范
- **前端规范**: ~/.claude/references/frontend-standards.md
- **后端规范**: ~/.claude/references/backend-standards.md
- **API规范**: ~/.claude/references/api-standards.md
- **UI组件库**: ~/.claude/references/design-system.md
🚫 反模式库 (Anti-Patterns)
通用反模式
// ❌ 禁止: 使用 any 类型
const data: any = response.data;
// ✅ 正确: 明确类型
const data: UserResponse = response.data;
// ❌ 禁止: 硬编码 Secret/Token
const apiKey = 'sk-xxx';
// ✅ 正确: 环境变量
const apiKey = process.env.API_KEY;
数据库反模式
// ❌ 禁止: 循环中数据库查询 (N+1问题)
for (const user of users) {
const orders = await db.query('SELECT * FROM orders WHERE user_id = ?', [user.id]);
}
// ✅ 正确: 批量查询
const orders = await db.query('SELECT * FROM orders 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]);
// ❌ 禁止: 直接输出用户输入
element.innerHTML = userInput;
// ✅ 正确: 转义输出
element.textContent = userInput;
架构反模式
// ❌ 禁止: 过度抽象
abstract class AbstractFactory<T extends BaseEntity> { }
// ✅ 正确: 简单直接
function createUser(data: CreateUserDTO): User { }
📝 项目约定
在项目 .ai_state/conventions.md 中记录：
## 项目约定
### 命名规范
- 组件: PascalCase
- 函数: camelCase
- 常量: UPPER_SNAKE_CASE
### 文件结构
- 组件: src/components/
- 页面: src/pages/
- 工具: src/utils/
### Git规范
- feat: 新功能
- fix: 修复
- refactor: 重构
🔄 规范更新
代码审查意见应沉淀为可执行的规则：
1. 发现问题
2. 记录到反模式库
3. 更新自动化检查
4. 形成持续改进闭环
使用方式
// 加载知识桥接
skill.load("knowledge-bridge");
// 检查代码是否违反反模式
knowledge.checkAntiPatterns(code);
// 获取项目约定
knowledge.getConventions();