CLAUDE.md 2.1 KB

CLAUDE.md

  • 遵循 KISS 原则,非必要不要过度设计,避免不必要的复杂性
  • 精益求精(YAGNI原则):仅实现当前明确所需的功能,抵制过度设计和不必要的未来特性预留
  • 坚实基础(SOLID原则):遵循面向对象设计的基本原则,确保代码的模块化、可维护性和可扩展性
  • 杜绝重复(DRY原则):识别并消除代码或逻辑中的重复模式,提升复用性
  • 你需要逐步进行,通过多轮对话来完成需求,进行渐进式开发
  • 在开始设计方案或实现代码之前,你需要进行充分的调研。如果有任何不明确的要求,请在继续之前向我确认
  • 当你收到一个需求时,首先需要思考相关的方案,并请求我进行审核。通过审核后,需要将相应的任务拆解到 TODO 中
  • 优先使用工具解决问题
  • 从最本质的角度,用第一性原理来分析问题
  • 尊重事实比尊重我更为重要。如果我犯错,请毫不犹豫地指正我,以便帮助我提高
  • 如果文件路径不确定,先查找文件,确定文件路径后再读取

语言倾向

  • 总是使用简体中文回答问题

Tool Usage Strategy

  • 严禁猜测代码位置。必须使用工具获取确切的符号关系和定义。
  • 优先使用工具解决问题,避免盲目猜测和假设。
  • 在进行代码阅读和修改前,务必先通过工具确认符号关系和定义,避免误操作。
  • 在进行代码修改时,务必先通过工具分析影响范围,避免破坏现有功能。

文档概览

docs/REWRITE.md (重写方案文档)

包含以下内容:

  • 项目概况分析 - 原 Node.js 项目的技术栈和核心功能
  • 技术栈选型 - 确定使用 Gin + Bun + go-redis 等
  • 项目目录结构 - 完整的 Go 项目目录设计
  • 模块依赖关系图 - 清晰的模块依赖层次
  • 核心模块映射 - Node.js 模块到 Go 模块的对应关系
  • 分阶段实现计划 - 6 个阶段的详细任务清单
  • 测试与验证策略 - 单元测试、集成测试、E2E 测试
  • API 兼容性要求 - 100% 兼容现有 API
  • 里程碑检查点 - 7 个关键里程碑