07 - 记忆与上下文

摘要消息在 messages[] 里的位置就是被替换掉的那几轮：

{
  "role": "user",
  "content": [
    {
      "type": "text",
      "text": "<compacted-summary turns=3..45>\n用户在中段要求实现一个 Skill 调用追踪，已完成：\n- components/SkillTracer.tsx（监听 Skill 工具调用事件）\n- lib/skill-log.ts（本地 JSON 持久化）\n关键决策：\n- 选 localStorage 而非 IndexedDB\n- 字段固定为 {ts, name, args, result}\n未完成：前端展示面板\n</compacted-summary>"
    }
  ]
}

• 摘要由模型自己生成，压缩前把要压的 turns 作为输入问一句"请总结成结构化摘要"
• 结果以 role:user 注入（和工具结果一个通道）
• 下一次调用时，模型看到这段摘要会把它当作"之前发生了这些事"的事实

# CLAUDE.md — claude-code-learn

## 设计系统
- 字体：仅 Fraunces / Noto Serif SC / Instrument Sans / PingFang SC / JetBrains Mono
- 配色：近单色 + 单一赤陶 accent
- 圆角：3 / 6 / 10px，不使用 16px+

## 内容原则
- 技术陈述基于公开行为
- 不写"隐藏特性""未公开命令"

## 技术栈
- Next.js 15 App Router，output: "export" 静态导出
- 字体通过 @fontsource 自托管，禁用 Google Fonts

## 分支与提交
- 始终在功能分支工作
- commit message 英文

不该写的东西：

• ❌ "这次任务先加个 console.log 看看" — 一次性，不属于持久规则
• ❌ "A 文件负责 X，B 文件负责 Y" — 从代码能读出来的事实，别占 token
• ❌ 长段解释 — 命令式一句话足矣

MEMORY.md（索引）：

- [User role](user_role.md) — backend engineer, 10 yrs Go
- [Testing preference](feedback_testing.md) — integration tests must hit real DB
- [Release freeze](project_freeze_2026-03.md) — no merges after 2026-03-05
- [Linear project](ref_linear.md) — INGEST tracks pipeline bugs

feedback_testing.md（单条记忆）：

---
name: Integration tests must hit real DB
description: Reject mocked DB in integration tests
type: feedback
---

Integration tests must hit a real database, not mocks.

**Why:** 上季度一次 prod migration 失败就是因为 mocked 测试通过了，
mock 和真实 schema drift 被掩盖。

**How to apply:** 写或审 `tests/integration/` 目录下的用例时，
如果看到 `jest.mock('pg')` 或类似 pattern，立即指出。