# Agent Scaffolder

> 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.

- Skill: `tomevault-io/agent-scaffolder` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/agent-scaffolder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/agent-scaffolder/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/agent-scaffolder

---


# Agent Scaffolder

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

## 使用方法

### 1. 情報収集

ユーザーに以下を確認:

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

### runner.verdict.type 選択肢

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

| タイプ            | 用途                | 設定                  |
| ----------------- | ------------------- | --------------------- |
| `poll:state`      | Issue/PR の状態監視 | `maxIterations`       |
| `count:iteration` | 固定回数で終了      | `maxIterations`       |
| `detect:keyword`  | キーワードで終了    | `verdictKeyword`      |
| `detect:graph`    | Step グラフで判定   | `steps_registry.json` |

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

| タイプ              | 用途                             |
| ------------------- | -------------------------------- |
| `count:check`       | Status check の回数で終了        |
| `detect:structured` | JSON schema で完了宣言を受け取る |
| `meta:composite`    | 複数条件 (any/all) の合成        |
| `meta:custom`       | 外部 VerdictHandler で任意判定   |

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

### 2. Scaffolding 実行

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

### 3. 生成される構造

```
.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` を含むパスは動作しない。

```json
// ✅ 正しい形式: 解決済みスキーマへのポインタ
"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` - 設定システム

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/tettuan) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->