my-project/
├── .claude/
│ ├── agents/ # 项目级子代理
│ │ ├── feature-builder.md # 预加载了下面两个 skill
│ │ ├── code-reviewer.md
│ │ └── review/
│ │ └── security-reviewer.md # 子文件夹分类,不影响调用
│ │
│ ├── skills/ # 项目级 Skill
│ │ ├── coding-standards/
│ │ │ ├── SKILL.md # 主说明文件
│ │ │ └── examples/
│ │ │ └── good-service.ts # 配套参考文件,用 @引用
│ │ │
│ │ ├── testing-conventions/
│ │ │ └── SKILL.md
│ │ │
│ │ └── run-tests/ # 这个 skill 设了 context: fork
│ │ └── SKILL.md # 调用时自动 fork 到子代理跑
│ │
│ ├── agent-memory/ # memory: project 的代理持久记忆
│ │ └── feature-builder/
│ │ └── MEMORY.md # 会被自动读取注入系统提示词
│ │
│ ├── agent-memory-local/ # memory: local,不进版本库
│ │ └── code-reviewer/
│ │ └── MEMORY.md
│ │
│ └── settings.json # 权限、hooks 等项目配置
│
├── scripts/
│ └── validate-readonly-query.sh # agent hooks 里引用的校验脚本
│
├── .gitignore # 记得把 agent-memory-local/ 排除掉
└── ...(你的项目代码)
~/.claude/ # 用户级,个人跨项目共享
├── agents/
│ └── debugger.md
│
├── agent-memory/ # memory: user 的持久记忆
│ └── debugger/
│ └── MEMORY.md
│
└── skills/ # 个人级 Skill,所有项目可用
└── my-git-workflow/
└── SKILL.md
