agent-persona

AIエージェントの人格を簡単に切り替えられるCLIツール

概要

agent-personaは、Cursorエディタの.cursorrulesファイルを使って、AIアシスタントの人格を手軽に切り替えるためのCLIツールです。プロジェクトごとに異なる人格（優しいヘルパー、厳格なメンター、関西弁のおっちゃんなど）を設定し、開発スタイルに合わせてAIの対応を変えることができます。

特徴

• 🚀 簡単切り替え: ワンコマンドで人格を切り替え
• 🔄 バックアップ機能: 安全な.cursorrulesファイルの管理
• 💬 対話形式: 新しい人格を簡単に追加
• 📁 プロジェクト対応: プロジェクトディレクトリを自動検出
• 🎭 豊富な人格: デフォルトで4つの人格を提供

インストール

npmから（予定）

npm install -g agent-persona

ローカルビルド

git clone <repository-url>
cd kuso-app
npm install
npm run build
npm install -g .

使用方法

初期設定

agent-persona init

利用可能な人格を確認

agent-persona list
# または
agent-persona ls

人格を切り替え

agent-persona switch <人格ID>
# または
agent-persona s <人格ID>

# 例
agent-persona switch friendly-helper
agent-persona s kansai-ojisan

現在の人格を確認

agent-persona current

新しい人格を追加

agent-persona add

対話形式で以下を入力します：

• 人格ID（英数字とハイフン、アンダースコアのみ）
• 表示名
• 説明
• タグ（省略可）
• プロンプト（複数行入力、endで終了）

バックアップから復元

agent-persona restore

デフォルト人格

初期化時に以下の人格が利用可能になります：

| 人格ID | 名前 | 説明 | |--------|------|------| | default | デフォルト | 標準的なプログラミングアシスタント | | friendly-helper | 優しいヘルパー | 初心者にも分かりやすく教えてくれる優しいアシスタント | | strict-mentor | 厳格なメンター | コードの品質にこだわる厳しいメンター | | kansai-ojisan | 関西のおっちゃん | ノリの良い関西弁で話すベテランエンジニア |

コマンド一覧

| コマンド | エイリアス | 説明 | |----------|------------|------| | init | - | 初期設定（デフォルト人格作成など） | | list | ls | 利用可能な人格一覧を表示 | | switch <name> | s <name> | 指定した人格に切り替え | | current | - | 現在アクティブな人格を表示 | | add | - | 新しい人格を対話形式で追加 | | restore | - | .cursorrulesをバックアップから復元 |

ファイル構造

~/.agent-persona/
├── config.json          # 設定ファイル
└── personas/            # 人格定義ファイル
    ├── default.jsonc
    ├── friendly-helper.jsonc
    ├── strict-mentor.jsonc
    └── kansai-ojisan.jsonc

プロジェクトディレクトリ/
├── .cursorrules          # アクティブな人格のプロンプト
└── .cursorrules.backup   # 切り替え前のバックアップ

開発

要件

• Node.js 18+
• npm

セットアップ

git clone <repository-url>
cd agent-persona
npm install

ビルド

npm run build

テスト

npm test

開発モード

npm run dev

リント・フォーマット

npm run lint      # ESLintチェック
npm run lint:fix  # ESLint自動修正
npm run format    # Prettierフォーマット

技術仕様

• 言語: TypeScript
• ランタイム: Node.js
• パッケージマネージャー: npm
• テスト: Vitest
• リンター: ESLint
• フォーマッター: Prettier
• ビルド: TypeScript Compiler

ライセンス

MIT

貢献

プルリクエストやイシューの報告を歓迎します。開発に参加される場合は、まずイシューを作成してください。

トラブルシューティング

Q: agent-personaコマンドが見つからない

A: グローバルインストールが正常に行われているか確認してください。

Q: 人格の切り替えが反映されない

A: agent-persona currentで設定を確認し、必要に応じて再度switchコマンドを実行してください。

Q: .cursorrulesファイルが見つからない

A: プロジェクトのルートディレクトリでagent-persona initを実行してください。