我怎麼讓 Claude Code 記住所有事

# Claude 實際跑的命令：
go test -short ./handler/admin/...
# 在: ~/code/api-gateway/     ← 錯的 REPO
# 應該在: ~/code/auth-service/

~/.claude/
├── settings.json              ← 神經系統（hooks 接線）
│
├── rules/                     ← Tier 1: 行為護欄
│   ├── agent-behavior.md      #   自動存檔協議、知識路由
│   ├── error-recovery.md      #   反思協議、重試預算
│   ├── grader-pipeline.md     #   每個服務的品質關卡
│   └── workflow-discipline.md #   Worktree-first、branch 命名
│
├── projects/*/memory/         ← Tier 2: 修正 & 專案事實
│   ├── MEMORY.md              #   索引（每個 session 都載入）
│   └── *.md                   #   個別 memory 檔案
│
├── skills/                    ← Tier 3: 可重用流程
│   ├── SKILL_INDEX.md         #   觸發條件索引
│   └── */SKILL.md             #   15+ 個 skill 檔案
│
├── scripts/                   ← 25 個 bash scripts（執行層）
│   ├── guard-*.sh             #   5 個 PreToolUse guards
│   ├── detect-*.sh            #   修正 & 變更偵測
│   ├── post-stop-*.sh         #   Session 結束反思
│   ├── nudge-learn.sh         #   定期學習提醒
│   └── pre-compact-*.sh       #   Context 壓縮復原
│
└── tools/                     ← 跨 session 搜尋
    ├── recall_index.py        #   JSONL → SQLite FTS5 indexer
    └── recall_search.py       #   BM25 搜尋 + recency boost

// file: ~/.claude/settings.json（真的那個，現在 production 在跑的）
{
  "hooks": {
    "SessionStart": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "python3 ~/.claude/tools/recall_index.py; bash ~/.claude/scripts/detect-external-changes.sh; echo \"Branch: $(git branch --show-current) | Uncommitted: $(git status --short | wc -l) files\""
      }]
    }],
    "UserPromptSubmit": [{
      "matcher": "*",
      "hooks": [
        { "type": "command", "command": "bash ~/.claude/scripts/detect-correction.sh" },
        { "type": "command", "command": "bash ~/.claude/scripts/nudge-learn.sh" }
      ]
    }],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          { "type": "command", "command": "bash ~/.claude/scripts/guard-force-push.sh" },
          { "type": "command", "command": "bash ~/.claude/scripts/guard-dangerous-commands.sh" },
          { "type": "command", "command": "bash ~/.claude/scripts/guard-aws-env.sh" },
          { "type": "command", "command": "bash ~/.claude/scripts/guard-commit-master.sh" }
        ]
      },
      {
        "matcher": "Edit",
        "hooks": [{ "type": "command", "command": "bash ~/.claude/scripts/guard-worktree.sh" }]
      },
      {
        "matcher": "Write",
        "hooks": [{ "type": "command", "command": "bash ~/.claude/scripts/guard-worktree.sh" }]
      }
    ],
    "PostToolUse": [{
      "matcher": "Edit",
      "hooks": [{ "type": "command", "command": "bash ~/.claude/scripts/post-edit-gofmt.sh" }]
    }],
    "Stop": [{
      "matcher": "",
      "hooks": [
        { "type": "command", "command": "bash ~/.claude/scripts/post-stop-reflect.sh" }
      ]
    }]
  }
}

#!/bin/bash
# file: ~/.claude/scripts/guard-commit-master.sh
INPUT=$(cat)
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty' 2>/dev/null)
[[ -z "$COMMAND" ]] && exit 0

if echo "$COMMAND" | grep -qE 'git\s+commit'; then
    BRANCH=$(git branch --show-current 2>/dev/null)
    if [[ "$BRANCH" == "master" || "$BRANCH" == "main" ]]; then
        echo "BLOCKED: Cannot commit on $BRANCH. Use a worktree branch."
        echo "  Use EnterWorktree with a ticket name (e.g., PROJ-1234-description)."
        exit 2
    fi
fi

exit 0

#!/bin/bash
# file: ~/.claude/scripts/guard-worktree.sh
INPUT=$(cat)
FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty' 2>/dev/null)

# 允許編輯 .claude/ config
if [[ "$FILE_PATH" == *"/.claude/"* ]]; then
    exit 0
fi

# 允許 home 目錄的 dotfiles（不在 repo 裡）
if [[ "$FILE_PATH" == "$HOME/"* ]] && [[ "$FILE_PATH" != *"/code/"* ]]; then
    exit 0
fi

# 不在 git repo 裡就放行
if ! git rev-parse --is-inside-work-tree &>/dev/null 2>&1; then
    exit 0
fi

# 檢查是不是在 worktree 裡（git-dir 包含 /worktrees/）
GIT_DIR=$(git rev-parse --git-dir 2>/dev/null)
if [[ "$GIT_DIR" == *"/worktrees/"* ]]; then
    exit 0
fi

echo "BLOCKED: Not in a worktree. Call EnterWorktree before editing source files."
exit 2

#!/bin/bash
# file: ~/.claude/scripts/guard-aws-env.sh
INPUT=$(cat)
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty' 2>/dev/null)
[[ -z "$COMMAND" ]] && exit 0

# 擋住 inline credentials
if echo "$COMMAND" | grep -qE 'AWS_SECRET_ACCESS_KEY='; then
    echo "BLOCKED: Inline AWS credentials detected. Use AWS_PROFILE instead."
    exit 2
fi

# 抓 profile/table prefix 不匹配
if echo "$COMMAND" | grep -qE 'dynamodb.*(scan|query|get-item|put-item)'; then
    if echo "$COMMAND" | grep -qE '(PROFILE=stage|--profile stage)' && \
       echo "$COMMAND" | grep -qE '(prod-|prd-)myapp'; then
        echo "BLOCKED: Stage profile but production table name detected."
        echo "  Stage tables use prefix: stg-myapp-"
        exit 2
    fi
    if echo "$COMMAND" | grep -qE '(PROFILE=prod|--profile prod)' && \
       echo "$COMMAND" | grep -q 'stg-myapp'; then
        echo "BLOCKED: Prod profile but staging table name detected."
        exit 2
    fi
fi

exit 0

#!/bin/bash
# file: ~/.claude/scripts/detect-correction.sh
# 每個 prompt 都跑——必須快（<200ms）
INPUT=$(cat)
PROMPT=$(echo "$INPUT" | jq -r '.prompt // ""' 2>/dev/null)
[ -z "$PROMPT" ] && exit 0

# 修正 pattern（中文 + 英文）
if echo "$PROMPT" | grep -qiE \
  '不是這|不要這|不要用|不對|錯了|搞錯|你搞|重來|重做|別這樣|wrong|not what I|don.t do that|that.s wrong|stop doing|no[,.].*instead|no[,.].*use'; then

  # 建 marker 讓 Stop hook 知道有修正
  touch ~/.claude/sessions/.correction-detected

  cat << 'JSONEOF'
{"additionalContext": "User correction detected. MANDATORY: After fixing this, save the correction as a feedback memory BEFORE continuing. Include Why and How-to-apply."}
JSONEOF
fi

exit 0

#!/bin/bash
# file: ~/.claude/scripts/nudge-learn.sh
COUNTER_FILE="$HOME/.claude/sessions/.prompt-counter"
NUDGE_INTERVAL=15

if [[ -f "$COUNTER_FILE" ]]; then
    COUNT=$(cat "$COUNTER_FILE" 2>/dev/null | tr -d ' \n')
    COUNT=$((COUNT + 1))
else
    COUNT=1
fi
echo "$COUNT" > "$COUNTER_FILE"

if [[ $((COUNT % NUDGE_INTERVAL)) -eq 0 ]]; then
    cat << 'JSONEOF'
{"additionalContext": "LEARNING REVIEW (periodic). Check:\n- Stuck? Run /recall — a past session may have the answer.\n- User corrected you? Save to memory.\n- Complex task solved (5+ tool calls)? Save as skill.\nOnly act if something is genuinely worth saving."}
JSONEOF
fi

exit 0

#!/bin/bash
# file: ~/.claude/scripts/post-stop-reflect.sh（簡化版）
INPUT=$(cat)

# 自我閘門：每個 session 只擋一次
GATE_FILE="$HOME/.claude/sessions/.stop-reflected"
if [[ -f "$GATE_FILE" ]]; then
    echo '{"decision": "approve"}'
    exit 0
fi

CORRECTIONS_DETECTED=false
if [[ -f ~/.claude/sessions/.correction-detected ]]; then
    CORRECTIONS_DETECTED=true
    rm -f ~/.claude/sessions/.correction-detected
fi

SUBSTANTIAL=false
TRANSCRIPT=$(echo "$INPUT" | jq -r '.transcript_path // ""' 2>/dev/null)
if [[ -n "$TRANSCRIPT" ]] && [[ -f "$TRANSCRIPT" ]]; then
    SIZE=$(wc -c < "$TRANSCRIPT" 2>/dev/null | tr -d ' ')
    [[ "$SIZE" -gt 30000 ]] && SUBSTANTIAL=true
fi

if [[ "$SUBSTANTIAL" == "true" ]] || [[ "$CORRECTIONS_DETECTED" == "true" ]]; then
    touch "$GATE_FILE"  # 只擋一次
    MSG="MANDATORY SESSION REFLECTION:\n\n"
    if [[ "$CORRECTIONS_DETECTED" == "true" ]]; then
        MSG="${MSG}CORRECTIONS DETECTED — save each as feedback memory NOW.\n\n"
    fi
    MSG="${MSG}1) Reusable patterns? → /learn\n"
    MSG="${MSG}2) Mistakes to prevent? → feedback memory\n"
    MSG="${MSG}3) New user preferences? → user memory\n"

    MSG_ESCAPED=$(echo -e "$MSG" | python3 -c 'import sys,json; print(json.dumps(sys.stdin.read()))')
    echo "{\"decision\": \"block\", \"reason\": \"Save learnings first\", \"systemMessage\": $MSG_ESCAPED}"
else
    echo '{"decision": "approve"}'
fi

<!-- file: ~/.claude/rules/agent-behavior.md -->
---
paths:
  - "src/**"
  - "cmd/**"
  - "handler/**"
  - "service/**"
---

## Auto-Save（強制——不是可選的）

不要問 permission。不要跳過。不要推遲到 session 結束。

### 使用者修正 — 立刻存
1. 修好問題
2. **立刻**存修正為 feedback
3. 分類：行為 → rules/、專案事實 → memory/、流程 → skills/
4. 包含 **Why** 和 **How to apply**

## 任何 Failure，停下來反思

1. **Recall**: "我看過這個嗎？" → 跑 /recall
2. **Diagnose**: "Root cause，不是 symptom。"
3. **Plan**: "什麼改動會修好這個？"
4. **Check**: "我是不是在重複同樣的事期待不同結果？"
5. **Learn**: "值得用 /learn 記下來嗎？"

## 重試預算
- 同一個方法最多 **3 次**。然後換一個。
- **2 種方法都失敗** → 問 user。
- **同一個 failure 出現兩次** → 自動存 feedback memory。

<!-- file: memory/blog-quality-feedback.md -->
---
name: blog-quality-feedback
description: 文章必須教，不是摘要。深度不可妥協。
type: feedback
---

Conrad 退回了第一批 blog 文章，說品質太低。

具體問題：
- 太短（4-5 分鐘閱讀）——好的技術文章要 10-20 分鐘
- 太淺——讀起來像 README，不像教學文
- 沒有可行動的 takeaway
- Pseudo-code 不是真的 code

**Why:** Conrad 的品牌是「用深度教學的後端工程師」。淺的文章毀掉信譽。

**How to apply:** 每篇文章發布前必須通過 BLOG_QUALITY.md。

<!-- file: ~/.claude/skills/deploy-staging/SKILL.md -->
---
name: deploy-staging
description: Build 完成後觸發 staging deployment
allowed-tools: Bash(gh *), Bash(aws *)
model: sonnet
---

# Step 1: 等 Build and Publish 完成
gh run list --workflow "Build and Publish" --branch master --limit 1 \
  --repo my-org/api-gateway \
  --json databaseId,status,conclusion,headSha

# Step 2: 觸發 staging deployment
gh workflow run "Deploy to staging" \
  --repo my-org/api-gateway \
  -f environment=stg

# Step 3: 監控 deployment pipeline
aws codepipeline get-pipeline-state \
  --name myapp-staging-pipeline \
  --profile stage --region us-west-2

# file: ~/.claude/tools/recall_index.py
CHUNK_TARGET_CHARS = 3000
CHUNK_OVERLAP_CHARS = 500

def chunk_turns(turns: list[dict], target_chars=CHUNK_TARGET_CHARS):
    """把對話切成可搜尋的 chunks。"""
    chunks = []
    current_chunk = []
    current_chars = 0

    for turn in turns:
        text = f"{turn['role'].upper()}: {turn['text']}"

        if current_chars + len(text) > target_chars and current_chunk:
            chunk_text = "\n\n".join(current_chunk)
            chunks.append({
                "content": chunk_text,
                "has_code": bool(re.search(r"```|func |def |class ", chunk_text)),
                "has_error": bool(re.search(
                    r"error|panic|FAIL|nil pointer", chunk_text, re.IGNORECASE
                )),
            })
            # 保留最後一筆作為 overlap
            current_chunk = [current_chunk[-1]] if current_chunk else []
            current_chars = len(current_chunk[0]) if current_chunk else 0

        current_chunk.append(text)
        current_chars += len(text)

    return chunks

# file: ~/.claude/tools/recall_search.py
def recency_boost(session_date_str: str, half_life_days: float = 30.0) -> float:
    """30 天前的 session 權重 50%。最近的工作更重要。"""
    session_date = datetime.fromisoformat(session_date_str)
    age_days = (datetime.now() - session_date).total_seconds() / 86400
    return 2 ** (-age_days / half_life_days)

# 合計: score = bm25_score * (0.7 + 0.3 * recency)

#!/bin/bash
# file: ~/.claude/scripts/guard-main.sh
INPUT=$(cat)
CMD=$(echo "$INPUT" | jq -r '.tool_input.command // empty' 2>/dev/null)
[[ -z "$CMD" ]] && exit 0

if echo "$CMD" | grep -qE 'git\s+(commit|push)'; then
    BRANCH=$(git branch --show-current 2>/dev/null)
    if [[ "$BRANCH" == "main" || "$BRANCH" == "master" ]]; then
        echo "BLOCKED: Use a feature branch, not $BRANCH"
        exit 2
    fi
fi
exit 0

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{ "type": "command", "command": "bash ~/.claude/scripts/guard-main.sh" }]
    }]
  }
}

<!-- file: ~/.claude/projects/<your-project>/memory/corrections.md -->
---
name: corrections
description: Claude 搞錯需要記住的事
type: feedback
---

## 這個 repo 用 pnpm 不是 npm
**Why:** npm 在我們的 monorepo 造成 lockfile 衝突
**How to apply:** install/add/remove 永遠用 pnpm

## API prefix 是 /api/v2/，不是 /api/v1/
**Why:** v1 在 2024 就 deprecated 了，舊 docs 裡還有
**How to apply:** 所有新 endpoint 和測試 URL 用 /api/v2/