
从 Vibe Coding 到 Agent 工程Claude Code 扩展功能新手完整教程【免费下载链接】claude-code-best-practicefrom vibe coding to agentic engineering - practice makes claude perfect项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-best-practice用 AI 编程助手写代码时你有没有遇到过这种情况同一个项目每次新开对话都要重新交代一遍项目背景、技术规范和验收标准就像永远在和失忆的同事协作。claude-code-best-practice 就是为了解决这类问题而生的开源实践仓库它把 Claude Code 最核心的三种扩展机制——命令Command、代理Agent、技能Skill——整理成可直接运行的参考实现并附上最佳实践文档和大量实战案例帮你把一次性的提示词变成可复用的工程能力。这个仓库到底是什么一句话概括它是一份Claude Code 该怎么被扩展的参考实现集合而不是某个单一应用。仓库的 slogan 是 from vibe coding to agentic engineering从随性编码到代理工程化意思是别只让 AI 凭感觉写代码而是把流程、角色和规范固化下来让 AI 按工程化的方式工作。理解这个仓库先要分清三个扩展组件用大白话说命令Command放在.claude/commands/下的 Markdown 文件相当于给某类任务起了个快捷键输入/命令名就能触发一整套固定流程代理Agent放在.claude/agents/下是一个有独立人设和权限边界的 AI 工作者比如专门负责取数据、专门负责审查代码技能Skill放在.claude/skills/名称/SKILL.md下是一张可复用的技能卡把某项操作的知识写成规范命令或代理都能调用它。三者各管一段拼起来就是完整的自动化流程。Claude Code 安装步骤与示例快速运行跑起来之前本机只需要装好 Claude CodeNode.js 18 以上然后在终端执行claude登录账号即可。不同系统的安装细节在仓库里都有分步指南Windows 安装、Linux 安装、macOS 安装照着走就行。接下来把仓库拉到本地进入目录启动 Claude Code然后输入/weather-orchestratorgit clone https://gitcode.com/GitHub_Trending/cl/claude-code-best-practice cd claude-code-best-practice claude启动后输入/weather-orchestrator它会先问你想要摄氏度还是华氏度然后自动抓取天气数据最后生成一张 SVG 天气卡片和一份输出摘要。别小看这个查天气的例子它把仓库想讲的核心模式完整演示了一遍。一个完整示例命令、代理、技能如何分工上面这条命令背后其实是一条命令 → 代理 → 技能的编排链路Command → Agent → Skill/weather-orchestrator命令是入口负责和用户交互、协调后续步骤它调用weather-agent代理去取数据——这个代理在启动时预加载了weather-fetcher技能技能里写好了从 Open-Meteo 接口取数的具体方法拿到温度后命令再调用独立的weather-svg-creator技能负责渲染 SVG 卡片并写出结果文件。这里有一个值得注意的细节技能有两种用法。一种是预加载给代理当领域知识比如 weather-fetcher另一种是作为独立技能被直接调用比如 weather-svg-creator。前者像给员工发一本岗位手册后者像临时请一位外包专家。完整流程图解在 orchestration-workflow/orchestration-workflow.md建议对照着看一遍。让 Claude 拥有肌肉记忆CLAUDE.md 配置方法流程固化解决怎么做那项目背景呢这就是CLAUDE.md文件登场的位置——它是 Claude Code 的记忆机制相当于项目级说明书每次会话都会参考它。对大项目来说这个机制有个很实用的设计祖先目录项目根目录等的 CLAUDE.md 会在启动时自动加载而子孙目录里的 CLAUDE.md 是懒加载的——只有当 Claude 真正读写到那个文件夹时才载入上下文相当于一种特殊的按需技能。这套分层加载策略对单体仓库monorepo特别友好细节可以看 best-practice/claude-memory.md。一个小建议单个 CLAUDE.md 尽量控制在 200 行以内太长的文件 AI 反而不容易严格遵守。进阶玩法从 Subagent 到多智能体协作当单条命令流程不够用时仓库还收录了更多进阶方向技能与子代理写法best-practice/claude-skills.md 和 best-practice/claude-subagents.md 分别讲了技能卡怎么写、代理定义里的 frontmatter 有哪些字段模型、工具白名单、最大轮次、隔离工作区等Agent Teams多智能体团队让多个代理并行分工、互相汇报比如一个负责写命令、一个负责写技能、一个负责验证效果见下图跨模型工作流把 Codex、Gemini 等其他模型的 CLI 也接进 Claude Code 一起干活思路在 development-workflows/cross-model-workflow/cross-model-workflow.md一手经验合集tips/目录整理了 Claude Code 团队官方成员分享的实践技巧reports/则是一些深度调研报告比如 SDK 与 CLI 的系统提示词差异、上下文窗口管理适合在基础用法跑通后慢慢读。写在最后与其把 claude-code-best-practice 当成一份读完就关的文档不如把它当成样板间先跑通/weather-orchestrator这条最完整的示范链路看懂命令、代理、技能三者如何接力再对照best-practice/里的文档把这套模式搬到自己项目的日常流程里。从每次重新教 AI到AI 按你的规范干活中间差的往往就是这一层工程化设计。【免费下载链接】claude-code-best-practicefrom vibe coding to agentic engineering - practice makes claude perfect项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-best-practice创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考