shanraisshan/claude-code-best-practice
项目介绍
熟能生巧
practice made claude perfect
智能解读
claude-code-best-practice 是一个专注于提升 Claude AI 编程助手使用效率的最佳实践指南库。该项目系统性地整理了如何通过“代理工程”来构建和管理复杂的 AI 工作流。其核心在于将任务分解为三种可组合的模块：子代理（Subagents）作为拥有独立身份和工具的自主执行者；命令（Commands）作为可注入现有上下文的用户调用模板；技能（Skills）作为可配置、可自动发现的可复用知识块。此外，项目还涵盖了工作流编排、事件钩子、以及通过 MCP 协议连接外部工具等方法。这套实践旨在帮助开发者，特别是那些进行“氛围编码”或构建智能体应用的工程师，更高效、结构化地利用 Claude Code，将简单的提示交互升级为可维护、可扩展的自动化系统。
智能标签
使用场景
这个项目最适合需要将Claude AI从简单的对话助手升级为可编程、可扩展、可维护的自动化编码伙伴的场景，特别是团队协作和复杂项目开发。
复杂任务自动化分解
开发者需要Claude处理一个复杂的多步骤任务（如重构整个代码库），但单次提示难以清晰描述所有要求，且Claude容易在长对话中迷失上下文。
使用项目的子代理（Subagents）概念，为重构任务创建专门的“重构专家”代理，配置其工具、权限和记忆，让它在独立上下文中专注执行特定子任务。
创建一个`.claude/agents/refactor-agent.md`，定义该代理专门负责代码重构，拥有访问文件系统、运行测试的权限，并配置其记忆规则，然后通过工作流编排让多个这样的子代理协作完成大型重构。
团队共享AI工作流
团队中每个成员都在重复编写相似的Claude提示来执行常见任务（如生成API文档、代码审查），导致效率低下且质量参差不齐。
利用项目的技能（Skills）和命令（Commands）机制，将团队的最佳实践封装成可复用的知识块和模板，放入项目仓库的`.claude/`目录中，实现自动发现和共享。
将“生成Swagger风格API文档”的提示模板保存为`.claude/skills/api-doc/SWAGGER_DOC.md`技能，团队成员只需在对话中提及`@api-doc`，Claude就会自动加载并使用这个标准化模板。
连接外部工具和数据
开发者希望Claude在编码时能实时查询数据库、调用内部API或使用特定开发工具，但Claude本身无法直接访问这些外部资源。
通过项目介绍的MCP（Model Context Protocol）服务器配置，将外部工具（数据库、API、内部系统）安全地暴露给Claude，使其能在编码上下文中直接使用这些工具。
配置一个连接公司内部JIRA的MCP服务器，当Claude编写与特定任务相关的代码时，可以自动查询JIRA获取任务详情、验收标准，确保代码符合需求。
维护长期项目记忆
在长期项目中，开发者需要Claude记住项目的架构决策、技术债务、特定约定等上下文，但Claude的对话记忆有限且易丢失。
使用项目的记忆系统，通过`CLAUDE.md`文件、规则目录（`.claude/rules/`）和项目特定记忆文件夹，为Claude建立持久化的项目上下文记忆。
在项目根目录创建`CLAUDE.md`记录核心架构，在`.claude/rules/`中放置编码规范文件，Claude在每次会话开始时都会自动加载这些记忆，保持对项目长期背景的理解。
项目健康度
距上次更新 9 天
平台 Star TOP 6% · Forks 2,432
本周 +3,665 ⭐ · 本月 +21,602 ⭐
4 位贡献者 · 0 条平台评论
文档资料完整
1 项改进建议
- 社区：贡献者较少，可通过完善文档和社区运营吸引更多参与者
项目信息
赞赏支持
如果本站对你有帮助，欢迎打赏支持
微信
支付宝
Widget 徽章
相关项目推荐
EbookFoundation/free-programming-books
📚 Freely available programming books
ossu/computer-science
🎓 免费自学计算机科学的教育路径！
f/prompts.chat
又名Awesome ChatGPT提示词库。分享、发现并收集来自社区的提示词。免费开源——为您的组织提供完全隐私的自托管服务。
DigitalPlatDev/FreeDomain
DigitalPlat 免费域名：人人可享的免费域名服务
f/awesome-chatgpt-prompts
This repo includes ChatGPT prompt curation to use ChatGPT and other LLM tools better.
ripienaar/free-for-dev
面向运维和基础架构开发的SaaS、PaaS和IaaS免费服务清单
加载评论中...