关于 claude-code-project-memory
用于配置 Claude Code 项目记忆的指导技能，涵盖 `CLAUDE.md` 与分范围规则文件。内容涉及记忆加载、导入、跨编码助手文件策略和验证，帮助整理跨会话使用的项目指令。
主要功能
- 01整理项目记忆与用户记忆
- 02将指引拆分为分范围规则文件
- 03通过导入加载额外上下文
- 04在不同编码助手间镜像记忆文件
- 05检查并审阅记忆变更
适用场景
- 01为代码库设置共享指令
- 02将测试或安全规则限定到路径
- 03在不同编码助手间维护记忆
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/claude-code-project-memory确认已加载。
详细介绍
Claude Code 项目记忆（2026 年 1 月）
配置 CLAUDE.md 项目记忆，让 Claude Code 在不同会话中获得稳定且范围明确的指令，同时降低 token 成本。
快速参考
| 记忆类型 | 常见位置 | 用途 |
|---|---|---|
| 托管策略 | 取决于操作系统（参见官方文档） | 全组织标准（安全、合规） |
| 项目记忆 | ./CLAUDE.md 或 ./.claude/CLAUDE.md | 共享项目上下文和约定 |
| 项目规则 | ./.claude/rules/*.md | 模块化、聚焦主题的规则（测试、安全、风格） |
| 用户记忆 | ~/.claude/CLAUDE.md | 跨项目的个人偏好 |
| 项目记忆（本地） | ./CLAUDE.local.md（被 git 忽略） | 仅本地适用的项目特定偏好 |
加载方式（概览）
- 递归加载：从当前工作目录向上查找，但不包括文件系统根目录（
/）。 - 按需加载：当前工作目录下的嵌套
CLAUDE.md文件，仅在 Claude 读取这些子目录中的文件时加载。 - 导入：
@path/to/file会引入额外上下文（最大深度：5；支持~）。
工作流（最佳实践）
- 从精简的
CLAUDE.md（50–120 行）开始：说明项目是什么、结构如何，以及“绝不能破坏”的规则。 - 将冗长或容易出错的指导移至
.claude/rules/（每个文件聚焦一个主题）。 - 使用
@imports作为详细文档的导航方式，而不是将其复制到记忆中。 - 像对待代码一样管理记忆：进行 PR 审查、明确所有权，并定期清理（移除失效规则）。
支持可选路径范围的规则
创建 .claude/rules/testing.md、.claude/rules/security.md 等。如果某条规则仅适用于仓库的一部分，则为其设置范围：
---
paths:
- "src/api/**/*.ts"
---
命令（Claude Code）
- 使用
> /memory查看并直接编辑记忆。 - 使用
> /init初始化项目记忆（当前行为请参见官方文档）。
跨平台策略（AGENTS.md + CLAUDE.md）
如果需要支持多种编码助手，请保留一个规范文件并同步副本：
- macOS/Linux：为其中一个文件创建指向另一个文件的符号链接。
- Windows：除非已启用开发者模式，否则优先复制文件（或使用小型同步脚本），而不是创建符号链接。
避免在记忆文件中写入特定工具相关的说法；保持内容可移植，并严格聚焦于项目。
验证（快速检查）
- 运行随附的代码检查器：
bash frameworks/shared-skills/skills/claude-code-project-memory/scripts/lint_claude_memory.sh . - 合并记忆变更前，手动检查是否存在未解析的
@imports和密钥。
资源
| 资源 | 用途 |
|---|---|
| references/memory-patterns.md | 模式与反模式 |
| references/memory-examples.md | 按技术栈划分的完整示例 |
| references/large-codebase-strategy.md | 100K–1M LOC 策略 |
| data/sources.json | 官方链接 |
相关技能
| 技能 | 用途 |
|---|---|
| claude-code-skills | 技能创建模式 |
| claude-code-agents | Claude Code Agent 设置 |
| docs-codebase | 仓库文档模式 |
评论
支持 Markdown