ルーチンで作業を繰り返す

Cartographer でルーチンを作成、管理、実行して、再利用可能なタスク ワークフローを保存し、シングル クリックで実行します。

ルーチンは、シングル クリックで実行できる再利用可能なワークフローです。繰り返し実行する作業のパターンをキャプチャするため、一般的なタスクを毎回再構築しなくても自動化できます。これらは、サイドバーの [ルーチン ] セクションに、スケジュールしたルーチンの [ スケジュールされたルーチン ] エントリとともに表示されます。

Cartographer には、自分で作成したルーチンと並んで、すぐに使える一連の定義済みルーチンが付属しています。

ルーチンとは何ですか?

ルーチンとは、ユーザーが呼び出せるとマークされたスキルのことです (同じパッケージ、同じパブリッシュ、1 つの追加プロパティ)。適切に設計されたルーチンには通常、次のものがあります。

• トリガーをいつ使用すべきかを説明する明確なトリガーの説明
• 実行ごとに変化する入力 (パラメーター)
• 一貫性のある出力 (ドキュメント、レポート、更新など)

すべてのルーチンはスキルです。すべてのスキルがルーチンであるわけではありませんが、違いは、1 つの追加の特性です。このため、サイドバーには呼び出し可能なルー チン のリストが表示され、[アド オンと連携 → スキル ] には、エージェントが呼び出すことができるすべてのものがリストされます。詳しくは、「 スキル リファレンス」をご覧ください。

ルーチンは個人のオートメーションのライブラリだと考えてください。一度設計すれば必要なときにいつでも実行できるワークフローです。

ルーチンを作成するタイミング

気付いたときにルーチンを作成します。

• 地図製作者に毎週同じ種類のタスクを依頼 する (例: 「月曜日の朝のブリーフを準備する」)
• さまざまなデータを使用した一貫したプロセスに従う (例: 「この Jira プロジェクトからステータス レポートを生成してください」)
• 同じタスクを実行する必要があるチームメイトとワークフローを共有する
• オートメーションを特定の時刻に実行するようにスケジュールを設定する場合

ルーチンの作成

サイドバーの「ルーチン」セクションで「新しいルーチン」を選択し、以下の 4 つの方法のいずれかを選択します。

メソッド	機能
プロンプトから作成	タスクの説明を入力し、エージェントにルーチンを構築させます。
スキルから作成	既存のスキル テンプレートから開始します。
録画から作成	録画したワークフローをルーチンに変換します。
新しいワークフローを録画する	画面を録画して新しいワークフローをキャプチャします。

ワークフローの記録は、[設定] の [ 記録 ] からも行えます。詳しくは、「 記録の設定 」および 「タスクを記録する」をご覧ください。

内部的には、ルーチンは SKILL.md ファイルであり、マークダウンとファイルシステムの構成に慣れているユーザーにとって、ルーチンを直接編集することはルーチンを形作る別の方法です。構造の例:

---
name: my-routine
friendly_name: Weekly Sales Report
version: 1.0.0
description: "Generates a weekly sales summary from spreadsheet data"
icon: FaChartBar
color: "3B82F6"
trigger: "When you need a summary of weekly sales performance"
inputs:
  - name: week_ending
    type: date
    description: "The last day of the week to report on"
  - name: data_file
    type: file
    description: "Path to the sales data spreadsheet"
output:
  type: file
  description: "PowerPoint presentation with sales charts"
---

## Steps

1. Read the sales data from {data_file}
2. Filter for the week ending {week_ending}
3. Calculate total sales, top products, and regional breakdown
4. Create a PowerPoint with:
   - Title slide: "Weekly Sales Report - {week_ending}"
   - Summary slide with key metrics
   - Chart slide showing product performance
   - Regional breakdown table
5. Save as "Sales_Report_{week_ending}.pptx" on the Desktop

ルーチンを実行する

• サイドバーの 「ルーチン 」リストからルーチンを選択します。これにより、チャット ボックスにルーチンの / コマンドが自動入力されます (実行するには送信します)。
• チャット ボックスに「 / 」と入力して利用可能なルーチンとコマンドのメニューを開き、1 つを選択すると同じ方法で自動入力されます。
• 会話でルーチンを名前で参照する (例: Run the Weekly Sales Report for last week using the file in ~/Documents/Sales/)。Cartographer はルーチン名を認識し、指定したパラメーターで実行します。

ルーチンを管理する

これらのアクションについては、[ ルーチン] リストでルーチンの横にあるオプション メニューを開きます。

操作	機能
お気に入り	見つけやすくするためにルーチンをピン留めします
ファイルを表示	ルーチンの機能と使用方法を確認する
スケジュール	定期的な実行または 1 回限りの実行を設定する — 「ルーチンをスケジュール設定する」をご覧ください。
名前を変更する	ルーチンの表示名を変更する
プロジェクトに移動	ルーチンを別のプロジェクトに移動します
削除する	ルーチンを削除する

ルーチンを編集するには、関連する SKILL.md ファイルを直接編集します ( 詳細: ルーチン・ストレージを参照)。

ルーチンのスケジュール設定

ルーチンの横にある [ スケジュール ] を選択するか、[ルーチン] リストから [ スケジュール ルーチン ] を選択して、以下を設定します。

フィールド	説明
ルーチン	実行するルーチン
ルーチンのスケジュールを設定	実行の日時
Recurrence	繰り返し頻度 — 既定値は [なし] (1 回のみ) です。
モード	フォアグラウンド (アプリ、マウス、キーボードを使用) または バックグラウンド
モデル	スケジュールされたルーチンを実行するモデル

スケジュールされたルーチンを管理する

サイドバーの 「スケジュールされたルーチン 」からすべてのスケジュールされたルーチンを表示および管理します:今後の実行、最後の実行ステータスと履歴を確認し、個々のスケジュールを有効化、無効化、編集、または削除します。

スケジュールされたルーチンは、保存されている接続と権限を使用して実行されます。認証の有効期限が切れると、再接続するまでルーチンが失敗する可能性があります。

ルーチンを共有する

ルーチンはスキルであるため、チームメイトとルーチンを共有したり、より広範に公開したりすることは、他のスキルと同じパブリッシュ、レビュー、インストールの流れに従います (「 チームとスキルを共有する」をご覧ください)。

日常的なベスト プラクティス

わかりやすいようにデザインする

• わかりやすい名前: 「レポート 1」ではなく「週次売上レポート」
• 明確なトリガーを記述する: 誰かがこのルーチンをいつ使用すべきかを説明します
• ドキュメント入力: 各パラメーターの目的と期待される形式を説明します
• 出力を指定する: ユーザーが受け取る内容を記述します

可変性を処理

• 変更されるすべての項目 (日付、ファイル パス、名前) には入力パラメーターを使用します
• 可能な場合は適切な既定値を指定します
• ルーチン ステップの入力を検証します (例:「ファイルの存在を確認」)。
• フォールバック動作を使用して不足している入力を適切に処理する

徹底的にテストする

• 最初にガイド付きモードで実行して、 予期しないステップをキャッチします
• エッジ ケース (空のファイル、将来の日付、特殊文字) を使用してテストする
• 共有する前に、出力が期待値と一致することを確認します
• チームと共有する場合は別のマシンでテストする

バージョン管理

• 大幅な変更の前に複製を実行して、動作バージョンを保持します
• ルーチンの説明または CHANGELOG の変更を文書化する
• SKILL.md (1.0.0、1.1.0、2.0.0)— バージョンは今後のみ進む

セキュリティに関する考慮事項

• 定型的な手順では資格情報をハードコーディングしない — コネクションを使用します
• ファイル パスには注意してください。 相対パスまたは入力パラメーターを使用します
• 共有前に権限を確認する — 受信者が必要なシステムにアクセスできることを確認します
• シェル コマンドや URL に入る入力をサニタイズします

詳細:日常的な保管

ルーチンは、LocalSkills/ フォルダーに SKILL.md ファイルとして保存されます。

LocalSkills/
├── my-routine/
│   └── SKILL.md
└── another-routine/
    └── SKILL.md

このフォルダーが存在する場所については、「 設定ファイルの場所」 をご覧ください。ルーチンをコピーしてバックアップしたり、クラウド ストレージを介してマシン間で同期したりできます。ルーチンの絶対パスは、別のマシンでは機能しない可能性があるため、その場合に注意してください。

次のステップ

• スキル リファレンス — ルーチンとスキルとの関係
• チームとスキルを共有する — スキルとルーチンを公開、インストール、レビューします
• タスクを記録する — ワークフローを記録して、ルーチンやナレッジ スキルに変換します