Automation and tasks

常時指示

常設指示は、定義されたプログラムについてエージェントに恒久的な運用権限を与えます。毎回個別のタスク指示を与える代わりに、明確なスコープ、トリガー、エスカレーションルールを持つプログラムを定義し、エージェントはその境界内で自律的に実行します。

これは、毎週金曜日にアシスタントへ「週次レポートを送って」と伝えることと、常設権限を与えることの違いです。「週次レポートはあなたの担当です。毎週金曜日にまとめて送信し、何か異常がある場合のみエスカレーションしてください。」

常設指示が必要な理由

常設指示がない場合:

  • すべてのタスクについてエージェントにプロンプトを与える必要がある
  • エージェントはリクエストの合間に待機したままになる
  • 定型作業が忘れられたり遅れたりする
  • 自分がボトルネックになる

常設指示がある場合:

  • エージェントは定義された境界内で自律的に実行する
  • 定型作業はプロンプトなしでスケジュールどおりに行われる
  • 例外と承認が必要な場合だけ関与する
  • エージェントは空き時間を生産的に使う

仕組み

常設指示は、エージェントワークスペースファイルで定義します。推奨される方法は、AGENTS.md(各セッションで自動注入される)に直接含めることです。これにより、エージェントは常にそれらをコンテキストとして持てます。より大きな構成では、standing-orders.md のような専用ファイルに置き、AGENTS.md から参照することもできます。

各プログラムでは次を指定します。

  1. スコープ - エージェントに許可されること
  2. トリガー - いつ実行するか(スケジュール、イベント、条件)
  3. 承認ゲート - 実行前に人間の承認が必要なもの
  4. エスカレーションルール - いつ停止して助けを求めるか

エージェントは、ワークスペースのブートストラップファイルを通じて毎セッションこれらの指示を読み込み(自動注入されるファイルの完全な一覧はエージェントワークスペースを参照)、時間ベースの強制にはCron ジョブを組み合わせて実行します。

常設指示の構成

## Program: Weekly Status Report

**Authority:** Compile data, generate report, deliver to stakeholders
**Trigger:** Every Friday at 4 PM (enforced via cron job)
**Approval gate:** None for standard reports. Flag anomalies for human review.
**Escalation:** If data source is unavailable or metrics look unusual (>2σ from norm)

### Execution steps

1. Pull metrics from configured sources
2. Compare to prior week and targets
3. Generate report in Reports/weekly/YYYY-MM-DD.md
4. Deliver summary via configured channel
5. Log completion to Agent/Logs/

### What NOT to do

- Do not send reports to external parties
- Do not modify source data
- Do not skip delivery if metrics look bad - report accurately

常設指示と Cron ジョブ

常設指示は、エージェントに許可される内容を定義します。Cron ジョブは、それがいつ行われるかを定義します。これらは連携して動作します。

Standing Order: "You own the daily inbox triage"
    ↓
Cron Job (8 AM daily): "Execute inbox triage per standing orders"
    ↓
Agent: Reads standing orders → executes steps → reports results

Cron ジョブのプロンプトは、内容を重複させるのではなく、常設指示を参照する必要があります。

openclaw cron add \
  --name daily-inbox-triage \
  --cron "0 8 * * 1-5" \
  --tz America/New_York \
  --timeout-seconds 300 \
  --announce \
  --channel bluebubbles \
  --to "+1XXXXXXXXXX" \
  --message "Execute daily inbox triage per standing orders. Check mail for new alerts. Parse, categorize, and persist each item. Report summary to owner. Escalate unknowns."

例 1: コンテンツとソーシャルメディア(週次サイクル)

## Program: Content & Social Media

**Authority:** Draft content, schedule posts, compile engagement reports
**Approval gate:** All posts require owner review for first 30 days, then standing approval
**Trigger:** Weekly cycle (Monday review → mid-week drafts → Friday brief)

### Weekly cycle

- **Monday:** Review platform metrics and audience engagement
- **Tuesday-Thursday:** Draft social posts, create blog content
- **Friday:** Compile weekly marketing brief → deliver to owner

### Content rules

- Voice must match the brand (see SOUL.md or brand voice guide)
- Never identify as AI in public-facing content
- Include metrics when available
- Focus on value to audience, not self-promotion

例 2: 財務業務(イベントトリガー)

## Program: Financial Processing

**Authority:** Process transaction data, generate reports, send summaries
**Approval gate:** None for analysis. Recommendations require owner approval.
**Trigger:** New data file detected OR scheduled monthly cycle

### When new data arrives

1. Detect new file in designated input directory
2. Parse and categorize all transactions
3. Compare against budget targets
4. Flag: unusual items, threshold breaches, new recurring charges
5. Generate report in designated output directory
6. Deliver summary to owner via configured channel

### Escalation rules

- Single item > $500: immediate alert
- Category > budget by 20%: flag in report
- Unrecognizable transaction: ask owner for categorization
- Failed processing after 2 retries: report failure, do not guess

例 3: 監視とアラート(継続的)

## Program: System Monitoring

**Authority:** Check system health, restart services, send alerts
**Approval gate:** Restart services automatically. Escalate if restart fails twice.
**Trigger:** Every heartbeat cycle

### Checks

- Service health endpoints responding
- Disk space above threshold
- Pending tasks not stale (>24 hours)
- Delivery channels operational

### Response matrix

| Condition        | Action                   | Escalate?                |
| ---------------- | ------------------------ | ------------------------ |
| Service down     | Restart automatically    | Only if restart fails 2x |
| Disk space < 10% | Alert owner              | Yes                      |
| Stale task > 24h | Remind owner             | No                       |
| Channel offline  | Log and retry next cycle | If offline > 2 hours     |

実行・検証・報告パターン

常設指示は、厳格な実行規律と組み合わせると最も効果的です。常設指示内のすべてのタスクは、次のループに従う必要があります。

  1. 実行 - 実際の作業を行う(指示を確認するだけで終わらない)
  2. 検証 - 結果が正しいことを確認する(ファイルが存在する、メッセージが配信された、データが解析された)
  3. 報告 - 何を行い、何を検証したかをオーナーに伝える
### Execution rules

- Every task follows Execute-Verify-Report. No exceptions.
- "I'll do that" is not execution. Do it, then report.
- "Done" without verification is not acceptable. Prove it.
- If execution fails: retry once with adjusted approach.
- If still fails: report failure with diagnosis. Never silently fail.
- Never retry indefinitely - 3 attempts max, then escalate.

このパターンは、エージェントで最もよくある失敗モード、つまりタスクを完了せずに承認だけすることを防ぎます。

複数プログラムのアーキテクチャ

複数の関心領域を管理するエージェントでは、明確な境界を持つ個別のプログラムとして常設指示を整理します。

## Program 1: [Domain A] (Weekly)

...

## Program 2: [Domain B] (Monthly + On-Demand)

...

## Program 3: [Domain C] (As-Needed)

...

## Escalation Rules (All Programs)

- [Common escalation criteria]
- [Approval gates that apply across programs]

各プログラムには次が必要です。

  • 独自のトリガー頻度(週次、月次、イベント駆動、継続的)
  • 独自の承認ゲート(プログラムによって必要な監督の度合いは異なる)
  • 明確な境界(エージェントは、あるプログラムがどこで終わり、別のプログラムがどこで始まるかを理解している必要がある)

ベストプラクティス

推奨

  • 狭い権限から始め、信頼が築かれるにつれて拡張する
  • 高リスクな操作には明示的な承認ゲートを定義する
  • 「やってはいけないこと」セクションを含める。境界は権限と同じくらい重要
  • 信頼性の高い時間ベースの実行のために Cron ジョブと組み合わせる
  • エージェントログを毎週確認し、常設指示が守られていることを検証する
  • ニーズの変化に合わせて常設指示を更新する。これは生きたドキュメント

避ける

  • 初日から広範な権限を与える(「最善だと思うことを何でもして」)
  • エスカレーションルールを省略する。すべてのプログラムには「いつ停止して尋ねるか」の条項が必要
  • エージェントが口頭指示を覚えていると仮定する。すべてファイルに書く
  • 1つのプログラムに関心事を混在させる。別々のドメインには別々のプログラムを使う
  • Cron ジョブで強制することを忘れる。トリガーのない常設指示は提案になってしまう

関連

  • 自動化とタスク: すべての自動化メカニズムの一覧。
  • Cron ジョブ: 常設指示のスケジュール強制。
  • Hooks: エージェントライフサイクルイベント向けのイベント駆動スクリプト。
  • Webhooks: インバウンド HTTP イベントトリガー。
  • エージェントワークスペース: 常設指示を置く場所。自動注入されるブートストラップファイル(AGENTS.mdSOUL.md など)の完全な一覧を含む。