mcpField
N
nocobase-utils

nocobase-utils

github.com/nocobase開発55288 回インストール8 週間前に更新
リポジトリ

nocobase-utils について

nocobase-utilsは、NocoBaseの複数機能で使われるユーティリティの参照情報を提供するエージェントスキルです。フィルター作成、式の評価、UID生成などを扱い、フィールド型に応じた演算子選択を案内します。

主な機能

  1. 01トピック別のユーティリティ資料
  2. 02フィルター形式と演算子の案内
  3. 03式エンジンと関数の説明
  4. 04UID生成スクリプトの同梱

活用シーン

  1. 01NocoBaseのフィールド向けフィルター作成
  2. 02式エンジンと関数の確認
  3. 03UIスキーマ用の短いUID生成

インストール

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

$npx skills add https://github.com/nocobase/skills --skill nocobase-utils

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

同梱ファイル

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

references/evaluators/
formulajs.md
index.md
mathjs.md
references/filter/
index.md
references/uid/
index.md
scripts/
uid.js

詳細

目標

NocoBase の横断的なユーティリティに関する、正確で信頼できるリファレンス情報を提供します。内容はトピック別に整理されており、今後も追加されます。

使用するタイミング

複数の NocoBase 機能に適用される信頼できるリファレンス情報が必要な場合は、このスキル（またはそのサブリファレンス）を呼び出してください。たとえば、次のような場合です。

  • 保存可能または UI に表示可能な NocoBase のフィルター条件を作成するとき。特に、自然言語の意図から演算子を選ぶ場合
  • 式評価エンジンと使用可能な関数を確認するとき
  • UI スキーマやその他の設定ペイロード向けに、短い不透明な UID を生成するとき
  • その他の共有ユーティリティを利用するとき（今後追加予定）

フィルターを作成する場合は、トピック filter を指定してこのスキルを呼び出してください。Filter リファレンスを読むことは必須であり、任意の参考情報ではありません。演算子を出力する前に、末端フィールドの実際のインターフェース／型を特定し、そのフィールドグループの許可リストから演算子を選んでください。「前」「より小さい」「以上」「後でない」などの語を、モデルの知識に基づいて汎用比較演算子に直接置き換えないでください。

同梱スクリプト

  • UI またはスキーマのペイロードに短いランダム UID が必要で、既存のプロジェクトヘルパーを使用していない場合は、scripts/uid.js を再利用してください。
  • このスクリプトは、対象コードに uid() をインポートする方法と、現在のワークスペースでスクリプトのパスを解決し、エージェント作業中に node <resolved-path-to-uid.js> 16 を実行して UID を出力する方法の両方をサポートしています。

リファレンス一覧

トピックファイル
フィルター条件の形式 — 構造、演算子、変数references/filter/index.md
評価エンジン — 概要、エンジンの選択、重要なルールreferences/evaluators/index.md
formula.js 関数の完全なリファレンスreferences/evaluators/formulajs.md
math.js 関数の完全なリファレンスreferences/evaluators/mathjs.md
UID の生成 — 使用するタイミング、ガードレール、使用例references/uid/index.md

コメント

Markdown 対応