How this skill is triggered — by the user, by Claude, or both
Slash command
/agent-butler:butler-cronThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
cron または Claude Code/Cowork スケジュールから起動される定期実行エンジン。
cron または Claude Code/Cowork スケジュールから起動される定期実行エンジン。 ジョブ定義に従って情報収集・整理・レポート生成を自律的に実行し、結果と通知を保存する。
このスキルはユーザが直接呼び出すこともできるが、主に定期実行基盤から自動起動される。
/agent-butler:butler と同じ。結果ファイルもフランクに書く。ただし重要事項は丁寧に。
$WORKHUB_HOME: ベースディレクトリ($WORKHUB_HOME → ~/.workhubrc → ~/.workhub)$ARGUMENTS: 実行するジョブのslug$WORKHUB_HOME/butler/schedules/{slug}.md$WORKHUB_HOME/butler/schedules/logs/{slug}/$WORKHUB_HOME/butler/notifications/$WORKHUB_HOME/butler/memory/severity: warning で保存し、次回 /agent-butler:butler 時にユーザに確認severity: warning で保存し、次回 /agent-butler:butler 時にユーザに確認$WORKHUB_HOME が設定されていればそれを使用~/.workhubrc が存在すれば base_dir を読む~/.workhub をデフォルトに使用$ARGUMENTS からジョブ slug を取得$WORKHUB_HOME/butler/schedules/{slug}.md を読み込むenabled: false の場合、ログに「スキップ」を記録して終了severity: error で記録して終了context.md, tasks.md を読み込むschedules/logs/{slug}/ の最新)があれば読み込み、差分検出の基準にするジョブ定義の「やること」セクションに従ってステップを順次実行する。
$WORKHUB_HOME/butler/schedules/logs/{slug}/YYYY-MM-DD-HHMMSS.md に保存:
---
job: "{slug}"
status: completed | partial | failed
started_at: {ISO 8601}
completed_at: {ISO 8601}
---
# {ジョブ名} 実行ログ
## 実行内容
1. {ステップ1の内容と結果}
2. {ステップ2の内容と結果}
## 結果サマリ
{結果の要約}
## 出力ファイル
- {作成/更新したファイルのパス一覧}
## エラー(あれば)
- {エラー内容と原因}
ジョブ定義ファイルの frontmatter を更新:
last_run: 実行日時last_status: 実行結果ステータス$WORKHUB_HOME/butler/notifications/{YYYY-MM-DD-HHMMSS}-{slug}.md を作成:
---
source: schedule/{slug}
severity: info | warning | error
read: false
created_at: {ISO 8601}
---
{1〜2行の要約}
詳細: {実行ログまたは出力ファイルへのパス}
| severity | 条件 |
|---|---|
| error | ジョブ全体が失敗、または重要ステップが失敗 |
| warning | 一部ステップが失敗(partial)、またはユーザ判断が必要な内容 |
| info | 正常完了の報告 |
partial にするfailed にするseverity: error で記録severity: warning で記録初回セットアップ時に /agent-butler:butler が提案するプリセットジョブ:
---
name: "inbox自動整理"
slug: inbox-cleanup
enabled: true
schedule: "0 22 * * *"
executor: cron
---
## トリガー
cron: 毎日 22:00
## やること
1. $WORKHUB_HOME/inbox/ の未処理アイテムを走査
2. 内容を分析して適切なプロジェクト/エリアを推定
3. 明確に分類できるものは自動振り分け(タスク追加 or ノート保存)
4. 分類に迷うものはそのまま残し、通知キューで報告
## 出力先
- 振り分け先の各プロジェクト/エリアの tasks.md or notes/
- 通知: 処理結果のサマリ
---
name: "タスク期限チェック"
slug: task-reminder
enabled: true
schedule: "0 9 * * *"
executor: cron
---
## トリガー
cron: 毎日 9:00
## やること
1. 全プロジェクト/エリアの tasks.md を走査
2. 期限切れのタスクを検出
3. 期限が今日〜3日以内のタスクを検出
4. 優先度と期限でソートしたリマインドリストを作成
## 出力先
- 通知: severity に応じて(期限切れ=warning、期限近い=info)
---
name: "週次活動サマリ"
slug: weekly-digest
enabled: true
schedule: "0 8 * * 1"
executor: cron
---
## トリガー
cron: 毎週月曜 8:00
## やること
1. 過去1週間の全プロジェクトの変更を集約
2. 完了タスク、新規タスク、進捗率を算出
3. butler実行ログからの活動サマリ
4. 来週の予定・期限タスクの洗い出し
## 出力先
- ノート: $WORKHUB_HOME/reports/weekly-digest-{date}.md
- 通知: サマリの要約
---
name: "memory整理"
slug: memory-maintenance
enabled: true
schedule: "0 3 * * 0"
executor: cron
---
## トリガー
cron: 毎週日曜 3:00
## やること
1. butler/memory/ 配下の全ファイルの行数をチェック
2. 500行超のファイルについて:
a. 最終参照日が古い順にソート
b. 500行以内に収まるまで古いエントリを削除
c. 削除エントリを forgotten/ に移動(forgotten日を付加)
3. forgotten/ 内で forgotten日から2年経過したエントリを完全削除
## 出力先
- 通知: 整理結果のサマリ(移動件数、削除件数)
npx claudepluginhub makotan/agent-butler --plugin agent-butlerConducts a structured weekly review to clear inboxes, review projects, and set priorities, reducing cognitive load and improving focus for the coming week.
Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.