【claude-code-best-practice】让 Claude 编程更聪明、更自主、更可控的一套工程化实践指南

这是一个面向 Claude Code 用户的开源实践集合，它不提供新软件，而是系统性地整理和推广如何用好 Claude Code 这一 AI 编程工具——通过结构化的配置、可复用的模式和经过验证的工作流，把“让 Claude 写代码”升级为“让 Claude 像资深工程师一样思考、协作与交付”。

项目的主要功能与特性包括：
– Subagents（子智能体）：为不同任务创建隔离的上下文环境，拥有独立模型、工具、权限和记忆。
– Commands（指令命令）：以 /xxx 形式调用的预设工作流模板，存放在 .claude/commands/ 目录下，支持 Git 版本管理。
– Skills（技能）：可配置、可发现、支持上下文分叉的知识模块，以文件夹形式组织，含脚本、示例与渐进式提示。
– Workflows（编排工作流）：如 weather-orchestrator.md 所示，体现 “命令 → 智能体 → 技能” 的标准执行链路。
– Hooks（钩子）：在事件（如工具调用前后、会话结束）触发的自定义脚本或 HTTP 请求，用于增强安全性、格式化输出或自动审批。
– MCP Servers（模型上下文协议服务）：通过 .mcp.json 和 .claude/settings.json 连接外部数据库、API 或工具，扩展 Claude 的能力边界。
– Plugins（插件）：打包了技能、子智能体、钩子等的可分发单元，支持市场安装与共享。
– Auto Mode（自动模式）：启用 --permission-mode auto 后，由后台安全分类器替代人工权限确认，兼顾效率与防护。
– Channels（消息通道）：支持 Telegram、Discord 等平台事件推送至本地会话，实现离线响应。
– Code Review（代码审查）：集成 GitHub App，提供多智能体协同的 PR 分析，识别漏洞与回归风险。
– Scheduled Tasks（定时任务）：支持 /loop（本地循环）和 /schedule（云端调度），让 Claude 在你离开时持续工作。
– Git Worktrees 支持：原生适配 Git 工作树，为每个分支启动独立智能体会话，保障并行开发隔离性。

项目提供了清晰的快速启动方式：

claude  
/weather-orchestrator  

该命令可直接运行一个天气查询工作流示例。其余高级功能（如 Auto Mode、Channels、MCP 等）均需通过 CLI 参数、配置文件或插件安装启用，具体请参考官方文档进行安装。

这个项目适合以下场景和用户：
– AI 原生开发者：希望摆脱重复提示、构建可复用、可协作、可审计的 AI 编程流程；
– 团队技术负责人：需要统一团队的 Claude 使用规范，沉淀最佳实践（如 CLAUDE.md 编写、PR 审查策略、权限模型）；
– 工程效能工程师：致力于将 Claude 深度嵌入 CI/CD（GitHub Actions）、日常调试（Chrome MCP）、跨设备协作（Remote Control）等真实研发链路；
– 高级个人开发者：追求“少干预、高产出”，习惯用 subagents 分离关注点、用 skills 封装领域知识、用 hooks 控制边界。

总结：这不是一个开箱即用的工具，而是一份沉甸甸的“Claude Code 工程手册”——它把零散的经验、隐藏的功能、生产级的模式全部结构化呈现出来。如果你已开始认真使用 Claude Code，这份实践集就是你从“会用”迈向“精通”的必经之路；建议访问其主页获取更详细信息。