tomevault-io Agent Scaffolder
Climpt Agent の雛形を生成する Skill。
使用方法
1. 情報収集
ユーザーに以下を確認:
- Agent 名 (必須): kebab-case (例:
my-agent,code-reviewer) - 説明: Agent の目的
- 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 実行
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. 次のステップ案内
生成後、ユーザーに以下を案内:
prompts/system.mdを編集して Agent の役割を定義prompts/steps/配下の各プロンプトをカスタマイズ- 必要に応じて
steps_registry.jsonに Step を追加 deno run -A agents/scripts/run-agent.ts --agent {name} --dry-runで検証
5. intentSchemaRef の形式
重要: structuredGate.intentSchemaRef は解決済み Step スキーマ内の
内部ポインタ (#/properties/...) を使用すること。Runner は
outputSchemaRef.schema で Step スキーマを解決した後に intentSchemaRef
を適用するため、 definitions を含むパスは動作しない。
// ✅ 正しい形式: 解決済みスキーマへのポインタ
"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 — claim your Tome and manage your conversions.