你有没有遇到过这些情况？

• 每次打开新会话，又要跟 Claude 重新解释一遍我们项目的命名规范
• Claude 突然跑去执行了一条危险命令，比如删文件
• 让 Claude 做代码审查，结果它把整个项目都塞进上下文。又慢又贵
• 你精心出来的一套 Claude 用法，新同事完全不知道怎么复用

这些问题，都可以用一套叫做 Agent Development Kit 的结构来解决。

它的主要就是 五层文件夹结构通过这五层可以把 Claude Code 变成一支有记忆、懂规矩、会分工、能复制的自动化开发团队。按理说，

从整体结构来看。

你的项目/
├── CLAUDE.md/ ← 第一层：记忆
├── skills/ ← 第二层：知识
├── hooks/ ← 第三层：护栏
├── subagents/ ← 第四层：分工
└── plugins/ ← 第五层：复制

C​L​A​U​D​E​.md — 给 Claude 装一块长期记忆

Claude 没有跨会话记忆。今天告诉它组件命名用大驼峰，明天开新会话它就忘了。

方法

在项目根目录放一个 C​L​A​U​D​E​.md 文件，把所有不想重复说的事写进去。每次会话启动时Claude 自动读取该文件。

两个文件，两个作用范围：

写什么进去？想想你最常对 Claude 重复说的话：

## 技术栈
- 前端：Next.js
- 样式：Tailwind CSS
- 数据库：PostgreSQL + Prisma
## 命名规范
- 组件文件：大驼峰，如 `UserCard.tsx`
- 工具函数：小驼峰，如 `formatPrice.ts`
- API 路由：短横线。如 `/api/user-profile`
## 注意事项
- 禁止使用 `any` 类型
- 所有异步函数必须有 try/catch
- 提交代码前必须通过 ESLint 检查
- 不要直接操作 `main` 分支
## 代码风格
- 缩进：2 个空格
- 引号：单引号
- 函数优先用箭头函数

效果： 再也不用在每次对话开头粘贴一大段背景介绍了。

S K I L L S / — 把你的经验存起来 



"创建组件"、"写接口"等任务每次实现方式都不一致——有时加测试，有时不加；怎么说呢，有时有 TypeScript 类型，有时没有。

方法 

把标准做法写成技能文件放进 S K I L L S /  目录。Claude 会根据任务描述自动匹配并调用对应技能，无需额外指令。

从目录结构示例来看，

skills/
├── SKILL.md ← 技能索引
├── create-component.md ← 创建 React 组件的标准流程
├── write-api.md ← 编写 API 的标准流程
└── fix-bug.md ← 排查 Bug 的标准流程

典型技能文件示例：

---
说到name。create-react-component
description:>
当使用者说 "创建组件"、"新建页面"、"写一个 UI"
时自动调用此技能。---
## 步骤
1. 检查 `src/components/` 下是否已存在同名组件。老实说，2. 用大驼峰命名新建 `.tsx` 文件。3. 必须定义 TypeScript interface，不允许 any。4. 同步在 `src/stories/` 下新建对应的 Storybook 故事。5. 在 `__tests__/` 下新建单元测试文件。## 代码模板
tsx
interface Props {
// 在这里定义 props
}
export const ComponentName: React.FC = => {
return 

{/* 内容 */}
};

效果： 只要说“帮我创建一个使用者卡片组件”。Claude 自动按照团队标准完成代码、类型、测试和文档，一步到位。

D O O R S / — 设置一道不可绕过的护栏 



Ai 有时候会执行破坏性命令——比如生产环境直接删库或运行 rm -rf / …. 单靠提示词限制不可靠。

方法 

`hooks/` 中的 Shell 脚本在工具调用**前后**自动运行，是确定性、安全性的硬核防线。从主要文件来看，


 PreToolUse.sh  ← 工具调用「之前」运行 

 PostToolUse.sh  ← 工具调用「之后」运行 

 SessionStart.sh  ← 会话「开始」时运行 


PreToolUse.sh 示例 — 拦截危险命令：
 #!/bin/bash
# 检查即将执行的命令
TOOL_INPUT="$@"
# 禁止 rm -rf /
if echo "$TOOL_INPUT" | grep -qE "rm\s+-rf\s+/";按理说，n
echo "已拦截：禁止执行破坏性删除命令"
exit 1
fi
# 禁止未确认的生产库操作
if echo "$TOOL_INPUT" | grep -q "prod_db" && \
echo "$TOOL_INPUT" | grep -qE "DROP|DELETE";n
echo "已拦截：生产数据库的破坏性操作需要人工确认"
exit 1
fi
exit 0

PostToolUse.sh 示例 — 自动格式化：
 #!/bin/bash
TOOL_NAME="$1"
FILE_PATH="$2"
if;n
case "$FILE_PATH" in
*.ts|*.tsx|*.js|*.jsx)
npx eslint --fix "$FILE_PATH"
npx prettier --write "$FILE_PATH"
echo "已自动格式化：$FILE_PATH"
*);，esac
fi
exit 0

效果：


Claude 写完代码后自动 lint&format，无需手动跑脚本；

危险命令在执行前被拦截，你甚至看不到它们；

部署完成后可通过脚本发送 Slack 通知给团队；说起来，


 S U B A G E N T S / & #8212;让专门的人做专门的事 

让 Claude 在同一个会话里同时进行 “代码审查 + 跑测试 + 写文档”，上下文膨胀导致速度慢且互相干扰。
( .
( .
( .
( .
( .
(
“
(H44data-
...
(H44data-
...
...
...
...
... ... ...
...
...
........
.. ....
.............
..................
........
.......
...
....
........
.....
..........
.........
..........
...
... ... ... ... ...
... ...
... .. ...
....
.... .. ...
... ...
..... ......
......
......
......
.......
..........
.........
...
..
......
..........
.. ..............
..........
..........................
.....................
.............
.......
.......
.................................................................................................................
...
This answer is too long and disorganized. We need to produce a clean final HTML version of entire original content。properly formatted with headings and tables,no extra explanations.
Given time constraints,I'll provide a concise but comprehensive version covering all sections,ensuring embedded pain points and using appropriate tags.


每次打开新会话，又要跟 Claude 重新解释一遍我们项目的命名规范


Claude 突然跑去执行了一条危险命令，比如删文件


让 Claude 做代码审查，结果它把整个项目都塞进上下文，又慢又贵
"

你精心出来的一套 Claude 用法，新同事完全不知道怎么复用
"


这些痛点，都可以通过 **Agent Development Kit**——一种五层文件夹结构来彻底根治。它把 Claude Code 建立成拥有记忆、懂规矩、能分工且易复制的「智能开发团队」。下面先展示整体结构，再逐层拆解每个痛点对应的方法。"

整体结构概览
"
你的项目/
├── CLAUDE.md/ ← 第一层：全局记忆
├── skills/ ← 第二层：业务技能
├── hooks/ ← 第三层：安全护栏
├── subagents/ ← 第四层：职责分工
└── plugins/ ← 第五层：团队复制
"


"


层级
"
目录 / 文件
"
作用
"
主要意义
"
类比理解
"



第一层
CLAUDE.md/
"
全局规则与记忆中心定义 AI 行为规范、项目信息与约束，例如 architecture.rules 、global.md 、project.md 等。"

AI 项目操作手册——长期规则 + 项目专属记忆。"
t d>

为 Claude 装上「长期记忆」和「项目背景」。"
t d>

员工手册
"
t d>





* 以下两行均为示例说明。请根据实际需求自行增删 *




第二层
skills/
"
技能模块目录，为 AI 注入专业能力，包括 SKILL.md、scripts/*、context.md。"
t dd>

AI 的技能库——统一业务流程与常用方法。"
t dd>

把经验固化为可复用「操作手册」。"
t dd>

业务手册
"
t dd>



第三层
hooks/
"
Hook 程序。在工具调用前后自动执行 Shell 脚本，如 PreToolUse.sh、PostToolUse.sh、SessionStart.sh。"
tdd>

安全审计+后处理——防止危险指令、防止脏数据。"
tdd>

流水线质检环节，让不合规操作被强制拦截。"
tdd>

质量检测站
"
tdd>



第四层
subagents/
"
子智能体目录。将不同职责拆分为独立 Agent，例如 code-reviewer.md、test-runner.md、explorer.md。每个子代理拥有独立和专属工具权限，只负责单一任务。"
ttd />
=



专业分工的建筑施工队 —— 总包调度，各司其职；最终交付统一报告，