create-tool

Files (1)

• SKILL.md

SKILL.md (first lines)

# 目的

agentcli に新規ツールを追加する一連の工程を自動実行する。
手作業で抜けがちな **i18n翻訳（本体の全対応言語）・コード整形・構文チェック** まで含めて完了する。

# 入力（このスキルがユーザーに確認すること）

ユーザーに以下を質問し、全て揃ったら実行を開始する。

1. **ツール名**: 英小文字+アンダースコア（例: `pdf_ocr`）
1. **英語説明**: `tool.description` に使う1行（簡潔に）
1. **引数定義**: 各引数の name / type / required / description（英、簡潔に）
1. **実装概要**: `run_tool()` の処理内容
1. **x_search_terms（英）**: 検索ワード配列（省略可）

## 質問テンプレート

```
これから新規ツールを作成します。以下を教えてください：
1. ツール名（例: pdf_ocr）
2. 英語の説明（簡潔に）
3. 引数（JSON形式、説明は簡潔に）
4. 実装の概要（何をするツールか）
5. x_search_terms（省略可）
```

注: 日本語を含む全ロケールの翻訳は `translate_text` で自動生成する。

# LLM が自動判断する項目（ユーザーには聞かない）

以下の項目はユーザー入力ではなく、LLMがツールの実装内容から判断して設定する。

| 項目 | 判断基準 |
|------|---------|
| `tool_genre` | ツールの機能から判断。ファイル操作→`file`、API呼出→`external`、デバイス制御→`iot`、開発補助→`devel`、汎用→`basic` |
| `BUSY_LABEL` | 時間のかかる処理なら `True`、即時返却なら `False` |
| `STATUS_LABEL` | 任意。表示用ラベル文字列、なければ None |
| `LAZY_LOAD` | 重いimport（PIL/numpy等）が必要な場合のみ `True` |
| `tool_level` | 基本的に省略（=0）。システム内部用なら `-1`（隠し） |
| `x_parallel_safe` | 副作用なし並列実行安全なら `True`、状態変更するなら `False` |
| `additionalProperties` | 基本的に `False` |

# 環境

- Python 実行環境（`python_exec` ツール）
- 既存ツール: `translate_text` / `lint_format` / `python_compile` / `create_file`
- `src/uagent/tools/` が書き込み可能

# 実行フロー（この順序で固定）

## Step 0: 重複チェック

- `search_files(glob="<name>_tool.*", path="src/uagent/tools")` で既存ツールと重複しないか確認
- 重複あればスキル中断しユーザーに報告

## Step 1: Python ファイル生成

`create_file` で `src/uagent/tools/<name>_tool.py` を生成する。

### テンプレート

```python
from __future__ import annotations

# src/uagent/tools/<name>_tool.py

from .i18n_helper import make_tool_translator

_ = make_tool_translator(__file__)

from typing import Any

BUSY_LABEL = False  # LLM判断
STATUS_LABEL = None

TOOL_SPEC: dict[str, Any] = {
    "type": "function",
    "tool_genre": "<genre>",  # LLM判断
    "x_parallel_safe": False,
    "function": {
        "name": "<name>",
        "description": _(
            "tool.description",
            default="<english description>",
        ),
        "x_search_terms": _(
            "x_search_terms",
            default=[<x_search_terms_english_array>],
        ),
        "x_search_terms_en": [<x_search_terms_english_array>],
        "parameters": {
            "type": "object",
            "properties": {
                <param_name>: {
                    "type": "<type>",
                    "description": _(
                        "param.<param_name>.description",
                        default="<english description>",
                    ),
                }
            },
            "required": [<required_param_names>],
            "additionalProperties": False,
        },
    },
}

def run_tool(args: dict[str, Any]) -> str:
    <implementation>
```

### ルール

- `_("key", default="...")` で全ユーザー向け文字列をラップ
- key は `tool.description`, `param.<name>.description` の命名規則
- `x_search_terms` は `_("x_search_terms", default=[...])`（i18n経由で現在ロケールの配列を読む）
- `x_search_terms_en` は英語配列を直書き（英語検索用の fallback、i18n を通さない）
- `run_tool()` は必ず `str` を返す
- エラーハンドリングを含める

From awaku7/agentcli, Apache-2.0.

More from awaku7/agentcli