スキル tool-design
📦

tool-design

コンテンツリビジョン r2 安全 ⚡ スクリプトを含む⚙️ 外部コマンド🌐 ネットワークアクセス

モデルが確実に使用できるエージェントツールを設計する

エージェントツールは、説明、スキーマ、エラーメッセージが曖昧だと失敗します。このスキルは、より明確なツールAPI、より安全な統合、より良いテストのための実践的なパターンを提供します。

対応: Claude Codex Code(CC)
🥈 80 シルバー

自分のエージェントでインストール

このリクエストをエージェントにコピーしてください。正規の Skill ページとマニフェストが含まれています。

エージェントリクエスト
Review the Skillstore skill "tool-design" from https://skillstore.io/skills/muratcankoylan-tool-design.md and its manifest at https://skillstore.io/api/skills/muratcankoylan-tool-design/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

エージェントは引き続き計画を提示し、セキュリティポリシーで必要な確認を求める必要があります。

エージェントが読めるリソース

AI エージェント、クローラー、スクリプトがページ全体ではなく整理されたコンテキストを必要とする場合は、これらのリンクを使ってください。

Markdown詳細 GET /skills/muratcankoylan-tool-design.md 署名済み manifest GET /api/skills/muratcankoylan-tool-design/manifest 署名済み lockfile GET /api/skills/muratcankoylan-tool-design/lockfile

テストする

「tool-design」を使用しています。 サポートエージェントには、顧客検索、注文一覧表示、返金実行のための個別ツールがあります。

期待される結果:

  • 顧客検索と注文検索が1つのサポートワークフローに役立つ場合は統合します。
  • 返金承認はアカウント状態を変更するため、分離したままにします。
  • 検索結果から返金レビューへの引き継ぎを文書化します。

「tool-design」を使用しています。 データベース検索ツールが大きなレコードと汎用的なエラーを返します。

期待される結果:

  • 異なるタスク要件に対応するため、簡潔モードと詳細モードのレスポンスを追加します。
  • 汎用的な失敗を、具体的な原因と再試行ガイダンスに置き換えます。
  • 有効な識別子と期待される結果の例を含めます。

「tool-design」を使用しています。 MCP連携で、サーバー間のツール名が曖昧です。

期待される結果:

  • プロンプトとドキュメントでは、サーバースコープ付きの名前を使用します。
  • 関連ツールを明確な名前空間の下にグループ化します。
  • 各ワークフローで意図されたツールを示す例を追加します。

セキュリティ監査

安全
v8 • 2026/8/9 バージョン別レポートを開く

All 49 static findings are false positives from documentation markup, ordinary prose, or sandboxed command examples. The Python utility performs no network or process execution.

4
スキャンされたファイル
1,214
解析済み行数
0
レビュー項目
0
誤検知を無視

リスク要因

⚡ スクリプトを含む (2)
references/architectural_reduction.md:48 references/architectural_reduction.md:124
⚙️ 外部コマンド (35)
references/architectural_reduction.md:48 references/architectural_reduction.md:124 scripts/description_generator.py:11 scripts/description_generator.py:12 scripts/description_generator.py:13 scripts/description_generator.py:14 scripts/description_generator.py:52 scripts/description_generator.py:433 scripts/description_generator.py:435 scripts/description_generator.py:436 scripts/description_generator.py:437 SKILL.md:10 SKILL.md:25 SKILL.md:26 SKILL.md:27 SKILL.md:46 SKILL.md:51 SKILL.md:97 SKILL.md:107 SKILL.md:109-116 SKILL.md:116-126 SKILL.md:126-154 SKILL.md:154-189 SKILL.md:189-210 SKILL.md:210-216 SKILL.md:216-220 SKILL.md:220-254 SKILL.md:254 SKILL.md:256 SKILL.md:257 SKILL.md:260-267 SKILL.md:267-268 SKILL.md:268-269 SKILL.md:269-270 SKILL.md:270-271
🌐 ネットワークアクセス (3)
references/best_practices.md:7 SKILL.md:40 SKILL.md:93
最新の完了済み静的・セマンティック監査では、確認済みのセキュリティ検出事項は見つかりませんでした。これは、スキルに副作用がないことを証明するものではありません。
監査者: codex 監査履歴を表示 →
このレポートを共有・引用

バージョン付き評価レポート、中立的なバッジ、埋め込みカード、引用を共有できます。Skillstore は証拠を報告しますが、この Skill が安全かどうかは判断しません。

バージョン別レポートを開く
セキュリティ評価

レポートリンクをコピー

https://skillstore.io/skills/muratcankoylan-tool-design/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdownバッジ

[![Skillstore security assessment](https://skillstore.io/badges/skills/muratcankoylan-tool-design/security.svg)](https://skillstore.io/skills/muratcankoylan-tool-design?utm_source=security_passport_badge)

HTMLバッジ

<a href="https://skillstore.io/skills/muratcankoylan-tool-design?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/muratcankoylan-tool-design/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

埋め込みカード

<iframe src="https://skillstore.io/embed/skills/muratcankoylan-tool-design.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
学術引用 (APA · BibTeX · CFF)

APA形式の引用

muratcankoylan. (2026). tool-design security audit report (audit version 8) [Author version unspecified]. Skillstore. https://skillstore.io/skills/muratcankoylan-tool-design/audits/8

BibTeX形式の引用

@techreport{muratcankoylan-muratcankoylan-tool-design-2026, author = {muratcankoylan}, title = {tool-design security audit report (audit version 8)}, institution = {Skillstore}, year = {2026}, number = {8}, url = {https://skillstore.io/skills/muratcankoylan-tool-design/audits/8}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "tool-design security audit report (audit version 8)" version: "unspecified" type: report authors: - name: "muratcankoylan" date-released: "2026-08-09" url: "https://skillstore.io/skills/muratcankoylan-tool-design/audits/8" identifiers: - type: other value: "skillstore:muratcankoylan-tool-design:audit:8" description: "Skillstore immutable audit report identifier"

バリアントを比較

インストール可能なバリアント 4 件

各作者のスキルは個別のインストール項目として維持されます。推奨バリアントは Skillstore の証拠で順位付けされます。

このバリアントが首位の理由

Skillstore スコアが最高
Asmayaseen 推奨

asmayaseen-tool-design

Skillstore スコア 81
証拠の信頼度 高
Skillstore 利用状況 23
更新済み

2026-09-09

ChakshuGautam

chakshugautam-tool-design

Skillstore スコア 80
証拠の信頼度 高
Skillstore 利用状況 16
更新済み

2026-09-09

muratcankoylan 現在

muratcankoylan-tool-design

Skillstore スコア 80
証拠の信頼度 高
Skillstore 利用状況 15
更新済み

2026-09-09

sickn33

sickn33-tool-design

Skillstore スコア 78
証拠の信頼度 高
Skillstore 利用状況 68
更新済み

2026-09-09

Skillstore スコア

このスコアの理由 証拠の信頼度: 高
64
アーキテクチャ
85
保守性
87
コンテンツ
70
コミュニティ
83
仕様準拠

作成できるもの

エージェントツールAPIを標準化する

共有ツールカタログの命名、パラメータ、レスポンス規約を定義します。

ツール選択の混乱を減らす

重複するツールを特定し、選択エラーの原因となるワークフローを統合します。

ツール失敗時の回復を改善する

エージェントが何に失敗し、どのように再試行すればよいか分かるようにエラーを書き換えます。

これらのプロンプトを試す

1つのツール説明を監査する 
このツール説明について、明確性、不足している入力、戻り値、エラーガイダンスをレビューしてください。簡潔な改善案を提案してください: [paste tool description].
ツール契約を作成する 
このワークフローのツール契約を設計してください。名前、使用するタイミング、パラメータ、戻り値の形、回復可能なエラーを含めてください: [describe workflow].
ツールセットを統合する 
これらのツールについて、重複と選択の曖昧さを分析してください。どのツールをマージするか、分離したままにするか、名前空間化するかを推奨してください: [paste tool list].
ツールシステムを設計してテストする 
このエージェントシステムのツール設計計画を作成してください。ツール境界、MCP命名、レスポンス形式、エラー回復、テストケース、デプロイリスクを含めてください: [describe system].

ベストプラクティス

  • ツールが何をするか、いつ使うか、期待される入力、返されるデータ、回復可能なエラーを文書化します。
  • 1つの明確なワークフローを支援し、重要な安全境界を隠さない場合にのみツールを統合します。
  • 代表的なエージェントリクエストで説明をテストし、観察された失敗モードに基づいて修正します。

回避

  • 曖昧な名前や説明を使い、エージェントにツールの目的を推測させること。
  • ツール数を減らすことだけを目的に、無関係なツールをマージすること。
  • 簡潔な形式でタスクに答えられる場合でも、デフォルトで冗長なデータを返すこと。

よくある質問

このスキルは誰が使うべきですか？
エージェント向けツールを設計する開発者、プラットフォームチーム、AIプロダクトチームが使用できます。
ツールを自動的に構築しますか？
いいえ。開発者が適応できる設計ガイダンスとサンプルのヘルパーパターンを提供します。
MCPツールをサポートしていますか？
はい。Model Context Protocol連携のための名前空間と完全修飾ツール名について説明します。
ツールの乱立を減らせますか？
はい。重複するツールとワークフローに対する統合基準を提供します。
本番環境では何に注意すべきですか？
コマンド実行とファイルアクセスのパターンは、サンドボックス化、ログ記録、ポリシー制御を必要とする特権的な機能として扱ってください。
Claude、Codex、Claude Codeで使用できますか？
はい。このスキルの内容は、Claude、Codex、Claude Codeのワークフロー向けの一般的なガイダンスです。

開発者情報

作成者

muratcankoylan

ライセンス

MIT

Skillstore リビジョン

r2

バージョンに関する注意

作者はバージョンを宣言していません。

リポジトリ

https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/tool-design

参照

02be9409c79ca1183f7844009c14d9df684d0cf9

メンテナンスの新しさ

2026/8/11

利用状況

13 ダウンロード · 229 閲覧

ファイル構成

📁 references/

📄 architectural_reduction.md

📄 best_practices.md

📁 scripts/

📄 description_generator.py

📄 SKILL.md