用途：为 Claude Code 和 Codex 配置项目记忆，使编码智能体在不同会话中获得稳定、范围明确的指令，并保持较低 token 成本。核心做法是单一事实来源：以 AGENTS.md 为主文件，将 CLAUDE.md 符号链接到它。
主要能力与结构：记忆分为托管策略（组织级标准，位置依操作系统）、项目记忆（./AGENTS.md 为主，./CLAUDE.md 为符号链接）、项目规则（./.claude/rules/*.md，按主题模块化）、用户记忆（~/.claude/CLAUDE.md，跨项目个人偏好）、本地项目记忆（./CLAUDE.local.md，被 git 忽略）。
加载方式：Claude Code 从当前工作目录向上递归加载至文件系统根（不含根）；cwd 下的嵌套 CLAUDE.md 仅在读取对应子树文件时按需加载；支持 @path/to/file 导入，最大深度 5，支持 ~。Codex 读取仓库根或工作目录下的 AGENTS.md，需保持简洁，支持双工具时与 CLAUDE.md 内容一致。
使用方式：从 50–120 行的最小主记忆文件开始，写明项目是什么、结构如何、不可破坏的规则；长或脆弱指引移入 .claude/rules/（每文件一主题）；用 @imports 作为详细文档的导航而非复制内容；把记忆当代码管理，做 PR 审查、归属和定期清理。规则可按路径限定范围，例如在 .claude/rules/testing.md 中用 paths 字段限定 src/api/**/*.ts。Claude Code 可用 /memory 查看和直接编辑记忆，/init 引导项目记忆；Codex 直接编辑 AGENTS.md，无需特殊命令。跨平台：macOS/Linux 用符号链接，Windows 优先复制或同步脚本。
执行工作流：若仓库含 scripts/git/feature-workflow.sh，推荐 ./scripts/git/feature-workflow.sh start <feature-slug> 创建隔离分支/工作树，进入 .worktrees/<feature-slug> 实现并提交，运行 ../../scripts/git/feature-workflow.sh gate 质量门，再用 ../../scripts/git/feature-workflow.sh pr --title "feat: <summary>" 开 PR。无脚本时用原生 git worktree，保持一功能一工作树、一聚焦 PR，PR 前运行仓库质量门。
限制与校验：启动记忆超出实际上下文预算时应先精简再新增规则。可用 bash frameworks/shared-skills/skills/agents-project-memory/scripts/lint_claude_memory.sh . 运行内置 linter，合并前手动检查未解析的 @imports 和密钥。外部事实、版本、价格等应通过联网检索核实并标注来源与日期；无法联网时说明限制并标记为未验证。