CLAUDE.md与Hooks——打造你的专属AI管家

# 项目说明

这是XXX后端服务，使用Go + Gin框架。
数据库使用PostgreSQL，ORM使用GORM。

## 编码规范

- 使用Tab缩进，不是空格
- 函数名使用驼峰命名
- 错误处理必须返回error，不要panic
- 所有导出函数必须有文档注释

## 注意事项

- /legacy/目录下的代码是遗留系统，不要修改
- 修改数据库schema前必须询问
- 提交前必须跑`make test`
- 不要提交.env文件

## 常用命令

- 运行测试：`make test`
- 构建：`make build`
- 启动服务：`make run`
- 数据库迁移：`make migrate`

## 工具使用偏好

- 搜索代码用GrepTool，不要用Bash的grep
- 读取配置文件优先用FileReadTool
- 执行命令前确认是否必要

[系统提示词 - 身份模块]
[系统提示词 - 工具模块]
[系统提示词 - 格式模块]
[CLAUDE.md内容] ← 插入在这里
[系统提示词 - 安全模块]
[历史对话]
[当前输入]

用户输入 → [beforeQuery] → 模型处理 → [beforeTool] → 工具执行 → [afterTool] → 模型继续 → [afterQuery] → 响应用户

// .claude/hooks/beforeQuery.js
export default function beforeQuery(input) {
  // 记录查询日志
  logQuery(input);

  // 检查敏感词
  if (containsSensitiveWords(input)) {
    return { action: 'warn', message: '输入包含敏感内容' };
  }

  return { action: 'continue' };
}

export default function beforeTool(tool, input) {
  // Bash命令安全检查
  if (tool === 'BashTool') {
    if (input.command.includes('rm -rf /')) {
      return { action: 'block', reason: '禁止删除根目录' };
    }

    // 自动添加确认标志
    if (input.command.includes('git push')) {
      return {
        action: 'modify',
        newInput: { ...input, confirm: true }
      };
    }
  }

  return { action: 'continue' };
}

export default function afterTool(tool, input, result) {
  // 记录工具执行
  logToolExecution(tool, input, result);

  // 格式化Bash输出
  if (tool === 'BashTool' && result.stdout) {
    return {
      action: 'modify',
      newResult: { ...result, stdout: truncate(result.stdout, 1000) }
    };
  }

  return { action: 'continue' };
}

## 代码规范

- 使用gofmt格式化Go代码
- 使用prettier格式化JS代码

export default function beforeTool(tool, input) {
  // 文件写入前自动格式化
  if (tool === 'FileWriteTool' || tool === 'FileEditTool') {
    if (input.path.endsWith('.go')) {
      input.content = formatGo(input.content);
    } else if (input.path.endsWith('.js')) {
      input.content = formatJS(input.content);
    }
  }
  return { action: 'continue' };
}

export default function afterTool(tool, input, result) {
  // git commit后自动跑测试
  if (tool === 'BashTool' && input.command.includes('git commit')) {
    // 在后台跑测试
    runTests();

    // 添加到结果
    result.message += '\n[已触发测试]';
  }
  return { action: 'continue' };
}

const SENSITIVE_FILES = ['.env', '.ssh/id_rsa', 'secrets.yaml'];

export default function beforeTool(tool, input) {
  if (tool === 'FileReadTool' || tool === 'FileEditTool') {
    if (SENSITIVE_FILES.some(f => input.path.includes(f))) {
      return {
        action: 'block',
        reason: '这是敏感文件，需要额外确认'
      };
    }
  }
  return { action: 'continue' };
}