从这里开始

命令是如何工作的

你只需要知道一件事：Rasen 有两种命令，它们在两个不同的地方运行。

rasen ... 命令在你的终端里运行。（例如：rasen init。）
/rasen:... 命令在你的 AI 助手的聊天里运行。（例如：/rasen:propose。）

如果你曾经把 /rasen:propose 打进终端却毫无反应，这一页就是原因所在。你和 Rasen 的另一半说错话了。斜杠命令不是终端命令。它们是你给 AI 编程助手的指令，打在你平时输入"加一个登录表单"的同一个聊天框里。

这一个区别是新用户最常见的绊脚石，所以我们把它讲得清清楚楚。

两个半边

Rasen 是同一个项目戴着两顶帽子。

CLI（终端那一半）。 一个名为 rasen 的程序，你从 shell 里安装并运行它。它设置你的项目、列出并校验变更、展示一个仪表盘、归档已完成的工作。你在 iTerm、VS Code 终端、PowerShell——任何你会运行 git 或 npm 的地方——里输入这些命令。

rasen init        # 在本项目中设置 Rasen
rasen list        # 查看进行中的变更
rasen view        # 打开交互式仪表盘

斜杠命令（聊天那一半）。 像 /rasen:propose 和 /rasen:apply 这样简短的命令，你把它们打进 AI 助手。这些命令告诉 AI 去遵循 Rasen 工作流：起草提案、编写规格、按任务清单构建、完成后归档。你在 Claude Code、Cursor、Windsurf、Copilot，或你使用的任何助手里输入这些命令。

/rasen:propose add-dark-mode    （打在你的 AI 聊天里）
/rasen:apply                    （打在你的 AI 聊天里）
/rasen:archive                  （打在你的 AI 聊天里）

用一个画面把心智模型概括一下：

        YOUR TERMINAL                         YOUR AI ASSISTANT'S CHAT
   ┌──────────────────────┐               ┌──────────────────────────────┐
   │  $ rasen init     │   installs    │  /rasen:propose add-dark-mode  │
   │  $ rasen list     │  ──────────►  │  /rasen:apply                  │
   │  $ rasen view     │   commands    │  /rasen:archive                │
   └──────────────────────┘    & skills   └──────────────────────────────┘
        run rasen here                       run /rasen:* here

注意那个箭头。在终端里运行 rasen init，正是把斜杠命令安装进你的 AI 工具的动作。终端那一半把聊天那一半设置好。此后，日常的驱动主要发生在聊天里。

"我要怎么开启交互模式？"

没有需要单独开启的交互模式。 这个问题很常见，所以值得给一个直白的回答。

你不需要进入某个特殊的 Rasen 模式。你只需像平时那样打开你的 AI 编程助手，然后在聊天里敲一个斜杠命令。斜杠命令就是你"进入" Rasen 的方式。你的助手认出它、加载对应的 Rasen 技能、然后开始遵循工作流。

所以真正的步骤是：

在你的项目里打开 AI 编程助手（Claude Code、Cursor、Windsurf 等等）。
在它的聊天里输入 /rasen:propose，就和你输入任何其他请求的位置一样。
看自动补全：如果 Rasen 已经安装，你一边敲斜杠，就会看到 /rasen:propose、/rasen:apply 等陆续出现。

就是这样。没有要切换的模式、没有要启动的守护进程、也没有单独的窗口。

有一件真正是交互式的东西确实住在终端里：rasen view。它会打开一个仪表盘，用来浏览你的规格和变更。但它是一个查看器，而不是你用来提议和构建的工具。构建是通过聊天里的斜杠命令完成的。

为什么会有这种拆分

这值得理解一下，因为它解释了为什么 Rasen 能和 25+ 种不同的 AI 工具配合工作。

CLI 是引擎。它掌握规则：变更文件夹长什么样、哪些产物依赖哪些、如何把一份增量规格合并进你的唯一事实来源。它在任何地方都一样。

斜杠命令是方向盘，而每个 AI 工具的方向盘都略有不同。Claude Code 把它们叫作命令。Cursor 和 Windsurf 有各自的格式。有些工具把它们叫作技能。当你运行 rasen init 时，Rasen 会为你选定的每个工具生成正确类型的文件，于是同样的 /rasen:propose 意图，无论你偏爱哪个助手都能奏效。

这种设计的长处：你学一次工作流，就能把它带到各个工具里。代价是：一条命令的确切语法在不同工具之间可能略有不同——这正是下一节的内容。

各工具的斜杠命令语法

意图在任何地方都完全一样。标点符号有所不同。使用与你的助手匹配的那种形式。

工具	你怎么输入
Claude Code	`/rasen:propose`、`/rasen:apply`
Cursor	`/rasen-propose`、`/rasen-apply`
Windsurf	`/rasen-propose`、`/rasen-apply`
GitHub Copilot（IDE）	`/rasen-propose`、`/rasen-apply`
Kimi CLI	技能风格，例如 `/rasen-propose`
Trae	技能风格，例如 `/rasen-propose`

大多数工具要么用冒号形式（/rasen:propose），要么用连字符形式（/rasen-propose）。少数工具把 Rasen 作为具名技能暴露出来，而不是斜杠命令；对于这些工具，你按名字调用技能即可。完整的逐工具清单（包括究竟哪些文件被写到哪里）在支持的工具里。

拿不准时，就在 AI 聊天里敲一个斜杠，然后看自动补全。你的工具会把它期望的形式显示给你。

这些命令是怎么来的：技能与命令

当你运行 rasen init（或 rasen update）时，Rasen 会在你的项目里写入一些小文件，好让你的 AI 工具找到工作流。取决于你的工具和设置，这些文件是技能、命令，或两者皆是。

技能放在 .claude/skills/rasen-*/SKILL.md 这类位置。它们是正在兴起的跨工具标准：一个你的助手会自动探测到的指令文件夹。
命令放在 .claude/commands/rasen/<id>.md 这类位置。它们是较早的、按工具生成的斜杠命令文件。

你不必关心你的工具用的是哪一种。你只需敲出斜杠命令，它就能工作。但知道这些文件的存在，在出问题时会有帮助：如果你的命令消失了，通常意味着这些文件缺失或过期，而 rasen update 会重新生成它们。

参见支持的工具了解每个工具的确切路径，参见迁移指南了解技能是如何取代早先仅有命令的方式的。

确认它已安装

几个快速检查，最快的排前面：

在 AI 聊天里敲一个斜杠。 开始输入 /rasen，留意自动补全的建议。如果它们出现了，你就准备好了。
去找那些文件。 对于 Claude Code，检查 .claude/skills/ 里是否包含 rasen-* 文件夹。其他工具使用它们自己的目录（支持的工具列出了它们）。
重新运行设置。 从你的项目根目录运行 rasen update。这会为你配置的任何工具重新生成技能和命令文件。
重启你的助手。 许多工具在启动时扫描技能和命令，所以开一个新窗口可能正是缺的那一步。

我到底有哪些命令？

默认情况下，Rasen 安装完整（full）配置——箱里就是每条斜杠命令，包括一个核心命令集，涵盖日常节奏：

/rasen:explore：在承诺一项变更之前，先和 AI 一起把想法想清楚（拿不准时极好的第一步）
/rasen:propose：一步创建一个变更并起草它的全部规划产物
/rasen:apply：按变更的任务清单逐项构建
/rasen:sync：把变更的规格更新合并进你的主规格（通常是自动的）
/rasen:archive：完成一项变更并把它归档

一个不错的默认节奏：explore（想清楚做什么）→ propose → apply → archive。先做探索这份指南解释了为什么开头那一步值得。

完整配置还包括一个扩展命令集，给那些想要更精细控制的人（/rasen:new、/rasen:continue、/rasen:ff、/rasen:verify、/rasen:bulk-archive、/rasen:onboard），以及其他阶段比如 /rasen:review-cycle 和 /rasen:goal。如果你想精简到只有核心集合，用 rasen config profile core 切换，然后用 rasen update 应用。

对这一切都还陌生？/rasen:onboard（在扩展命令集里）会带你用自己的代码库走完一整个变更，并为每一步讲解。它是你能找到的最友好的入门。

要了解每条命令的详细作用，参见命令。要了解何时该用哪一条，参见工作流。

一次干净的首跑

把它们串起来，下面是完整的流程，每一步都标注了它发生在哪里。

TERMINAL   $ npm install -g @atelierai/rasen@latest
TERMINAL   $ cd your-project
TERMINAL   $ rasen init
              (installs slash commands into your AI tool)

AI CHAT      /rasen:explore
              (optional: think the idea through with the AI first)

AI CHAT      /rasen:propose add-dark-mode
              (AI drafts proposal, specs, design, tasks)

AI CHAT      /rasen:apply
              (AI builds it, checking off tasks)

AI CHAT      /rasen:archive
              (change is merged into your specs and filed away)

两步终端设置。然后你就活在聊天里。这就是节奏。