claude agent、skill 结构参考

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