---

name: agent-scaffolder description: "Use when user says 'agent を作りたい', 'create agent', 'scaffold agent', '新しい agent', 'agent 作成', or discusses creating a new climpt agent. Generates .agent/{name}/ directory with all required files including agent.json, steps_registry.json, schemas, and prompts." allowed-tools: [Read, Write, Edit, Bash, Glob, AskUserQuestion]

Agent Scaffolder

Climpt Agent の雛形を生成する Skill。

使用方法

1. 情報収集

ユーザーに以下を確認:

1. Agent 名 (必須): kebab-case (例: my-agent, code-reviewer)
2. 説明: Agent の目的
3. completionType: 完了条件の種類

completionType 選択肢

scaffolder がサポートするタイプ:

上級タイプ（scaffolding 後に手動編集が必要）:

上級タイプを使用する場合は、基本タイプで scaffold 後、 agent.json の behavior.completionType と completionConfig を手動で編集する。 詳細: agents/docs/builder/02_agent_definition.md

2. Scaffolding 実行

Copydeno run -A ${CLAUDE_PLUGIN_ROOT}/skills/agent-scaffolder/scripts/scaffold.ts \
  --name <agent-name> \
  --description "<説明>" \
  --completion-type <type>

3. 生成される構造

Copy.agent/{agent-name}/
├── agent.json              # Agent 定義
├── steps_registry.json     # Step マッピング
├── schemas/
│   └── step_outputs.schema.json
└── prompts/
    ├── system.md
    └── steps/
        ├── initial/default/f_default.md       # Work step: 初期化
        ├── continuation/default/f_default.md  # Work step: 継続
        ├── verification/default/f_default.md  # Verification step: 検証
        └── closure/default/f_default.md       # Closure step: 完了

4. 次のステップ案内

生成後、ユーザーに以下を案内:

1. prompts/system.md を編集して Agent の役割を定義
2. prompts/steps/ 配下の各プロンプトをカスタマイズ
3. 必要に応じて steps_registry.json に Step を追加
4. deno run -A agents/scripts/run-agent.ts --agent {name} --dry-run で検証

5. intentSchemaRef の形式

重要: structuredGate.intentSchemaRef は解決済み Step スキーマ内の 内部ポインタ (#/properties/...) を使用すること。Runner は outputSchemaRef.schema で Step スキーマを解決した後に intentSchemaRef を適用するため、 definitions を含むパスは動作しない。

Copy// ✅ 正しい形式: 解決済みスキーマへのポインタ
"intentSchemaRef": "#/properties/next_action/properties/action"

// ❌ 禁止: definitions を含むパス（解決後に存在しない）
"intentSchemaRef": "#/definitions/initial.default/properties/next_action/properties/action"

// ❌ 禁止: 外部ファイル参照
"intentSchemaRef": "common.schema.json#/$defs/nextAction/properties/action"

共通定義を使う場合は、Step スキーマ内で $ref で参照し、 intentSchemaRef は解決後のローカルポインタを指定する。

詳細ドキュメント

• agents/docs/builder/01_quickstart.md - クイックスタート
• agents/docs/builder/02_agent_definition.md - agent.json 詳細
• agents/docs/builder/03_builder_guide.md - ビルダーガイド
• agents/docs/builder/04_config_system.md - 設定システム