Claude Code 最佳实践指南
从随性编码到智能体工程：系统化掌握 Claude Code 的配置、工作流与最佳实践。
证据显示仓库主要是文档和配置，没有实际代码或可执行文件，因此无法评估权限、用户确认、数据流透明性、敏感数据处理、依赖安全、外部影响、回滚或来源归属。所有信任标准得分为0，因为没有证据支持。
自一致性：README中列出的功能与仓库结构基本一致，但存在一些断开的链接（如'!/tags/...'），表明文档可能不完整或存在错误。依赖可用性：没有列出依赖项，因此无法评估。失败消息：没有提供错误处理或失败消息的文档。
受众和场景：README明确针对Claude Code用户，提供了多种工作流和最佳实践，适合开发者。能力边界：文档描述了各种功能，但没有明确说明限制或边界。触发精度：提供了命令和技能的使用说明，但缺乏详细的触发条件。环境适配：主要针对Claude Code环境，但未说明其他环境兼容性。
信息架构：README结构清晰，有目录和分类，但部分链接损坏。安装说明：提供了基本的使用方法（如运行claude命令），但缺少详细的安装步骤。命名稳定性：文件名和命令命名一致，但未提供版本历史。示例和FAQ：提供了多个示例和链接，但没有FAQ部分。已知限制：未提及任何已知限制。许可证：MIT许可证明确。版本和变更日志：没有版本号或变更日志。维护责任：README中提到了作者，但没有明确的维护承诺。
输出可用性：文档提供了丰富的示例和最佳实践，但缺少实际输出示例。边际价值：作为最佳实践集合，提供了大量有价值的信息，但可能与其他类似资源重复。成本效益：免费开源，但需要用户自行评估其价值。
声明可追溯性：README中引用了多个外部链接和文档，但部分链接可能失效。跨来源佐证：引用了多个外部来源，但未提供验证方法。事实与推断分离：文档中混合了事实和推断，未明确区分。
- 仓库主要是文档和配置，没有实际代码，无法验证其功能或安全性。
- README中存在大量断开的链接（如'!/tags/...'），可能影响文档的可用性。
- 未提供版本号或变更日志，难以追踪更新。
- 未提及已知限制，用户可能对潜在问题缺乏了解。
这个 Agent 能做什么，适合哪些场景？
该仓库是 Claude Code 的综合性最佳实践指南，由 shanraisshan 维护，旨在帮助开发者从随意编码（vibe coding）过渡到严谨的智能体工程（agentic engineering）。内容涵盖 Claude Code 的核心概念，如子代理（subagents）、命令（commands）、技能（skills）、钩子（hooks）、MCP 服务器、设置、内存管理、检查点、CLI 启动标志等，并为每项提供最佳实践说明和实际实现示例。仓库还收录了多种开发工作流（如 Superpowers、Everything Claude Code 等）的对比分析，并提炼了来自 Claude Code 创建者 Boris Cherny 及社区专家的 83 条实用技巧，涉及提示、规划、上下文管理、会话、CLAUDE.md 配置、代理、命令、技能、钩子、Git/PR、调试等方面。此外，还提供了跨模型协作的方案（如通过插件、MCP 或路由器与其他模型集成），以及相关的视频和播客资源。该项目采用 MIT 许可证，并持续更新，适合希望深入掌握 Claude Code 的开发者作为参考手册。
该仓库通过结构化的文档和示例，展示如何配置 Claude Code 的各个组件：子代理定义（.claude/agents/*.md）、命令（.claude/commands/*.md）、技能（.claude/skills/*/SKILL.md）、钩子（.claude/hooks/）、MCP 设置（.mcp.json）、设置文件（.claude/settings.json）以及内存文件（如 CLAUDE.md 和 .claude/rules/）。它提供了一个“编排工作流”示例（weather-orchestrator），演示了命令→代理→技能的模式。此外，仓库还引用了众多外部工作流（如 Superpowers、Everything Claude Code 等），并提供了可复制的命令如 claude 和 /weather-orchestrator。它整理了来自 Claude Code 团队（Boris、Thariq）和社区的最佳实践技巧，并提供了跨模型工作流的方案（如通过 router 或 MCP 调用其他模型）。
- 希望系统化配置 Claude Code（子代理、命令、技能、钩子、MCP）的开发者，可参考最佳实践和实现示例。
- 需要设计复杂开发流程（如研究→计划→执行→审查→发布）的团队，可借鉴仓库中的工作流对比和编排示例。
- 面临上下文管理问题（如上下文腐化、长会话）的开发者，可应用仓库中关于 /compact、/clear、/rewind 和子代理使用的技巧。
- 希望将 Claude Code 与其他 AI 模型（如 Codex、Gemini）协同使用的开发者，可参考跨模型工作流部分。
- 需要编写高质量 CLAUDE.md 和技能文件的开发者，可参考仓库中的指导和建议。
- 希望跟踪 Claude Code 最新功能和社区趋势的开发者，可查阅“热门”部分和订阅列表。
这个 Agent 有哪些优点和局限？
- 内容全面且结构清晰，覆盖 Claude Code 的核心概念和高级功能，并附有最佳实践和实现示例。
- 汇聚了 Claude Code 创建者 Boris Cherny 及社区专家的 83 条实用技巧，具有很高的实战价值。
- 提供了多个知名开发工作流的对比分析（如 Superpowers、Everything Claude Code 等），帮助用户选择适合的方法论。
- 高度依赖 Claude Code 生态，部分内容（如特定命令、功能）可能随版本更新而失效，需持续关注。
- 仓库主要作为知识库，需要用户自行理解和应用，没有提供一键配置或自动化安装工具。
- 部分内容（如技巧和视频）链接到外部资源，可能失效，且未在仓库内完整备份。
如何安装或部署这个 Agent？
该仓库本身是文档和示例集合，无需安装。用户需先安装 Claude Code CLI（通过 npm install -g @anthropic-ai/claude-code 或参考官方文档），然后克隆本仓库：git clone https://github.com/shanraisshan/claude-code-best-practice.git。仓库中的模板和示例（如 .claude/ 目录结构）可直接复制到自己的项目中。
如何使用这个 Agent？
克隆仓库后，浏览文档。使用内置编排示例：在 Claude Code 中运行 /weather-orchestrator 命令以体验命令→代理→技能流程。参考“最佳实践”和“实现”目录中的示例配置，将子代理、命令、技能等文件复制到自己的项目中。阅读“技巧与窍门”部分，将适用技巧应用到日常开发流程。
这个 Agent 与同类方案有什么区别？
该仓库在开发工作流部分对比了多个知名的 Claude Code 工作流仓库，包括 Superpowers (obra/superpowers)、Everything Claude Code (affaan-m/everything-claude-code)、Matt Pocock Skills (mattpocock/skills)、gstack (garrytan/gstack)、Spec Kit (github/spec-kit)、agent-skills (addyosmani/agent-skills)、Get Shit Done (gsd-build/get-shit-done)、OpenSpec (Fission-AI/OpenSpec)、BMAD-METHOD (bmad-code-org/BMAD-METHOD)、oh-my-claudecode (Yeachan-Heo/oh-my-claudecode) 等，并提供了各工作流的步骤和星级评分，帮助用户根据需求选择。