用途
claude-code-expert 是一个针对 Anthropic 官方 CLI 工具 Claude Code 的专家型技能,用于帮助用户配置、优化和排查 Claude Code 相关问题。资料将其定位为把每次会话变成更高效、更快速的体验,覆盖快捷键、hooks、MCP、进阶配置、工作流、CLAUDE.md、记忆、子代理、权限和生态集成等主题。
主要能力
- 基础与安装:说明 Claude Code 是 Anthropic 官方 CLI,可直接在终端中作为编码代理使用,能访问文件系统、执行 bash、git、npm 等命令,并通过 CLAUDE.md 与记忆文件保持上下文,支持 MCP 服务器、hooks,以及通过 Task 工具创建和编排子代理。安装命令为
npm install -g @anthropic-ai/claude-code,启动方式包括claude、claude "任务"和claude --help。 - 命令行参数:列出
-p、--model、--max-tokens、--no-stream、--output-format json、--allowed-tools、--dangerously-skip-permissions、--max-turns等参数的用途。 - CLAUDE.md 与记忆:介绍全局、项目、子目录三级 CLAUDE.md 的加载层级,推荐章节结构(上下文、命令、代码约定、架构、业务规则、可用技能、任务前协议等),以及记忆文件目录
~/.claude/projects/<路径哈希>/memory/的组织方式和自动保存脚本示例。 - Hooks:说明 PreToolUse、PostToolUse、Notification、Stop、SubagentStop 等触发时机,以及全局和项目级配置位置,并给出提示音、Bash 操作日志、安全扫描等 JSON 示例。
- MCP 服务器:介绍用
claude mcp add/list/get/remove管理 MCP,列举 filesystem、github、postgres/sqlite、puppeteer/playwright、slack、fetch 等常见 MCP,并给出用 Node.js 编写自定义 MCP 服务器的代码示例。 - 子代理:说明通过 Task 工具并行运行子代理、
run_in_background后台运行、isolation: worktree隔离,以及 general-purpose、Bash、Explore、Plan 等子代理类型和最佳实践。 - 权限与安全:给出项目级
.claude/settings.json中 allow/deny 权限配置示例,并说明--dangerously-skip-permissions仅应在受控 CI/CD、自动化脚本或隔离沙箱中使用,禁止用于生产环境、含密钥仓库或共享环境。 - 工作流:提供完整功能开发四阶段流程(简报与规划、实现、测试、代码审查)、自主模式长周期运行、会话启动脚本和 CI/CD 评审流水线示例。
- 排错与配置:列出常见问题(API key 缺失、超时、上下文窗口满、子代理路径错误、hook 不执行、MCP 连接失败、意外压缩、Bash 权限错误)及对应解决方式,并给出推荐的
~/.claude/settings.json完整示例和环境变量。 - 生态与斜杠命令:说明与 agent-orchestrator、task-intelligence、context-agent、context-guardian 等技能的配合方式及相关脚本命令,并列出
/status、/clear、/compact、/memory、/hooks、/mcp、/cost、/model、/help等斜杠命令。
使用方式
资料说明,当用户需要配置或优化 Claude Code CLI、创建或调试 hooks、添加或配置 MCP 服务器、创建子代理与并行编排、了解 Claude Code 功能、排查 CLI 错误、优化 CLAUDE.md 和记忆文件、配置权限与安全时,会激活该技能。
适用场景
适合 Claude Code 的日常配置、自动化扩展(hooks/MCP)、多代理并行开发流程、CI/CD 中的自动评审,以及项目上下文与记忆管理。
限制
资料强调,仅当任务明确符合上述范围时使用该技能;不应将输出视为环境特定验证、测试或专家评审的替代;缺少必要输入、权限、安全边界或成功标准时应停止并请求澄清。资料还提醒,应按具体上下文审查建议后再用于生产代码。