Claude Code memory 完整教學

幫我健檢這個專案的 CLAUDE.md，目標是降低 context token 消耗，照下面順序做：
1. 跑 `wc -l CLAUDE.md` 告訴我現在幾行
2. 掃描檔案裡用 # 開頭的「給人看的歷史／原因／脈絡」註解
   （不是規則本身，是解釋「為什麼有這條」那種）
   列出來，改包成 <!-- --> 區塊註解格式
3. 找出「只跟某一種檔案類型有關」的規則
   （例如只跟 API、前端元件、SQL migration 有關）
   拆成獨立 .claude/rules/xxx.md，加 YAML frontmatter 的 paths 欄位綁 glob
   從主 CLAUDE.md 刪掉搬出去的部分
4. 檢查有沒有很長的段落（git workflow、風格指南等）適合用 @path 搬到外部檔
5. 全部改完後再跑一次 `wc -l CLAUDE.md` 告訴我差多少行
每一步動手前先列計畫給我看，我說 OK 再改。參考 https://code.claude.com/docs/en/memory 的規則。

掃我的 CLAUDE.md，把裡面用 # 開頭的「人類註解」（歷史原因、某某人決定的、為什麼有這條這種給人看的脈絡，不是規則本身）全部改包成 <!-- --> 區塊註解。
改之前先列出你找到哪幾段，等我 OK 再改。改完跑 `git diff CLAUDE.md` 給我確認。

我的 CLAUDE.md 裡有些規則只跟特定檔案類型有關（例如只跟 src/api/ 有關、只跟 React 元件有關、只跟 SQL migration 有關）。
幫我把這些規則拆到 .claude/rules/ 底下各自獨立檔，每個檔加上 YAML frontmatter：
---
paths:
  - "對應的 glob"
---
從主 CLAUDE.md 刪掉搬出去的規則。先給我拆分計畫（每一組會變成哪個檔、paths 寫什麼），我說 OK 再動。
規則格式參考 https://code.claude.com/docs/en/memory

跑 `wc -l CLAUDE.md`。如果超過 200 行，幫我分析：
1. 列出檔案裡每一大段的行數
2. 找出哪幾段最適合搬出去：
   - 歷史脈絡 → 用 HTML 註解 <!-- --> 包起來
   - 只跟某種檔案有關 → 搬去 .claude/rules/
   - 長範例 / 完整流程 → 搬去 docs/ 用 @path 拉回來
3. 估算砍完後會剩幾行
先給我建議清單，我選做哪幾項再動手。

找出我 CLAUDE.md 裡「很長的段落而且跨專案通用」的內容（例如 git workflow、個人 code style 偏好、commit 規範）。
幫我搬到外部檔，主檔改用 @path 拉進來：
- 跨專案個人偏好：搬到 ~/.claude/xxx.md，用 @~/.claude/xxx.md
- 專案內細節：搬到 docs/xxx.md，用 @docs/xxx.md
先列你要搬哪幾段、目標檔名，我說 OK 再動。

# Rules
# 2025-08-15: 這條是因為 Sarah 反映她 PR 一直被 reject 才加的
# 不要刪，跟 Compliance team 確認過
- Always include type annotations on exported functions
# Mike 覺得這條未來可能要拿掉
- Prefer `import type` over `import { type }`

# Rules
<!--
2025-08-15: 這條是因為 Sarah 反映她 PR 一直被 reject 才加的
不要刪，跟 Compliance team 確認過
-->
- Always include type annotations on exported functions
<!-- Mike 覺得這條未來可能要拿掉 -->
- Prefer `import type` over `import { type }`

# CLAUDE.md（主檔）
## API rules（50 行）
- All endpoints must validate input with zod
- Use standard error response from src/api/errors.ts
- ... 還有 47 行
## React rules（50 行）
- Functional components only, no class components
- Tailwind only, no CSS modules
- ... 還有 47 行
## DB rules（50 行）
- Migrations must be reversible
- ... 還有 48 行

# .claude/rules/api.md
---
paths:
  - "src/api/**/*.ts"
---
- All endpoints must validate input with zod
- Use standard error response from src/api/errors.ts

# .claude/rules/react.md
---
paths:
  - "src/components/**/*.tsx"
  - "src/pages/**/*.tsx"
---
- Functional components only, no class components
- Tailwind only, no CSS modules

# .claude/rules/db.md
---
paths:
  - "migrations/**/*.sql"
  - "src/db/**/*.ts"
---
- Migrations must be reversible

# Project Rules
- 2-space indent
- Run `npm test` before commit
- API handlers in src/api/handlers/
@~/.claude/my-personal-style.md   # 跨專案共享
@docs/git-workflow.md             # 細節外移