ヘルプ

トラブルシューティング

具体的な問題に対する具体的な修正。各エントリは症状に名前を付け、1 つの文で原因を説明し、修正を与えます。問題がここに表示されない場合、FAQ が役立つ可能性があり、Discord は確実にそうします。

インストールとセットアップ

`rasen: command not found`

CLI がインストールされていないか、シェルがそれを見つけることができません。グローバルにインストールしてチェック:

npm install -g @atelierai/rasen@latest
rasen --version

インストール済みだがまだ見つからない場合、グローバル npm bin ディレクトリ、おそらく PATH にありません。npm bin -g を実行してグローバルバイナリが住むどこを確認し、そのパスがシェルプロファイルに含まれていることを確認してください。

「Node.js 20.19.0 以降が必要です」

Rasen は Node 20.19.0+ で実行されます。バージョンを確認してアップグレード:

node --version

bun を使用して rasen をインストールする場合、rasen は依然として Node で実行される場合は、関係なく Node 20.19.0+ があることを PATH に確認してください。インストールを参照してください。

`rasen init` が AI ツールを設定しませんでした

Init は設定するツールを尋ねます。ツールをスキップした場合、または別のツールを追加する場合、もう一度実行するか、非インタラクティブフォームを使用してください:

rasen init --tools claude,cursor

ツール ID の完全なリストは、サポート対象ツールにあります。すべてに --tools all を使用、--tools none ツールセットアップをスキップします。

コマンドが表示されない

/rasen:propose（またはツールの同等物）が表示されない場合、または何もしない場合、このリストで作業してください。それらは最初に確認するのが最速です。

間違った場所にいるかもしれません。 スラッシュコマンドは端末ではなく、AI アシスタントのチャットに進みます。シェルに /rasen:propose を入力した場合、それが問題です。コマンドがどのように機能するかを参照してください。
ファイルを再生成します。 プロジェクトルートから:
```
rasen update
```
これにより、設定したすべてのツールのスキルファイルとコマンドファイルが書き直されます。
アシスタントを再起動します。 ほとんどのツールはスタートアップ時にスキルとコマンドをスキャンします。新しいウィンドウは多くの場合それを実行します。
ファイルが存在することを確認します。 Claude Code の場合、.claude/skills/ に rasen-* フォルダが含まれていることを確認してください。他のツールは独自のディレクトリを使用し、すべてサポート対象ツールにリストされます。
このプロジェクトを初期化したことを確認してください。 スキルはプロジェクトごとに書き込まれます。リポをクローンしたか、フォルダを切り替えた場合、rasen init（または rasen update）を実行してください。
ツールがコマンドファイルをサポートすることを確認します。 いくつかのツール（Kimi CLI、Trae、ForgeCode、Mistral Vibe）は生成 rasen-* コマンドファイルを取得しません。代わりにスキルベースの呼び出しを使用します。フォームはツールごとに異なります: サポート対象ツールとコマンドがどのように機能するかを参照してください。

変更で動作

「変更が見つかりません」

コマンドは、どの変更を意図したかを判断できません。明示的に名前を付けるか、存在するものを確認:

rasen list                    # see active changes
/rasen:apply add-dark-mode        # name the change in chat

また、正しいプロジェクトディレクトリにいることを確認してください。

「成果物は準備完了ではありません」

すべての成果物は、すでに作成されているか、依存関係を待機中にブロックされています。何がブロックしているかを確認:

rasen status --change <name>

その後、欠落している依存関係を最初に作成します。順序を覚えてください: 提案がスペックと設計を有効にします。スペックと設計は一緒にタスクを有効にします。

`rasen validate` が警告またはエラーをレポート

検証は、構造的な問題のスペックと変更をチェック。メッセージを読んでください: ファイルと問題に名前を付けます。

rasen validate <name>           # validate one item
rasen validate --all            # validate everything
rasen validate --all --strict   # stricter checks, good for CI

一般的な原因は必要なセクション（シナリオなしの仕様など）の欠落、または不正な形式のデルタヘッダーです。ファイルを修正して再実行してください。CLI リファレンスは出力フォーマットをドキュメント化します。

AI が不完全または間違った成果物を作成しました

AI には十分なコンテキストがありません。いくつかのレバーが役立ちます:

プロジェクトコンテキストを rasen/config.yaml に追加して、スタックと慣例がすべてのリクエストに注入されるようにします。カスタマイズを参照してください。
スペックのみに適用する指導のための成果物ごとの rules: を追加します。
提案する際に、より詳細な説明を与えます。
展開 /rasen:continue を使用して、すべてを一度に実行する代わりに、1 つずつ成果物を作成してレビュー /rasen:ff。

アーカイブが終了しない、または不完全なタスクについて警告

アーカイブは不完全なタスクをしませんブロック、しかし警告を与えます。なぜなら、アーカイブ通常は仕事が完了していることを意味します。タスクが意図的に残る場合（部分的な変更をファイルしている）、進みます。それ以外の場合はタスクを最初に終了してください。また、デルタ仕様をメイン仕様に同期していない場合、アーカイブはそれらを同期するのを提供します。理由がない限り、はいと言ってください。

設定

私の `config.yaml` が適用されていない

3 つの通常の容疑者:

ファイル名が間違っています。 rasen/config.yaml である必要があり、.yml ではありません。
無効な YAML。 YAML バリデータを通じてそれを実行します。CLI は行番号を持つ構文エラーもレポート。
再起動を期待しました。 必要ありません。設定の変更は即座に有効になります。

「ルールの不明な成果物 ID: X」

rules: 下のキーは、スキーマの成果物と一致しません。デフォルト spec-driven スキーマ、有効な ID は proposal、specs、design、tasks。任意のスキーマのID を確認:

rasen schemas --json

「コンテキストが大きすぎます」

context: フィールドは意図的に 50KB でキャップされます。すべてのリクエストに注入されるためです。要約するか、それらを貼り付ける代わりに長いドキュメントへのリンク。リーンコンテキストもより良く、より速い結果をもたらします。

「スキーマが見つかりません」

参照したスキーマ名は存在しません。利用可能なものをリストして、スペルをチェック:

rasen schemas                    # list available schemas
rasen schema which <name>        # see where a schema resolves from
rasen schema init <name>         # create a custom one

カスタマイズを参照してください。

レガシーワークフローからのマイグレーション

「非インタラクティブモードでレガシーファイルが検出されました」

CI または非インタラクティブシェルにいて、rasen は古いファイルをクリーンアップ見つけたがプロンプトができません。自動的に承認:

rasen init --force

マイグレーション後にコマンドが表示されませんでした

IDE を再起動してください。スキルはスタートアップで検出されます。まだ表示されない場合、rasen update を実行し、サポート対象ツールでファイル位置をチェックしてください。

私の古い `project.md` がマイグレーションされませんでした

それは意図的です。Rasen は書き込んだコンテキストを保持する可能性があるため、project.md を自動的に削除することはありません。有用な部分を config.yaml の context: セクションに移動し、自分で削除します。マイグレーションガイドはこれをチュートリアル、AI に手を与え、蒸留するプロンプトを含めています。

まだ立ち往生?

Discord: discord.gg/YctCnvvshC
GitHub Issues: github.com/DumoeDss/rasen/issues
端末から: rasen feedback "what went wrong" イシューを開きます。

問題を報告するとき、rasen バージョン（rasen --version）、Node バージョン（node --version）、AI ツール、正確なコマンドと出力を含めてください。ヘルプがはるかに高速になります。