mcpField
H
hexabot-action-creator

hexabot-action-creator

github.com/hexabot-ai開発059 回インストール21 週間前に更新
リポジトリ

hexabot-action-creator について

hexabot-action-creator は、Hexabot v3 のアクションを設計、実装、レビューするスキルです。契約や構成を推測せず、対象プロジェクトとパッケージの API を先に確認します。

主な機能

  1. 01現在の Hexabot API と例の確認
  2. 02アクション実装パターンの選択
  3. 03入出力と設定の契約設計
  4. 04Zod スキーマとコンテキストサービスの利用
  5. 05ガイドとテストチェックリストの提供

活用シーン

  1. 01Hexabot プロジェクトでアクションを作成
  2. 02コーディング前にアクション契約を設計
  3. 03アクションのスキーマとエラー処理をレビュー
  4. 04バインディングとアクションテストを検証

インストール

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

$npx skills add https://github.com/hexabot-ai/action-creator --skill hexabot-action-creator

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

同梱ファイル

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

agents/
openai.yaml
examples/
create-crm-ticket.action.example.ts
references/
action-authoring-guide.md
action-contract-guide.md
output-templates.md
settings-and-secrets-guide.md
testing-and-review-checklist.md

詳細

hexabot-ai/action-creator

Hexabot v3 のアクション開発には、このスキルを使用してください。Hexabot のアクション API はプロジェクトごとに定義され、変更される場合があるため、最終的なコードを作成する前に、ユーザーが現在作業している Hexabot リポジトリ、カスタムアクションパッケージ、またはインストール済みパッケージの型を確認してください。

信頼できる情報源

最終的なアクションコードを作成する前、またはレビュー結果を提示する前に、関連する現在のプロジェクトファイルを確認してください。ワークスペースにこのパッケージ化されたスキルしかない場合は、同梱のリファレンスとサンプルを使用し、実行時の検証には Hexabot プロジェクトまたはアクションパッケージが必要であることを伝えてください。

ユーザーが Hexabot モノレポで作業している場合、通常は次のファイルが目印になります。

  • API アクションの範囲：packages/api/src/actions/**。
  • 組み込み API アクションのサンプル：packages/api/src/extensions/actions/**。
  • 実行時のバインディングシステム：packages/api/src/bindings/** および packages/api/src/extensions/actions/**/*.binding.ts 配下のアクションバインディングファイル。
  • ワークフローの実行時コンテキストとサービス：packages/api/src/workflow/contexts/**。
  • エージェント型アクションの基底クラス：packages/agentic/src/action/**、packages/agentic/src/dsl.types.ts、および packages/agentic/README.md。
  • 拡張機能の検出：packages/api/src/actions/actions.module.ts、packages/api/src/bindings/bindings.module.ts、および packages/api/README.md。

ユーザーが別の hexabot-action-* パッケージまたはアプリケーションリポジトリで作業している場合は、モノレポの packages/* パスが存在すると決めつけず、そのパッケージの package.json、ソースツリー、生成されたテンプレート、TypeScript のパスエイリアス、依存パッケージのエクスポートを確認してください。

現在のプロジェクトまたはインストール済みの Hexabot パッケージに存在しないデコレーター、スキーマフィールド、バインディング種別、登録フック、パッケージ構成、インポートパス、設定規約を作り出さないでください。

基本的なワークフロー

  1. 要求されているアクションの機能、変更内容、ワークフロー種別、対象の場所を特定します。対象は、Hexabot モノレポの API ソース、カスタムアプリケーションのアクション、hexabot-action-* という名前の npm パッケージ、または単体の @hexabot-ai/agentic の例です。
  2. 対象プロジェクトが利用できる場合、同じ形状を持つ近くのサンプルを確認します。対象には、Web/API、AI/LLM、メモリ、サブスクライバー、メッセージング、バインディング対応のアクションがあります。このスキルバンドルしか利用できない場合は、同梱のサンプルを参考例として使用し、実行時について未検証の前提を明示してください。
  3. 実装パターンを選択します。
    • カスタムのコンストラクター依存関係がない、Nest が検出するシンプルなアクションには、API の createAction を使用します。
    • コンストラクターで注入するサービス、継承、またはより高度な動作が必要な場合は、API の BaseAction を拡張します。
    • defineAction は、単体の @hexabot-ai/agentic 実行時の例にのみ使用し、Nest API の拡張アクションには使用しないでください。
  4. コードを書く前にコントラクトを設計します。アクション名、ワークフロー種別、入力スキーマ、出力スキーマ、設定スキーマ、対応するバインディング、冪等性、失敗時の動作、ログ記録、テストを決めます。
  5. Zod スキーマ、現在のコンテキストサービス、安全な認証情報の取り扱い、ワークフローから $output.<task> を通じて参照できる明示的な出力を使用し、範囲を絞って実装します。
  6. パース、設定、出力形式、エラー経路、冪等性、バインディングとの互換性を確認する、焦点を絞ったテストまたはレビュー項目を追加します。

同梱リソース

  • アクションコードの実装またはひな形作成の前に、references/action-authoring-guide.md を読んでください。
  • 入力／出力／設定スキーマまたは対応するバインディングを設計する場合は、references/action-contract-guide.md を読んでください。
  • 認証情報、設定、環境変数、LLM モデルのバインディング、外部 API 呼び出しについては、references/settings-and-secrets-guide.md を読んでください。
  • アクションをレビューする場合、または検証を計画する場合は、references/testing-and-review-checklist.md を読んでください。
  • 仕上げた設計、ひな形、レビュー、ドキュメントをユーザーが求めている場合は、references/output-templates.md を読んでください。
  • API の createAction パターンの参考例については、examples/create-crm-ticket.action.example.ts を参照してください。

出力のデフォルト

  • 実装タスクでは、対象の Hexabot リポジトリまたはアクションパッケージが利用可能で、ユーザーが実装を依頼している場合は、コードを変更します。
  • 設計のみのタスクでは、意思決定に必要な情報を網羅したアクション契約を提示し、不明なリポジトリ情報やランタイムの前提条件があれば明記します。
  • レビューでは、重要度の高い順に指摘事項を示し、ファイルまたはアクション契約のフィールドを引用します。
  • ワークフローのみの依頼では、アクションコードまたはアクション契約が必要な場合を除き、Hexabot ワークフロースキルを使用します。
  • ユーザーがローカライズ作業を明示的に依頼しない限り、フランス語の fr.translations.json を含め、追加のロケールファイルや翻訳を作成・更新しないでください。

コメント

Markdown 対応