role-creator

ロール作成者

概要

このスキルを使用すると、スタンドアロンの TOML ファイルとしてカスタム Codex エージェントを作成、更新、またはトラブルシューティングできます。

現在の動作：

• 各カスタムエージェントは 1 つのファイルで定義されます：
  • グローバル：~/.codex/agents/<agent-name>.toml
  • プロジェクト：<project>/.codex/agents/<agent-name>.toml
• エージェントファイルがロールの信頼できる唯一の情報源です。
• ~/.codex/config.toml はグローバル／ランタイム設定（例：[agents] のスレッド制限）のみに使用し、ロールごとの登録には使用しません。

必須入力

ファイルを書き込む前に、手順 1 を完了する必要があります：

• name（agent_type で使用するロール識別子）
• description（短く、人が読んでわかる目的）
• developer_instructions
• model（指定がない場合は gpt-5.3-codex を推奨）
• model_reasoning_effort（none|minimal|low|medium|high|xhigh）
• ロールのスコープ（global または project）
• 出力 TOML パス（正規の絶対パスを推奨）
• nickname_candidates を含めるかどうか、および含める場合は正確な値

実行ルール：

• 必須値を推測してはいけません。
• 必須入力が明示的に確認されるまで、書き込みを行ってはいけません。

ロールファイルの仕様（現行）

Codex カスタムエージェントのドキュメント（/codex/subagents）より：

• 必須キー：name、description、developer_instructions。
• オプションのキー：nickname_candidates、model、model_reasoning_effort、sandbox_mode、web_search、mcp_servers、skills.config など。
• name は起動識別子であり、信頼できる唯一の情報源です。
• description と developer_instructions で動作と使用範囲を定義します。
• nickname_candidates は任意で、表示にのみ使用されます。

nickname_candidates の要件：

• 指定する場合、空でない一意の値のリストである必要があります。
• 使用できる文字：ASCII の英字、数字、スペース、ハイフン、アンダースコア。

オプション設定のデフォルトポリシー

• 要求がない限り、サンドボックス、MCP、ウェブ検索、モデルに関する追加設定を加えないでください。
• デフォルトでは、生成ファイルを最小限に保ってください。
• ユーザーが「デフォルトを継承」と指定した場合、明示的な値を設定せず、オプションのキーを省略してください。

ワークフロー

1. 必須入力を収集し、確認します。
2. 出力パスを解決します：
   • global → ~/.codex/agents/<name>.toml
   • project → <project>/.codex/agents/<name>.toml
3. 必須キーを含むファイルを直接作成または更新します。
4. TOML の解析と必須キーを検証します。
5. すぐに実行できる呼び出し例を返します：

{"agent_type":"<name>","message":"<task>"}

コマンド

# 1) Write a standalone custom-agent file
/home/willr/Applications/skills/skills/role-creator/scripts/write_role_config.sh \
  --output ~/.codex/agents/reviewer.toml \
  --role-name reviewer \
  --description "PR reviewer focused on correctness, security, and risk." \
  --model gpt-5.4 \
  --reasoning high \
  --developer-instructions "Review code like an owner. Lead with concrete findings and residual risks."

# Optional: include nickname candidates for display
/home/willr/Applications/skills/skills/role-creator/scripts/write_role_config.sh \
  --output ~/.codex/agents/reviewer.toml \
  --role-name reviewer \
  --description "PR reviewer focused on correctness, security, and risk." \
  --model gpt-5.4 \
  --reasoning high \
  --developer-instructions "Review code like an owner. Lead with concrete findings and residual risks." \
  --nickname-candidates "Atlas,Delta,Echo" \
  --sandbox-mode read-only \
  --web-search disabled

ガードレール

• ランタイムが unknown agent_type を返した場合は、アクティブなスコープを確認し、想定されるパスにファイルが存在することを確認してください。
• まず tomlq または tomlq -C で構文を確認してください。
• 指示は運用可能で、範囲を狭く保ち、逸脱を防いでください。

参考資料

• Codex サブエージェントのドキュメント：https://developers.openai.com/codex/subagents
• 表示名のニックネーム：https://developers.openai.com/codex/subagents#display-nicknames
• 再利用可能なテンプレート：templates/