SuperAPI AI 工具集

claude-code-skill

编程与开发

查看项目

更新于 10-15 08:33

技能介绍

用途

Claude Code Skill 用于通过 MCP(模型上下文协议)控制 Claude Code。它面向 openclaw 智能体,让智能体能够以编程方式调用 Claude Code 的能力,包括持久会话、智能体团队和高级工具控制。

主要能力

基本 MCP 操作

  • connect / status / tools:连接、查看状态与工具列表
  • bash:执行 shell 命令
  • read:读取文件内容
  • glob:按模式查找文件
  • grep:搜索文件内容
  • call:直接调用指定工具(示例中为 Write)
  • disconnect:断开连接

持久会话(Agent Loop)

  • session-start:启动会话,支持 -d 指定项目目录、--permission-mode、--allowed-tools、--max-budget、--model、--base-url、--append-system-prompt、--add-dir、--agents、--agent、--system-prompt、--tools、--disallowed-tools、--resume、--fork-session、--session-id 等参数
  • session-send:发送消息,支持 --stream 实时反馈与 -t 自定义超时
  • session-status / session-list / session-history:查看状态、列出会话、查看历史
  • session-pause / session-resume-paused:暂停与恢复
  • session-fork:分叉会话
  • session-stop / session-restart:停止与重启会话

权限模式

包含 acceptEdits(自动接受文件编辑,默认)、plan(应用前预览更改)、default(每次操作询问)、bypassPermissions(跳过所有提示,危险)、delegate(将决策委托给父级)、dontAsk(从不询问,默认拒绝)。

会话历史与搜索

  • sessions:浏览 Claude Code 会话
  • session-search:按项目、时间(如 2h、日期)或查询词搜索
  • resume:恢复历史会话

批量操作

  • batch-read:一次读取多个文件

智能体团队

  • 可在启动会话时定义多个智能体(如 architect、developer、reviewer),并通过 @agent 名称在对话中切换
  • 提供代码审查团队(security、performance、quality)与全栈团队(frontend、backend、database)等模板示例

高级功能

  • 工具控制:--allowed-tools、--disallowed-tools、--tools(含模式匹配,如 Bash(git:,npm:)),可禁用全部工具
  • 系统提示词:--system-prompt 完全替换、--append-system-prompt 追加
  • 会话管理:--resume 配合 --fork-session、--session-id 自定义 UUID、--add-dir 添加工作目录
  • 多模型支持(代理):通过 --base-url 将请求路由至代理,使 Gemini、GPT 等模型驱动 Claude Code;需在 8082 端口运行 claude-code-proxy 并配置 API 密钥

可用工具(经 MCP)

Bash、Read、Write、Edit、Glob、Grep、Task、WebFetch、WebSearch、Git*、AskUserQuestion 等(文档称共 10+ 个)。

使用方式

快速开始示例:

  • claude-code-skill session-start myproject -d ~/project --permission-mode plan --allowed-tools "Bash,Read,Edit,Write,Glob,Grep" --max-budget 2.00
  • claude-code-skill session-send myproject "Find all TODO comments and create GitHub issues" --stream
  • claude-code-skill session-status myproject

与 OpenClaw 集成:

  • openclaw skills run claude-code-skill -- session-start task -d ~/project
  • openclaw skills run claude-code-skill -- session-send task "Implement feature X" --stream
  • openclaw skills run claude-code-skill -- session-status task

架构:openclaw agent → claude-code-skill CLI → HTTP(sasha-doctor API :18795)→ MCP(claude mcp serve)→ 文件与工具。

适用场景

建议使用持久会话的情形:需要多次工具调用的多步骤任务、迭代式开发(写代码→测试→修复→重复)、需要完整上下文的长时间对话、智能体需自主工作、需要流式实时反馈。

建议使用直接 MCP 工具的情形:单条命令执行、快速文件读写、一次性搜索、操作之间无需上下文。

文档给出的示例场景包括:代码审查、自动化测试、多智能体调试。

最佳实践与限制

  • 对多步骤任务使用持久会话,避免多次断开/重连
  • 对长时间任务使用 --stream
  • 设置预算上限(如 --max-budget 2.00)
  • 对关键更改使用 plan 模式预览
  • 实验前先分叉会话
  • 错误恢复:session-status、session-history、session-restart,或停止后以 --resume 旧会话 ID 重启
  • bypassPermissions 会跳过所有提示,文档标注为危险
  • 多模型支持需自行运行 claude-code-proxy 并配置 API 密钥

暂未提供的信息

关于收费、价格与平台支持的官方说明,资料中暂未提供。