claude-code-best-practice

从瞎写提示词到专业智能体工程，让 Claude 干活更靠谱

这是一个关于 Claude Code 最佳实践的社区知识库，旨在帮助开发者从随意的“vibe coding”过渡到严谨的“agentic engineering”。项目通过大量真实案例、工作流模板和配置示例，系统性地展示了如何高效使用 Claude Code 进行编码、测试、重构和自动化任务。它解决了 AI 编程工具使用中常见的“提示词写不好”“工作流混乱”“结果不可控”等问题，提供了从项目初始化、任务拆解、上下文管理到质量验证的完整方法论。核心能力包括：精选的提示词示例、可复用的工作流配置、常见陷阱规避指南，以及社区驱动的持续更新。项目以 HTML 文档形式呈现，内容直观易读，适合所有使用 Claude Code 的开发者参考。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 66238

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队shanraisshan

所属国家

官网地址https://linkedin.com/in/shanraisshan

GitHubhttps://github.com/shanraisshan/claude-code-best-practice

定价模式free

价格说明开源项目，MIT 许可证，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议MIT

主要语言HTML

技术栈/模型agentic-ai,agentic-coding,agentic-engineering,agentic-workflow,ai,ai-agents,anthropic,best-practices,boris,claude,claude-ai,claude-code,claude-code-agents,claude-code-best-practices,claude-code-commands,claude-code-skills,context-engineering,pakistan,pakistani-developer,vibe-coding

GitHub 星标★ 66238

30天Star增速

HF 下载量

上线时间2025-10-31 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数7

使用教程

难度：入门约 10 分钟部署方式：本地安装 6 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Git：用于克隆本仓库及 README 中提到的示例仓库
Claude Code 客户端：README 中的 agents/commands/skills/hooks 需在其环境中使用
浏览器：仓库内容以 HTML 文档形式呈现，便于直接阅读
无需 Node/Python 等运行时依赖，README 未给出任何安装或构建命令

安装与启动步骤

1克隆仓库

把仓库拉到本地作为参考资料随时查阅。README 未要求任何安装或构建步骤，克隆即完成。
```
git clone https://github.com/shanraisshan/claude-code-best-practice.git
```
2按课程方式阅读

README 明确建议把它当课程而非现成工作流或技能来读，先建立概念，后面再动手运行。
3学习核心原语

先认识 agents、commands、skills、hooks 四类原语，再组合成自己的流程，不要把 Claude 当聊天机器人。
4跑编排示例

在 Claude Code 中执行该命令，观察 command → agent → skill 的完整链路，可作为任意开发流程的模板。
```
/weather-orchestrator
```
5克隆进阶示例

Ralph Wiggum 自进化循环是完整可运行的仓库，克隆后可端到端体验 README 提到的进阶模式。
```
git clone https://github.com/shanraisshan/ralph-wiggum-self-evolving-loop.git
```
6优化 CLAUDE.md

把你项目的 tips and tricks 章节指给 Claude，让它结合你的项目给出 CLAUDE.md 的重构建议。

关键配置

配置项	必填	说明	示例
`.claude/agents/.md`	否	Subagent 定义文件的存放路径，一个文件一个 agent	`.claude/agents/reviewer.md`
`.claude/commands/.md`	否	自定义命令文件的存放路径	`.claude/commands/weather-orchestrator.md`
`.claude/skills//SKILL.md`	否	Skill 的定义文件路径，每个技能一个目录	`.claude/skills/my-skill/SKILL.md`
`CLAUDE.md`	否	项目级上下文说明文件，README 建议借助提示词重构	`CLAUDE.md`

如何确认成功

本地仓库内容可正常打开，能看到 README 的 CONCEPTS 与 How to Use 章节，即说明获取成功。

常见问题

Q：这个仓库需要 npm install 或构建吗？

A：不需要。README 未提供任何安装、构建或启动命令，仓库以 HTML 文档和 .claude 目录下的配置示例为主，克隆后直接阅读即可。

Q：/weather-orchestrator 在哪里可以找到？

A：它位于仓库的 orchestration-workflow/orchestration-workflow.md，是 command → agent → skill 的完整示例流程，可当作任何开发流程的模板。

Q：自定义提示音 hook 的实现代码在哪？

A：实现放在独立的 claude-code-hooks 仓库中；本仓库只收录相关模式说明，Agent Teams 等实现则在 implementation/ 目录内。

Q：怎么让 Claude 帮我改 CLAUDE.md？

A：把仓库的 tips and tricks 章节指给你自己项目里的 Claude，让它据此提出修改建议，尤其是 CLAUDE.md 的结构调整。

注意事项

README 强调这是参考资料，应先当课程通读，不要直接当作现成工作流或技能套用
README 未给出任何安装命令、端口号、依赖版本，本教程不含此类内容
不要用聊天的方式使用 Claude，先掌握 agents、commands、skills、hooks 等原语再自行组装
README 中的视频、演示与订阅渠道可用来跟进社区更新

核心亮点

提供大量可直接复制的真实提示词示例，覆盖编码、测试、重构等场景
系统梳理了从简单指令到复杂工作流的演进路径，适合不同水平开发者
社区活跃，持续集成最新实践，内容更新及时

不足之处

内容以文档为主，缺乏交互式教程或视频演示
部分示例依赖特定项目上下文，直接套用需调整

适用场景

团队引入 Claude Code 时，作为内部培训和实践参考
个人开发者优化 AI 编程工作流，提升代码生成质量
研究 agentic 工程方法论，设计自动化开发流程

替代项目

awesome-claude-code、claude-code-tips、anthropic-cookbook

项目介绍

claude-code-best-practice 是智能体领域的开源项目，由 shanraisshan 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（66,238）位列前 1%，在智能体分类的 2,517 个项目里位列前 1%。

近 42 天，它的 GitHub 星标从 64,378 增加到 66,238，净增 1,860。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。MIT 许可证，完全免费，可自行部署使用。

它主要面向的使用场景是：团队引入ClaudeCode时，作为内部培训和实践参考。同类可对比的替代方案包括 awesome-claude-code、claude-code-tips、anthropic-cookbook。

上一篇：awesome-claude-skills

下一篇：crewAI