クイックスタート

1) インストール

dotnet tool install -g coders

インストール/使用法の詳細

ワークスペース初期化

coders init を実行して、基本設定とサンプル .jssp ファイル一式を生成します。

• -f|--force がない場合、config.yml が存在すると中断します。
• -v|--verbose でコンソールログを情報レベルに拡張します。
• --force を使うと既存ファイルを新しいテンプレートで上書きします。

生成される config.yml の既定値は次のとおりです:

llmOptions:
  # 使用する LLM 供給者
  provider: "ollama"
  # ビルド時に使用するモデル名
  model: "gpt-oss-safeguard:20b"
  # LLM のエンドポイントと認証情報
  url: "http://localhost:11434"
  apiKey: "OLLAMA_API_KEY"
  timeoutSeconds: 300
  stream: true
entry: main.jssp
projects: []

ルートの llmOptions は LLM 呼び出しに必要な供給者、モデル、エンドポイント、認証、タイムアウト、ストリーミング設定を担当します。projects はプラットフォーム別の出力を定義し、coders platform add で項目を追加して編集します。

プラットフォーム管理

• coders platform list [-v]: 登録済みのプラットフォームキーと既定のターゲット/言語情報を出力します。
• coders platform add <platform> [-v]: 指定したプラットフォームの既定プロジェクト構成を config.yml に追加します。生成されたエントリ/出力パスとオプションは必要に応じて編集します。
• coders platform remove <platform> [-v]: 予約されたサブコマンドです。

ソースビルド

coders build <platform> [-v] で .jssp を解析し、指定したプラットフォーム向けにコードを生成します。

• platform は config.yml の projects に宣言されたプラットフォームキーと一致する必要があります。
• config.yml がない場合はビルドが中断され、エントリファイルがない場合はエラーになります。
• 出力ディレクトリは存在しなければ自動的に作成されます。

プロンプト抽出

coders extract <target> <platform> [-o|--output <path>] [-v] でプロンプトなどのリソースを抽出します。

• target は抽出対象 (例: prompt)、platform はプラットフォームキーです。
• --output で出力先ディレクトリを変更できます。指定しない場合は現在の場所が使われます。

代表的な流れ

coders init
coders platform add <platform>
coders build <platform> -v

初期化後、必要なプラットフォームを構成に追加し、同じキーでビルドを実行します。

2) ワークスペース初期化

coders init

生成される基本ファイル:

• config.yml
• main.jssp

3) プラットフォーム追加

coders platform add springboot
coders platform add reactjs
coders platform add mysql

config.yml に projects 項目が追加されます。

4) DSL 作成

main.jssp に Coders DSL を記述します。

domain Email string(320);

table user {
  user_id int64 auto;
  email Email unique;
  key(user_id);
}

5) ビルド

coders build springboot

出力は config.yml の outPath に生成されます。

プラットフォーム別ビルド例

coders build springboot
coders build reactjs
coders build mysql

各プラットフォームは projects 設定に基づき別々の出力ディレクトリに生成されます。

単一実行で複数プラットフォームをビルド

プラットフォームキーを繰り返し実行するか、スクリプトにまとめて実行します。

coders build springboot
coders build reactjs
coders build mysql

現在の CLI には複数プラットフォームの一括ビルド機能がないため、順次実行します。

6) プロンプト抽出 (任意)

coders extract prompt springboot

プラットフォーム別の変換ルールを確認するのに便利です。

チェックリスト

• config.yml の projects にプラットフォームが登録されているか
• entry ファイルが存在するか
• LLM 設定 (llmOptions) が正しいか

よくあるミス

• coders build 実行時にプラットフォームキーを省略
• entry が main.jssp と異なるのに更新していない
• LLM 供給者/モデル名が実際のサービスと不一致