Back to Details

update-claude-md

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Update Claude.md with learnings

更新CLAUDE.md以记录经验总结

What TO Add

需要添加的内容

  • Philosophy/conventions - e.g., "No backwards compatibility unless explicitly requested"
  • Gotchas - Non-obvious things that cause bugs repeatedly
  • Commands or scripts - New ways to run/test things
  • Structure changes - When directories or files move
  • Recent significant changes - New features, refactors, or capabilities added
  • 理念/惯例 - 例如：“除非明确要求，否则不保证向后兼容性”
  • 常见陷阱 - 那些非显而易见、反复导致bug的问题
  • 命令或脚本 - 运行/测试代码的新方式
  • 结构变更 - 目录或文件迁移的情况
  • 近期重大变更 - 新增的功能、重构或能力

What NOT to Add

无需添加的内容

  • Specific technical details about a single bug fix
  • Implementation details that are obvious from code
  • Temporary workarounds
  • One-off decisions that won't recur
  • Verbose explanations of how something works
Rule of thumb: If it's something you'd tell a new developer joining the project, add it. If it's just details about today's work, skip it.
  • 单个bug修复的具体技术细节
  • 从代码中可明显看出的实现细节
  • 临时解决方法
  • 不会重复出现的一次性决策
  • 关于某项功能工作原理的冗长解释
经验法则：如果是你会告诉新加入项目的开发者的内容，就添加进去；如果只是当天工作的细节，就跳过。

Instructions

操作步骤

  1. Read current CLAUDE.md - Understand what's already documented
  2. Review recent work - Check git log/diff for significant changes; extract meta learnings
  3. Update conservatively - Keep CLAUDE.md <300 lines. Remove outdated info if needed.
  1. 阅读当前的CLAUDE.md - 了解已有的文档内容
  2. 回顾近期工作 - 查看git日志/差异，找出重大变更；提炼元认知经验
  3. 谨慎更新 - 保持CLAUDE.md的篇幅在300行以内。必要时移除过时信息。

Output

输出要求

After updating, summarize:
  • What was added
  • What was removed (if anything)
  • Current line count
更新完成后，总结：
  • 添加了哪些内容
  • 移除了哪些内容（如有）
  • 当前的行数