Adding Context

基础

三种上下文来源

项目长期上下文：CLAUDE.md、.claude/rules/、项目文档。
任务上下文：路径、错误日志、复现步骤、期望行为。
实时探索上下文：Claude 读取文件、运行命令、查看测试结果后得到的信息。

可靠方式是先给任务上下文，再让 Claude 用真实文件补齐，而不是把整个 repo 塞进对话。

主动注入上下文

路径与行号：src/auth/login.ts 第 47 行出现 invalid signature。
原始错误：保留完整错误字串，不要先改写成摘要。
约束条件：例如「不要改 API contract」「只补 macOS updater」。

实战

CLAUDE.md 与临时上下文

CLAUDE.md 适合放长期稳定规则：测试命令、代码风格、目录边界、不可触碰的配置、review 与回报格式。一次性错误日志或临时偏好放在当前会话即可。

好 prompt 的形状

目标：修复登录后偶发 401。
证据：错误字串是 "invalid refresh token rotation"。
范围：先看 src/auth/session.ts 和 tests/auth/session.test.ts。
约束：不要改 public API response shape。
验证：优先跑 npm run test -- tests/auth/session.test.ts。

这个 prompt 给了目标、证据、范围、约束、验证。Claude Code 可以直接进入有效探索。

考点

上下文管理不是堆文件，而是提供足够精确的任务线索。
原始错误字串、路径、行号、复现步骤比抽象描述更有用。
CLAUDE.md 放长期规则；一次性任务细节放当前会话。

速记：好上下文 = 目标 + 原始证据 + 文件范围 + 约束 + 验证方式。