> ## Documentation Index > Fetch the complete documentation index at: https://arkor-92aeef0e-eng-353.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # arkor init > カレントディレクトリーに Arkor プロジェクトを生成。 # `arkor init` ```bash theme={null} pnpm exec arkor init ``` `src/arkor/index.ts`、`src/arkor/trainer.ts`、`arkor.config.ts`、スターター `package.json` を **カレントディレクトリー** に生成します。既存リポジトリに Arkor を追加したいときに使います（`pnpm create arkor my-app` のフローは同じツールを 1 つ上のディレクトリーで実行します）。 デフォルトでは部分的に対話的です。プロジェクト名とスターターテンプレートを尋ね、`--skip-install` が指定されない限り（確認プロンプトなしで）パッケージマネージャの `install` を自動実行し、`git init` の前にだけ確認します。パッケージマネージャが解決できない（`--use-*` フラグなし、`npm_config_user_agent` からの検出も失敗）ときは install ステップはスキップされ、最後に手動 install のヒントが表示されます。 ## 概要 ``` arkor init [options] ``` ## オプション | フラグ | 説明 | | ----------------- | ----------------------------------------------------------------------------------------------------- | | `-y, --yes` | プロンプトの代わりにデフォルトを採用（プロジェクト名はディレクトリー名、テンプレートは `triage`）。 | | `--name ` | プロジェクト名。デフォルトはカレントディレクトリー名（パスに basename がない場合 `arkor-project`、例えば `/`）。`package.json` に書く前にサニタイズされます。 | | `--template ` | スターターテンプレート。選択肢: `triage`、`translate`、`redaction`。未知の ID はファイル操作前に例外が発生します。 | | `--skip-install` | 生成後のパッケージマネージャの `install` をスキップ。 | | `--use-npm` | パッケージマネージャに npm を強制。 | | `--use-pnpm` | パッケージマネージャに pnpm を強制。 | | `--use-yarn` | パッケージマネージャに yarn を強制。 | | `--use-bun` | パッケージマネージャに bun を強制。 | | `--git` | 確認なしで git リポジトリを初期化し、初回コミットを作成。 | | `--skip-git` | git init を黙ってスキップ。 | `--git` と `--skip-git` は排他です。両方渡すと例外が発生します。 ## テンプレート | テンプレート | タスク | 出力の形 | | ----------- | ---------- | -------------------------------------------- | | `triage` | サポートのトリアージ | `{ category, urgency, summary, nextAction }` | | `translate` | 9 言語の翻訳 | `{ translation, detectedLanguage }` | | `redaction` | 個人情報のマスク | `{ redactedText, redactedCount, tags }` | 3 つとも同じ小型のオープンウェイトベース（`unsloth/gemma-4-E4B-it`）と HuggingFace 上の厳選公開データセットを組み合わせています。 ## パッケージマネージャ検出 `--use-*` フラグが渡されないとき、CLI は `npm_config_user_agent` を見てどのパッケージマネージャから呼ばれたかを検出します（これは `corepack` が使う標準の仕組みなので、`pnpm dlx`、`yarn dlx`、`bunx` などすべて動きます）。 検出に失敗してフラグもなければ install ステップはスキップされ、手動 install のヒントが最後に表示されます。 ## Git ポリシー `arkor init` は `git init` + 初回コミットを実行するかどうかを次のルールを上から評価して決めます: 1. カレントディレクトリーが既に git リポジトリ内なら、スキップ（ログを出す）。 2. `--skip-git` が渡されていれば、スキップ。 3. `--git` または `-y` が渡されていれば、確認なしで実行。 4. 対話的なシェルでは尋ねる（デフォルト: yes）。 5. 非対話的でフラグなしなら、スキップ。 git init は install の **後** に走るので、パッケージマネージャが生成したロックファイルが初回コミットに含まれます。コミット署名に失敗（GPG agent が動いていないなど）した場合、CLI は署名なしコミットにフォールバックして警告します。あとで `git commit --amend -S` で再署名できます。 ## CI / 非対話シェル `process.stdout` が TTY でない、または `CI` が環境にあるとき `arkor init` は非対話的になります。プロンプトはデフォルト値でスキップされ入力待ちでブロックしません。CI から決定的に生成するには: ```bash theme={null} pnpm exec arkor init --yes --template triage --use-pnpm --skip-git ``` `--yes` でプロジェクト名とテンプレートのデフォルト（ディレクトリー名と `triage`）を採用、`--use-pnpm` でパッケージマネージャ検出をショートサーキット、`--skip-git` で git init をオプトアウト。`node_modules/` がすでにあるイメージなら `--skip-install` も渡してください。 非対話シェルで `--yes` を忘れてもコマンドは完走します（プロンプトはデフォルトを使う）が、サイレントでログから見落としやすい挙動になります。上記の明示形を推奨します。 ## よくあるエラー | メッセージ | 意味 | 対処 | | ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | --------------------------------------------------------- | | `Pick one of --git / --skip-git, not both.`（`--git` と `--skip-git` のどちらか一方だけ指定してください） | git 関連の両フラグを渡した。 | どちらか一方にする。 | | `Unknown template "". Available: triage, translate, redaction`（未知のテンプレート ``。利用可能: triage, translate, redaction） | `--template` の値がどの登録テンプレート ID にも一致しなかった。 | 一覧の ID を使う。 | | `Commit signing failed — created an unsigned commit.`（コミット署名に失敗したため、署名なしコミットを作成しました） | `git init` は成功したが初回コミットを GPG 署名できなかった。 | 署名のセットアップを直したら `git commit --amend -S` で再署名。リポジトリ自体は問題なし。 | ## 例 対話: ```bash theme={null} pnpm exec arkor init ``` デフォルト採用、install スキップ、git スキップ: ```bash theme={null} pnpm exec arkor init --yes --skip-install --skip-git ``` テンプレートを固定して pnpm を強制: ```bash theme={null} pnpm exec arkor init --template translate --use-pnpm ``` ## 何が書かれるか ツールが触るパスは 6 つ。いずれもユーザーの既存内容を上書きしません: | パス | 振る舞い | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `src/arkor/index.ts` | 無ければ `createArkor({ trainer })` で **作成**。あれば **そのまま**。 | | `src/arkor/trainer.ts` | 無ければ選んだテンプレートの `createTrainer({...})` で **作成**。あれば **そのまま**。 | | `arkor.config.ts` | 無ければプレイスホルダーの export として **作成**。あれば **そのまま**。[プロジェクト構成](/ja/concepts/project-structure) を参照。 | | `README.md` | 無ければスターター README で **作成**。あれば **そのまま**。 | | `.gitignore` | 無ければ `node_modules/`、`dist/`、`.arkor/` で **作成**。ファイルがあって `.arkor/` が入っていなければ追記で **パッチ**。既に入っていれば変更なし（**Ok**）。 | | `package.json` | 無ければ name / `private` / `type: "module"` / `dev`+`build`+`start` のスターター scripts / `devDependencies.arkor` で **作成**。不足している script があれば追加し、`devDependencies.arkor` がなければ追加する **パッチ**。既存の値（カスタム `dev` script など）は **上書きしません**。すべて揃っていれば変更なし（**Ok**）。 | CLI は install 前に "Files" ノートとしてファイル一覧を表示し、各パスの `action`（`created` / `kept` / `patched` / `ok`）を出すので、何が変わったか正確に確認できます。