斜杠命令

内置斜杠命令

Hawa Code 内置了丰富的斜杠命令，在终端输入 / 即可触发命令补全提示，支持上下箭头选择、Tab 或回车确认。

命令 说明
/cd 切换当前会话的工作目录。用法：/cd <path>，支持相对路径和目录自动补全
/clear 清空对话历史并释放上下文，同时触发 SessionEnd / SessionStart hooks
/compact 压缩对话历史，保留摘要到上下文中。优先使用 Session Memory 压缩，否则回退到传统 API 调用方式
/resume 恢复之前的对话，切换到历史会话选择界面
/cost 显示当前会话的总费用和持续时间
/plan 启用 Plan 模式，在执行任务前需要用户审批计划
/auto 启用 Auto 模式，自动执行无需逐条确认
/loop 定时循环执行 prompt 或斜杠命令，默认间隔 10 分钟。用法：/loop [间隔] <prompt>，间隔支持 s/m/h/d 后缀
/init 分析代码库并创建 HAWA.md 项目文档，包含常用命令、架构说明等
/review 审查 GitHub Pull Request。可带 PR 编号参数，未提供时会列出 open PRs
/pr-comments 获取 GitHub PR 的评论（包含 PR 级和代码审查级评论）
/config 打开交互式配置面板
/mcp 管理 MCP 服务器（添加、删除、配置）
/sandbox 配置沙箱环境。显示当前状态：auto-allow、fallback allowed 等
/memory 编辑 Hawa Code 记忆文件（Memory 系统）
/doctor 检查 Hawa Code 安装环境健康状况
/ide 连接 IDE（如 VS Code）以获取集成开发功能
/help 显示帮助信息和可用命令列表
/dream 手动触发 dream
/model 切换 Hawa Code 使用的模型
/thinking 设置 thinking 级别
/goal 给 Hawa Code 设置目标任务

/cd 切换工作目录

/cd 用于切换当前 Hawa Code 会话的工作目录。该命令仅改变当前会话的 cwd，不会影响 Hawa Code 启动时的原始目录。

用法

/cd <path>

特性

  • 支持相对路径：路径会基于当前工作目录解析，例如 /cd subdir 或 /cd ../sibling
  • 目录自动补全：输入 /cd 后，终端会列出当前目录下匹配的子目录建议，支持上下箭头选择、回车或 Tab 确认
  • 路径不变提示：如果目标目录与当前目录相同，会提示 Already in ...
  • 切换成功提示：会返回 Changed directory to .../

示例

/cd src
/cd ../another-project
/cd /home/user/projects/my-app

Skill 命令

所有在 ~/.hcode/skills/ 或项目 .hcode/skills/ 中定义的 Skill，如果设置了 userInvocable: true，会自动生成对应的斜杠命令。例如定义了 commit skill，则可以通过 /commit 调用。

Skill 命令分为两类：

  • context !== ‘fork’：生成 prompt 类型命令，将 Skill 内容作为 prompt 发送给 AI
  • context === ‘fork’：生成 local 类型命令，在独立 agent 中执行 Skill

自定义斜杠命令

字段 说明
name 斜杠命令名称
description 斜杠命令描述
enabled 是否启用，设置为 false 时该命令不会显示在终端
progressMessage 命令执行时显示的消息
argNames 参数名称列表

参考以下示例

---
  name: "Test"
  description: "A simple test command"
  enabled: true
  progressMessage: "Running test command..."
  argNames: [arg1, arg2]
---
  执行 shell ls 命令 , {arg1}，{arg2} 这里写需要的 prompt 语句

command 文件为 markdown 文件，文件路径为：

  • ~/.hcode/commands/
  • 项目文件/commands/