mcpField
C
create-tooluniverse-skill

create-tooluniverse-skill

github.com/mims-harvardエージェントワークフロー1.8k411 回インストール2 日前に更新
リポジトリ

create-tooluniverse-skill について

create-tooluniverse-skillは、ToolUniverseのメンテナー向けに、分析、実装、テスト、文書作成、パッケージ化を段階的に進めるスキルです。実装や文書を書く前にツールを検証する手順を重視します。

主な機能

  1. 017段階のスキル作成ワークフロー
  2. 02ツールの発見と事前テスト
  3. 03実装・テスト用テンプレート
  4. 04成果物の検証とパッケージ化

活用シーン

  1. 01ToolUniverseの新しい領域向けスキルを作成
  2. 02スキル実装にツールテストを追加
  3. 03チェックリストでスキルを検証・梱包

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mims-harvard/tooluniverse --skill create-tooluniverse-skill

インストール後、Claude Code で/create-tooluniverse-skillを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CODE_TEMPLATES.md
OPTIMIZE_INTEGRATION.md
PACKAGING_TEMPLATE.md
PARAMETER_VERIFICATION.md
QUICKSTART_TEMPLATE.md
SKILL_TEMPLATE.md
test_tools_template.py
TESTING_GUIDE.md
VALIDATION_CHECKLIST.md
assets/skill_template/
python_implementation.py
QUICK_START.md
test_skill.py
references/
devtu_optimize_integration.md
implementation_agnostic_format.md
skill_standards_checklist.md
tool_testing_workflow.md
scripts/
test_tools_template.py

詳細

ToolUniverse スキルの作成

本番環境で使える ToolUniverse スキルを作成するための体系的なワークフローです。

このスキルから引き継ぐ devtu-* スキルは、現在このリポジトリにはありません。 devtu-optimize-skills、devtu-create-tool、devtu-fix-tool は、ユーザーが呼び出すものではなくこのリポジトリ自体に対して動作するため、tu-harness プラグイン（tooluniverse/tooluniverse-harness）に移動しました。 claude plugin install tu-harness@tooluniverse-harness でインストールしてください。以下ではスキル名で参照しているため、このプラグインをインストールすると参照が解決されます。このスキルもメンテナー向けであり、ユーザー向けプラグインミラーには含まれていません。これらのスキルと一緒にあるべきものですが、移動を迫られる事情がなかったため、まだ移動していません。

基本原則

devtu-optimize-skills の10の柱に基づいて構築します。

  1. まずテストする — テストしていないツールは決して文書化しないでください
  2. ツールの契約を確認する — 関数名を鵜呑みにしないでください
  3. SOAP ツールに対応する — operation パラメーターを追加します
  4. 実装に依存しないドキュメント — SKILL.md に Python/MCP コードを記載しないでください
  5. 基盤を優先する — 特化型ツールより先にアグリゲーターを照会します
  6. 慎重に曖昧さを解消する — ID を適切に特定します
  7. フォールバックを実装する — Primary -> Fallback -> Default
  8. 根拠を評価する — 主張に T1-T4 の段階を付けます
  9. 完全性を定量化する — セクションごとに数値の最低基準を設けます
  10. 統合する — リストだけでなく、モデルと仮説を提示します

各原則の詳しい適用方法については、OPTIMIZE_INTEGRATION.md を参照してください。

7段階のワークフロー

フェーズ所要時間説明
1. ドメイン分析15分ユースケース、データ型、分析フェーズを把握します
2. ツールの発見30-45分検索、設定の確認、ツールのテストを行います（必須）
3. ツールの作成0-60分必要に応じて devtu-create-tool で不足しているツールを作成します
4. 実装30-45分テスト済みのツールを使って python_implementation.py を作成します
5. ドキュメント作成30-45分SKILL.md（実装に依存しないもの）と QUICK_START.md を作成します
6. 検証15-30分テストスイートを実行し、チェックリストを確認して、手動で検証します
7. パッケージ化15分概要を作成し、トラッキング情報を更新します

合計：約1.5～2時間（ツール作成を除く）。

フェーズ1：ドメイン分析
  • 具体的なユースケースと期待される出力を収集します
  • 入力、出力、中間データの型を特定します
  • ワークフローを論理的なフェーズに分割します
  • skills/ 内の既存スキルを確認し、パターンを把握します
フェーズ2：ツールの発見とテスト

/src/tooluniverse/data/*.json（186個のツールファイル）からツールを検索します。各ツールについて、設定を読み、パラメーターと戻り値のスキーマを把握します。よくある落とし穴については、PARAMETER_VERIFICATION.md を参照してください。

test_tools_template.py を使ってテストスクリプトを作成し、実行します。各ツールについて、妥当なパラメーターで呼び出し、応答形式を確認し、修正点を記録します。テストスイートのテンプレートと手順の詳細については、TESTING_GUIDE.md を参照してください。

フェーズ3：ツールの作成（必要な場合）

必要な機能が不足していて分析が妨げられる場合は、devtu-create-tool を呼び出します。新しいツールがテストに失敗する場合は、devtu-fix-tool を使用します。

フェーズ4：実装

skills/tooluniverse-[domain]/ を作成し、次のファイルを配置します。

  • python_implementation.py — テスト済みのツールのみを使用し、フェーズごとに try/except を実装して、レポートを段階的に作成します
  • test_skill.py — 各入力型、複数入力の組み合わせ、エラー処理をテストします

CODE_TEMPLATES.md のテンプレートを使用します。

フェーズ5：ドキュメント作成

SKILL_TEMPLATE.md を使って、実装に依存しない SKILL.md を作成します。QUICKSTART_TEMPLATE.md を使って、複数の実装方法に対応した QUICK_START.md を作成します。主なルール：SKILL.md に Python/MCP コードを一切含めないこと、QUICK_START では両方のインターフェースを同等に扱うこと。

例を含む書式ガイドラインについては、IMPLEMENTATION_AGNOSTIC.md を参照してください。

フェーズ6：検証

包括的なテストスイートを実行します（TESTING_GUIDE.md を参照）。VALIDATION_CHECKLIST.md に照らして検証します。手動検証を行います。ToolUniverse を新規に読み込み、QUICK_START の例をコピーして貼り付け、出力が正しく動作することを確認します。

フェーズ 7：パッケージ化

PACKAGING_TEMPLATE.md を使用して概要ドキュメントを作成します。複数のスキルを作成する場合は、セッションの追跡情報を更新します。

スキルの統合

スキル使用するタイミング
devtu-create-tool重要な機能が不足している場合
devtu-fix-toolツールがエラーや予期しない形式を返す場合
devtu-optimize-skillsエビデンスの評価、レポートの最適化

品質指標

高品質：ドキュメント作成前にテストカバレッジが 100％、実装に依存しない SKILL.md、複数の実装に対応した QUICK_START、フォールバック戦略、パラメーター修正表、レスポンス形式のドキュメント。

危険信号：テスト前のドキュメント作成、SKILL.md 内の Python、パラメーターの決めつけ、フォールバックなし、operation がない SOAP ツール、テストスクリプトなし。

参照ファイル

ファイル内容
SKILL_TEMPLATE.mdSKILL.md 作成用テンプレート
QUICKSTART_TEMPLATE.mdQUICK_START.md 作成用テンプレート
TESTING_GUIDE.mdテストスイートのテンプレートと手順
VALIDATION_CHECKLIST.mdリリース前の品質チェックリスト
PACKAGING_TEMPLATE.md概要ドキュメントのテンプレート
PARAMETER_VERIFICATION.mdツールのパラメーター検証ガイド
OPTIMIZE_INTEGRATION.mddevtu-optimize-skills の 10 ピラー統合
IMPLEMENTATION_AGNOSTIC.md実装に依存しない形式のガイドと例
CODE_TEMPLATES.mdPython の実装およびテスト用テンプレート
test_tools_template.pyツールテストスクリプトのテンプレート

コメント

Markdown 対応