
HoRain云小助手个人主页 个人专栏: 《Linux 系列教程》《c语言教程》⛺️生活的理想就是为了理想的生活!⛳️ 推荐前些天发现了一个超棒的服务器购买网站性价比超高大内存超划算忍不住分享一下给大家。点击跳转到网站。专栏介绍专栏名称专栏介绍《C语言》本专栏主要撰写C干货内容和编程技巧让大家从底层了解C把更多的知识由抽象到简单通俗易懂。《网络协议》本专栏主要是注重从底层来给大家一步步剖析网络协议的奥秘一起解密网络协议在运行中协议的基本运行机制《docker容器精解篇》全面深入解析 docker 容器从基础到进阶涵盖原理、操作、实践案例助您精通 docker。《linux系列》本专栏主要撰写Linux干货内容从基础到进阶知识由抽象到简单通俗易懂帮你从新手小白到扫地僧。《python 系列》本专栏着重撰写Python相关的干货内容与编程技巧助力大家从底层去认识Python将更多复杂的知识由抽象转化为简单易懂的内容。《试题库》本专栏主要是发布一些考试和练习题库涵盖软考、HCIE、HRCE、CCNA等目录⛳️ 推荐专栏介绍第一层CLAUDE.md — 给 Claude 装一块长期记忆问题是什么解决方案第二层skills/ — 把你的经验存起来问题是什么解决方案第三层hooks/ — 设一道不可绕过的护栏问题是什么解决方案第四层subagents/ — 让专门的人做专门的事问题是什么解决方案第五层plugins/ — 一键复制给全团队问题是什么解决方案完整流程图5 层如何协同工作5 层对应解决的问题汇总快速上手今天就能做的 3 件事你有没有遇到过这些情况每次打开新会话又要跟 Claude 重新解释一遍我们项目的命名规范Claude 突然跑去执行了一条危险命令比如删文件让 Claude 做代码审查结果它把整个项目都塞进上下文又慢又贵你精心调教出来的一套 Claude 用法新同事完全不知道怎么复用这些问题都可以用一套叫做 Agent Development KitADK智能体开发套件 的结构来解决。它的核心就是 5 个文件夹通过这 5 个文件夹我们可以把 Claude Code 变成一支有记忆、懂规矩、会分工、能复制的自动化开发团队。整体结构你的项目/ ├── CLAUDE.md/ ← 第一层记忆 ├── skills/ ← 第二层知识 ├── hooks/ ← 第三层护栏 ├── subagents/ ← 第四层分工 └── plugins/ ← 第五层复制层级目录 / 文件作用核心意义类比理解第1层CLAUDE.md/智能体的全局规则与记忆中心定义 AI 的行为规范、项目背景、开发约束AI 项目操作手册architecture.rules架构规则定义规定代码结构、命名规范、目录设计技术团队编码规范global.md全局共享记忆所有项目都生效的长期规则AI 的长期记忆project.md当前项目专属记忆当前仓库的业务背景、特殊要求项目 README 的增强版第2层skills/技能模块目录给 AI 注入专业能力AI 的技能库SKILL.md技能描述文件告诉 AI 什么情况下调用该技能技能说明书scripts/技能脚本目录存放自动化脚本与模板工具箱context.md技能上下文提供技能运行时需要的背景知识专业知识库第3层hooks/Hook 钩子系统在执行前后自动插入检查逻辑自动安全审计PreToolUse.sh工具执行前钩子执行命令前做校验危险操作确认器PostToolUse.sh工具执行后钩子执行完成后自动处理自动格式化、通知SessionStart.sh会话启动钩子初始化开发环境IDE 启动脚本第4层subagents/子智能体目录拆分不同专业 AgentAI 团队协作系统code-reviewer.md代码审查 Agent专门负责代码 ReviewReviewer 工程师test-runner.md测试 Agent自动运行测试QA 测试工程师explorer.md探索型 Agent分析代码库结构技术调研员第5层plugins/插件系统将能力模块化分发AI 应用市场manifest.json插件配置清单定义插件元数据npm package.jsonmarketplace.url插件市场地址插件下载与共享入口应用商店team.install团队安装脚本一键同步团队环境DevOps 初始化脚本每一层解决一个具体问题下面逐一拆解。第一层CLAUDE.md— 给 Claude 装一块长期记忆问题是什么Claude 没有跨会话记忆。你今天告诉它组件命名用大驼峰明天开新会话它就忘了。解决方案在项目里放一个CLAUDE.md文件把所有不想重复说的事写进去。每次会话开始Claude 自动读取它。两个文件两个作用范围文件位置作用范围~/.claude/CLAUDE.md你电脑上的所有项目都生效项目根目录.claude/CLAUDE.md只对这一个仓库生效写什么进去想想你最常对 Claude 重复说的话# 项目我的电商平台 ## 技术栈 - 前端Next.js 14App Router - 样式Tailwind CSS - 数据库PostgreSQL Prisma ## 命名规范 - 组件文件大驼峰如 UserCard.tsx - 工具函数小驼峰如 formatPrice.ts - API 路由短横线如 /api/user-profile ## 注意事项 - 禁止使用 any 类型 - 所有异步函数必须有 try/catch - 提交代码前必须通过 ESLint 检查 - 不要直接操作 main 分支 ## 代码风格 - 缩进2 个空格 - 引号单引号 - 函数优先用箭头函数效果你再也不用在每次对话开头粘贴一大段背景介绍了。第二层skills/— 把你的经验存起来问题是什么你每次让 Claude 帮我写一个新组件它可能每次做法都不一样——有时候加测试有时候不加有时候有 TypeScript 类型有时候没有。解决方案把标准做法写成技能文件放进skills/目录Claude 会根据你的任务描述自动匹配并调用对应的技能你不需要输入任何命令。目录结构skills/ ├── SKILL.md ← 技能索引描述 触发条件 ├── create-component.md ← 创建 React 组件的标准流程 ├── write-api.md ← 写接口的标准流程 └── fix-bug.md ← 排查 Bug 的标准流程一个技能文件长什么样--- name: create-react-component description: 当用户说创建组件、新建页面、写一个 UI时 自动调用此技能。 --- # 创建 React 组件的标准流程 ## 步骤 1. 检查 src/components/ 下是否已存在同名组件 2. 用大驼峰命名新建 .tsx 文件 3. 必须定义 TypeScript interface不允许 any 4. 同步在 src/stories/ 下新建对应的 Storybook 故事 5. 在 __tests__/ 下新建单元测试文件 ## 代码模板 \\\tsx interface Props { // 在这里定义 props } export const ComponentName: React.FCProps ({ }) { return div{/* 内容 */}/div; }; \\\效果你说帮我创建一个用户卡片组件Claude 自动按照你团队的标准流程来做测试、类型、文档一个不漏。通俗理解这就像给一个新员工写了一本《操作手册》它照着手册做事不需要你每次盯着。第三层hooks/— 设一道不可绕过的护栏问题是什么AI 有时候会做出一些你绝对不想要的操作——比如在生产环境直接删数据库或者跑了一条rm -rf命令。这种事情靠在提示词里说不要这样做是不可靠的。解决方案Hooks 是在 Claude 每次工具调用前后自动运行的 Shell 脚本。它是纯代码逻辑确定性执行AI 绕不过去。三个核心文件hooks/ ├── PreToolUse.sh ← 工具调用「之前」运行 ├── PostToolUse.sh ← 工具调用「之后」运行 └── SessionStart.sh ← 会话「开始时」运行PreToolUse.sh 示例 — 拦截危险命令#!/bin/bash # 检查 Claude 准备执行的命令 TOOL_INPUT$2 # 禁止执行 rm -rf / if echo $TOOL_INPUT | grep -qE rm\s-rf\s/; then echo 已拦截禁止执行破坏性删除命令 2 exit 1 fi # 禁止在没有确认的情况下操作生产数据库 if echo $TOOL_INPUT | grep -q prod_db echo $TOOL_INPUT | grep -qE DROP|DELETE; then echo 已拦截生产数据库的破坏性操作需要人工确认 2 exit 1 fi exit 0PostToolUse.sh 示例 — 保存文件后自动格式化#!/bin/bash # 每次 Claude 写完文件自动跑 lint 和格式化 TOOL_NAME$1 FILE_PATH$2 if [ $TOOL_NAME write_file ]; then case $FILE_PATH in *.ts|*.tsx|*.js|*.jsx) npx eslint --fix $FILE_PATH npx prettier --write $FILE_PATH echo 已自动格式化$FILE_PATH ;; esac fi效果Claude 写完代码自动帮你 lint不用你手动跑危险命令在执行前就被拦截你连看都不用看部署脚本跑完自动发 Slack 通知给团队通俗理解就像工厂流水线上的质检环节。产品出厂前强制过一遍不符合规格的直接挡回去不依赖工人的个人判断。第四层subagents/— 让专门的人做专门的事问题是什么让 Claude 在一个会话里同时做代码审查 跑测试 写文档上下文会越来越大越来越慢而且各种任务互相干扰。解决方案把不同任务拆分给独立的子代理。每个子代理有自己独立的上下文窗口、专属的工具权限只做一件事做完汇报结果。目录结构subagents/ ├── code-reviewer.md ← 专门做代码审查 ├── test-runner.md ← 专门跑测试 └── doc-writer.md ← 专门写文档code-reviewer.md 示例--- name: code-reviewer description: PR 需要代码审查时调用此代理 tools: - read_file # 只允许读文件 permissions: - read_only # 只读权限绝对不会误操作 --- # 代码审查专用代理 你是一名资深代码审查员。你只会收到 git diff不需要了解整个项目。 你没有写入权限只能阅读和分析。 ## 审查清单 - [ ] 有没有硬编码的密钥或密码 - [ ] 新函数有没有对应的单元测试 - [ ] TypeScript 类型是否明确有没有 any - [ ] 异步操作有没有错误处理 - [ ] 有没有遗留的 console.log ## 输出格式 1. **总体评价**一句话说清楚 2. **必须修改**阻塞合并的问题 3. **建议优化**非阻塞的改进项 4. **结论**可以合并 / 需要修改整体运作流程你说帮我审查这个 PR 并运行测试 │ ├──→ 调用 code-reviewer 子代理 │ 独立上下文只看 diff只读权限 │ 返回结构化审查报告 │ ├──→ 调用 test-runner 子代理 │ 独立上下文有执行测试的权限 │ 返回测试通过/失败摘要 │ └──→ 主会话汇总结果上下文始终保持干净通俗理解就像一个包工头。他自己不撸代码但他手下有专门的水电工、瓦工、木工。谁的活儿谁干互不干扰最后包工头统一汇报进度。第五层plugins/— 一键复制给全团队问题是什么你花了好几天把以上四层全部调教好了但新同事入职他怎么知道这套配置难道要让他再配置一遍解决方案把整套系统打包成一个插件新成员执行一条命令立刻拥有和你完全相同的 Claude Code 工作环境。目录结构plugins/ ├── manifest.json ← 描述插件包含什么 ├── marketplace.url ← 分享链接 └── team.install ← 一键安装脚本team.install 示例#!/bin/bash echo #x1f680; 正在安装团队 ADK 配置... # 安装项目级 CLAUDE.md cp ./CLAUDE.md/project.md ./.claude/CLAUDE.md # 安装所有技能 mkdir -p ./.claude/skills cp -r ./skills/* ./.claude/skills/ # 安装钩子记得加执行权限 mkdir -p ./.claude/hooks cp -r ./hooks/* ./.claude/hooks/ chmod x ./.claude/hooks/*.sh # 安装子代理 mkdir -p ./.claude/subagents cp -r ./subagents/* ./.claude/subagents/ echo 安装完成Claude Code 已配置为团队模式。新同事入职第一天bash plugins/team.install完毕。和你用的是完全一样的 Claude Code。通俗理解就像公司的新员工电脑配置包。IT 部门做好一个镜像新人一键安装环境和老员工一模一样不用挨个手动配。完整流程图5 层如何协同工作开发者输入任务 │ ▼ CLAUDE.md → 加载项目规范和背景知识 │ ▼ skills/ → 匹配任务类型调用对应工作流 │ ▼ hooks/PreToolUse → 执行前检查拦截危险操作 │ ▼ subagents/ → 复杂任务拆分给专属子代理执行 │ ▼ hooks/PostToolUse→ 执行后处理自动格式化/通知 │ ▼ plugins/ → 整套配置一键同步给所有团队成员5 层对应解决的问题汇总层级文件夹解决什么问题类比第一层CLAUDE.md/Claude 每次都忘记项目规范员工手册第二层skills/同类任务每次做法不一致操作手册第三层hooks/危险操作无法防范流水线质检第四层subagents/复杂任务上下文膨胀专业分工第五层plugins/配置无法在团队复用新人入职包快速上手今天就能做的 3 件事如果你觉得一次全部配置太复杂可以先从最高回报的开始第 1 步5 分钟建一个CLAUDE.md把你最常跟 Claude 重复说的项目背景都写进去。第 2 步10 分钟建一个hooks/PreToolUse.sh加入几条你最不想 Claude 执行的危险命令的拦截规则。第 3 步30 分钟把你最常做的一类任务比如创建组件写成第一个skills/文件积累你的团队标准。剩下的层可以边用边补不需要一次做完。这套系统的名字叫Agent Development KitADK。五层结构一个堆栈。你不需要更多工具只需要 5 个文件夹。❤️❤️❤️本人水平有限如有纰漏欢迎各位大佬评论批评指正如果觉得这篇文对你有帮助的话也请给个点赞、收藏下吧非常感谢! Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧