[ contents ]
はじめに

コマンドの動作方法

知っておくべき 1 つのこと:rasen には 2 種類のコマンドがあり、2 つの異なる場所で実行されます。

  • rasen ... コマンドは ターミナル で実行されます。(例:rasen init。)
  • /rasen:... コマンドは AI アシスタントのチャット で実行されます。(例:/rasen:propose。)

/rasen:propose をターミナルに入力して何も起こらない場合、このページが理由です。あなたは rasen の間違った半分と話しています。スラッシュコマンドはターミナルコマンドではありません。これらは AI コーディングアシスタントに与えられる指示で、通常「ログインフォームを追加」と入力するのと同じチャットボックスです。

その単一の区別は、新規ユーザーにとって最も一般的なつまずきであるため、それを明確にしましょう。

2 つの半分

Rasen は 2 つの帽子を着ている 1 つのプロジェクトです。

CLI(ターミナルハーフ)。 rasen という名前のプログラムで、シェルからインストールして実行します。プロジェクトをセットアップし、変更をリストおよび検証し、ダッシュボードを表示し、終了した仕事をアーカイブします。iTerm、VS Code ターミナル、PowerShell、git または npm を実行できるどこにでも、これらを入力します。

rasen init        # このプロジェクトで rasen をセットアップ
rasen list        # アクティブな変更を確認
rasen view        # インタラクティブダッシュボードを開く

スラッシュコマンド(チャットハーフ)。 /rasen:propose/rasen:apply のような短いコマンド。これらは AI アシスタントに入力されます。これらは rasen ワークフローに従うよう AI に指示します:提案を起案し、仕様を書き、タスクリストから構築し、完了時にアーカイブします。これらを Claude Code、Cursor、Windsurf、Copilot、またはあなたが使用するアシスタントに入力します。

/rasen:propose add-dark-mode    (AI チャットに入力)
/rasen:apply                    (AI チャットに入力)
/rasen:archive                  (AI チャットに入力)

1 つの絵でメンタルモデル:

        あなたのターミナル                    AI アシスタントのチャット
   ┌──────────────────────┐               ┌──────────────────────────────┐
   │  $ rasen init     │   インストール │  /rasen:propose add-dark-mode  │
   │  $ rasen list     │  ──────────►  │  /rasen:apply                  │
   │  $ rasen view     │   コマンド    │  /rasen:archive                │
   └──────────────────────┘    & スキル  └──────────────────────────────┘
        ここで rasen を実行         ここで /rasen:* を実行

矢印を注意してください。ターミナルで rasen init を実行することは、AI ツールにスラッシュコマンドを インストール するものです。ターミナルハーフはチャットハーフをセットアップします。その後、日常的な運転はほぼチャットで起こります。

「インタラクティブモードを開始するにはどうすればよいですか?」

開始する別のインタラクティブモードはありません。 この質問はよく出現するため、単純な答えを使用します。

あなたは特別な rasen モードに入りません。AI コーディングアシスタントを常に行うようにただ開き、チャットにスラッシュコマンドを入力します。スラッシュコマンド rasen に「入る」方法です。あなたのアシスタントはそれを認識し、一致する rasen スキルを読み込み、ワークフローに従い始めます。

したがって、実際の指示は:

  1. AI コーディングアシスタント(Claude Code、Cursor、Windsurf など)をプロジェクトで開く。
  2. チャットに /rasen:propose を入力します。他のリクエストを入力するのと同じ場所。
  3. オートコンプリートを見てください:rasen がインストールされている場合、スラッシュを入力するにつれて /rasen:propose/rasen:apply などが表示されます。

これです。モードを切り替える、デーモンを起動する、別のウィンドウはありません。

本当に インタラクティブな 1 つのもの、ターミナルに住んでいます: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)を使用します。いくつかのツール(ForgeCode、Kimi CLI、Mistral Vibe、Trae)はスキルを取得しますが、コマンドアダプターはありません。したがって、スラッシュコマンドではなく名前でスキルを呼び出します。ツール単位の完全なリスト、ファイルがどこに書かれるかを含むは Supported Tools に住んでいます。

疑わしい場合は、AI チャットでスラッシュを入力して、オートコンプリートを見てください。あなたのツールが期待する形式を表示します。

コマンドがどこに来たか:スキルとコマンド

rasen init(または rasen update)を実行すると、rasen はあなたの AI ツールがワークフローを見つけることができるようにプロジェクトに小さなファイルを書きます。ツールと設定に応じて、これらは スキルコマンド、または両方です。

  • スキル.claude/skills/rasen-*/SKILL.md のような場所に住んでいます。これは新興のクロスツール標準です:あなたのアシスタントが自動検出するフォルダの指示。
  • コマンド.claude/commands/rasen/<id>.md のような場所に住んでいます。これらはより古いツール単位のスラッシュコマンドファイルです。

あなたのツールがどちらを使用するか気にかける必要はありません。スラッシュコマンドを入力するだけで機能します。しかし、これらのファイルが存在することを知ることは、何か悪いことが起こったときに役立ちます:コマンドが消えた場合、通常はこれらのファイルが欠落しているか古いため、rasen update がそれらを再生成します。

ツール単位の正確なパスについては Supported Tools を参照し、スキルが古いコマンドのみのアプローチをどのように置き換えたかについては Migration Guide を参照してください。

インストールされていることを確認する

クイックチェック、最速最初:

  1. AI チャットでスラッシュを入力します。 /rasen の入力を開始して、オートコンプリート提案を見てください。表示されたら、セットされます。
  2. ファイルを確認します。 Claude Code の場合、.claude/skills/rasen-* フォルダが含まれていることを確認します。他のツールは独自のディレクトリを使用します(Supported Tools はそれらをリストします)。
  3. セットアップを再実行します。 プロジェクトルートから rasen update を実行します。これにより、設定したツールのスキルとコマンドファイルが再生成されます。
  4. アシスタントを再開します。 多くのツールはスタートアップでスキルとコマンドをスキャンするため、新しいウィンドウが欠落したステップである可能性があります。

どのコマンドを持っていますか?

デフォルトでは、rasen は full プロファイルをインストールします — すべてのスラッシュコマンド:

  • /rasen:explore:変更にコミットする前に AI でアイデアを考え抜く(確信がない場合の素晴らしい最初のステップ)
  • /rasen:propose:変更を作成し、すべての計画成果物をワンステップで起案
  • /rasen:apply:タスクリストを処理することで変更を構築
  • /rasen:sync:変更の仕様更新をメイン仕様にマージ(通常は自動)
  • /rasen:archive:変更を終了して保存

良いデフォルトリズム:何をするかを把握しているときに explore、その後 proposeapplyarchiveExplore First ガイドはなぜその開始ステップが報酬を受けるかを説明します。

フルプロファイルはまた、より細かい制御(/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(拡張セット)はあなた独自のコードベースで完全な変更を歩みます。それは最も親しみやすい可能な紹介です。

各コマンドが詳細に行うことについては、Commands を参照してください。どれを到達すべきかについては、Workflows を参照してください。

クリーンな最初の実行

それを置くには、各ステップがどこで起こるかでラベル付けされた全体的なシーケンスは以下です。

ターミナル   $ npm install -g @atelierai/rasen@latest
ターミナル   $ cd your-project
ターミナル   $ rasen init
              (AI ツールにスラッシュコマンドをインストール)

AI チャット      /rasen:explore
              (オプション:アイデアを最初に AI で考え抜く)

AI チャット      /rasen:propose add-dark-mode
              (AI が提案、仕様、設計、タスクを起案)

AI チャット      /rasen:apply
              (AI はそれを構築し、タスクをチェックオフ)

AI チャット      /rasen:archive
              (変更はあなたの仕様にマージされ、整理)

セットアップするための 2 つのターミナルステップ。その後、チャットで生活します。それはリズムです。

関連

  • Getting Started:完全な最初の変更ウォークスルー
  • Commands:すべてのスラッシュコマンドの詳細
  • CLI:すべてのターミナルコマンドの詳細
  • Supported Tools:ツール単位の構文とファイルの場所
  • FAQ:より多くのクイック回答
  • Troubleshooting:コマンドが表示されない場合の修正