notis-automation

Notis Automation Skill

ユーザーが「後で」「スケジュールに従って」、または「イベントに応じて」何かを実行したい場合は、常にこのスキルを使用してください。Notis の 3 つの構成要素と、それらの連携方法を説明します。

• スキルにはビジネスロジック、つまり再利用可能な「何をするか」が含まれます。
• オートメーションは接着剤です。トリガーをビジネスロジックにつなぎます。また、Notis に後で何かを実行させる方法でもあります。
• リマインダーは単純です。固定メッセージを、指定した時刻またはスケジュールに従って送信します。推論も、ツールも、計算された内容もありません。

このスキルで最も重要なのは、適切なプリミティブを選ぶこと、そしてそれに有効なペイロードを作成することです。

ツール名

これらは Notis のネイティブツールです。現在のツールセットで正式な LOCAL_NOTIS_* 名を使用できる場合は、それらを直接呼び出してください。すでに利用可能なネイティブのオートメーションまたはリマインダーツールを COMPOSIO_SEARCH_TOOLS 経由で送信したり、COMPOSIO_MULTI_EXECUTE_TOOL でラップしたりしないでください。ツールの検索は、まだ読み込まれていない機能に限って行います。ネイティブツールは、必ず正式名称で呼び出してください。

領域	正式なツール
リマインダー	LOCAL_NOTIS_INSERT_REMINDER、LOCAL_NOTIS_UPDATE_REMINDER、LOCAL_NOTIS_LIST_REMINDERS、LOCAL_NOTIS_DELETE_REMINDER
オートメーション	LOCAL_NOTIS_INSERT_AUTOMATION、LOCAL_NOTIS_UPDATE_AUTOMATION、LOCAL_NOTIS_LIST_AUTOMATIONS、LOCAL_NOTIS_GET_AUTOMATION、LOCAL_NOTIS_RUN_AUTOMATION、LOCAL_NOTIS_LIST_AUTOMATION_RUNS、LOCAL_NOTIS_GET_AUTOMATION_RUN、LOCAL_NOTIS_DELETE_AUTOMATION、LOCAL_NOTIS_LIST_INTEGRATION_TRIGGERS
スキル	LOCAL_NOTIS_CREATE_SKILL、LOCAL_NOTIS_LIST_SKILLS、LOCAL_NOTIS_UPDATE_SKILL、LOCAL_NOTIS_INSTALL_SKILL、LOCAL_NOTIS_DISABLE_SKILL、LOCAL_NOTIS_DELETE_SKILL
データベース（database トリガー用）	LOCAL_NOTIS_DATABASE_LIST_DATABASES、LOCAL_NOTIS_DATABASE_GET_DATABASE

基本的な考え方

trigger  ->  automation  ->  business logic (often a skill)
time     ->  reminder     ->  static message

• トリガーとは、処理を開始するものすべてです。時計（cron）、将来の時点（一度限り）、受信 HTTP 呼び出し（webhook）、外部インテグレーションのイベント（新しいメール、新しいカレンダーイベント）、Notis データベースレコードの変更などがあります。
• オートメーションは、トリガーを prompt に結び付けます。Notis エージェントはこの prompt を実行します（エージェントのターン全体）。prompt は接着剤であり、長い手順を詰め込む場所ではありません。
• スキルには、実際の再利用可能な手順を記述します。作業が単純ではない場合や、再利用する場合は、手順をスキルに記述し、オートメーションの prompt からそのスキルを参照してください（/skill-name）。オートメーションの prompt は簡潔にし、ロジックはスキルに記述してください。
• リマインダーは、計算することが文字どおり何もない場合に使用します。ユーザーが固定テキストで通知してほしいだけの場合に適しています。

適切なプリミティブを選ぶ

ユーザーの要望	使用するもの	理由
決まった内容の通知を指定時刻またはスケジュールに従って受け取りたい（「午後5時に歯医者へ電話するようリマインドして」）	リマインダー	推論は不要です。指定されたテキストをそのまま届けるだけです
スケジュール、イベント、またはWebhookをきっかけに処理を実行したい（「毎週月曜日に先週の商談を要約する」「新しいGmailが届いたら返信する」）	オートメーション	トリガーによってビジネスロジックを実行する必要があります
将来、1回限りのタスクを実行したい（「2時間後に要約を作成する」）	trigger_type: "one_time" を指定したオートメーション	作業を伴う「後で何かをする」処理は、やはりオートメーションです
計算を伴わない、固定テキストの将来のメッセージがほしい（「今夜午後6時に『空港へ出発する』とメッセージを送って」）	trigger_type: "one_time" を指定したリマインダー	将来のものですが、静的なメッセージにすぎません
複数のトリガーやスレッドで手順を再利用したい	オートメーションから参照するスキル	ビジネスロジックはスキルに記述します

判断の目安：

• エージェントに考えさせる、データベースの読み書きをさせる、ツールを呼び出させる、何かを取得させる、または計算したテキストを作成させる必要がある場合は、リマインダーではなく、必ずオートメーションを使います。
• 「将来」というだけでリマインダーになるわけではありません。作業を伴う将来のタスクは1回限りのオートメーション、固定メッセージは1回限りのリマインダーです。
• オートメーションのpromptに長い手順を書き始めたら、いったん止めてスキルに移し、プロンプトからそのスキルを参照してください。

何かを作成する前に、重複を作らないよう、既存の項目を一覧表示し（LOCAL_NOTIS_LIST_REMINDERS、LOCAL_NOTIS_LIST_AUTOMATIONS）、トリガーとアクションを平易な言葉でユーザーに確認してください。

---

オートメーションのプロンプトを書く際の2つのルール

次の2つの間違いはオートメーションを壊します。必ず守ってください。

1. プロンプトに配信先を書かない

オートメーションの応答の送信先はchannel（およびchannel_account_id）フィールドで設定します。プロンプトではありません。オートメーションの出力は、そのチャネルに自動的に配信されます。

• プロンプトに「WhatsAppで自分に送って」「Slackに要約を投稿して」「結果をメールで送って」「このスレッドに返信して」などと書かないでください。
• プロンプトには実行する作業と生成する出力だけを記述します。配信先は別途設定します。

Bad  prompt:  "Summarize yesterday's sales and post it to my Slack."
Good prompt:  "Summarize yesterday's sales."     (with channel: "slack")

2. プロンプトにスケジュールや繰り返しの表現を書かない

スケジュールはトリガー（cron式／1回限りのタイムスタンプ）に設定します。プロンプトは、トリガーが作動するたびに1回実行されます。プロンプトに「毎朝」「毎週月曜日」「毎日」「これを実行するように設定して…」などと書くと、エージェントがそれを別のオートメーションを作成する指示と解釈し、作業を実行する代わりに再帰ループが発生する可能性があります。

• 今すぐ実行するアクションを、現在形で1つだけ記述してください。
• 時刻や頻度はすべてトリガーに設定してください。

Bad  prompt:  "Every morning, send me a digest of new emails."
Good prompt:  "Compile a digest of emails received since yesterday."   (with cron: "0 8 * * *")

---

運用ルール

• ユーザーには平易な言葉で伝えます。 「リマインダー」「週次の自動化」「Slack チャンネル」「Tasks データベース」のように伝えます。ツール名、trigger_type の値、生の JSON は使いません。ペイロードは内部で作成し、検証します。
• 配信先はチャンネルで指定し、プロンプトでは指定しません。 出力先は channel／channel_account_id で設定します。「…に送信」「…に投稿」「メールで送って」「スレッドで返信」といった表現を、自動化の prompt に含めないでください。
• プロンプトに繰り返しの表現を含めません。 スケジュールはトリガーで指定します。「毎朝」や「毎日…を設定して」とプロンプトに書くと、エージェントが作業を実行する代わりに、別の自動化を作成してしまうおそれがあります。プロンプトは、現在形の行動を1つだけ記述します。
• ユーザーに尋ねる前に調べます。 ユーザーに尋ねる前に、選択肢から選ぶ値を自分で特定します。対象は、チャンネルアカウント（複数ある場合）、連携ツールキット／トリガー／接続済みアカウント（LOCAL_NOTIS_LIST_INTEGRATION_TRIGGERS）、データベース ID とプロパティ ID（LOCAL_NOTIS_DATABASE_LIST_DATABASES／LOCAL_NOTIS_DATABASE_GET_DATABASE）です。一致するものが1つなら確認し、複数なら選択肢を提示し、なければ尋ねるか、いったん保留します。
• 識別子を決して推測しません。 連携プロバイダー、triggerName、connectedAccountId、database_id、property_id は、記憶ではなく調査結果に基づいて指定します。
• スケジュールを確定します。 スケジュールトリガーには具体的な cron 式が必要です。1回限りのトリガーには、タイムゾーン付きの実際の未来の日時が必要です。実行時期が未確定のまま、スケジュール項目を作成しないでください。
• 重複を避けます。 まず既存のリマインダー／自動化を一覧表示し、ほぼ同じものを追加するのではなく、重複を削除します。
• 確認してから作成します。 トリガーとアクションを、平易な言葉で短く1行にまとめて確認を取り、承認後に作成します。その後、ポータル URL（および存在する場合は webhook URL）を提示します。
• 適切な仕組みを選びます。 固定メッセージ → リマインダー。トリガーに応じて作業する → 自動化。再利用可能なロジック → 自動化から参照するスキル。1回限りのリマインダーと1回限りの自動化で迷った場合は、将来のアクションが固定文面なのか、実際の作業なのかを確認します。

自動化の場合は、automation-common と該当するトリガーガイドを1つ読みます。固定メッセージの場合は、reminders だけを読みます。再利用可能な手順には、skill-business-logic を使用します。

タスクガイド

このタスクに必要なガイドだけを読みます。相対リンクはスキルバンドル内で解決されます。 ホスト型 MCP の場合は、一致する notis://docs/notis-automation/references/<file>.md URI を resources/read または利用可能な Notis リソース取得ツールで取得します。ルートリソースからも、 これらのリンクを公開 URI に書き換えられます。

• リマインダー（シンプルなメッセージ配信）
• 自動化（トリガー → ビジネスロジック）
• トリガータイプ：schedule（繰り返し）
• トリガータイプ：one_time（将来の作業を実行）
• トリガータイプ：webhook（受信 HTTP）
• トリガータイプ：integration（接続済みアプリのイベント）
• トリガータイプ：database（Notis レコードの変更）
• スキルをビジネスロジックとして使うパターン