日々の運用をエージェントに任せる
毎日・毎週やることのうち、判断が要らない部分は、そのままエージェントに 渡せます。mtb は原因ごとに終了コードを分けているので、 「直せるものは直し、直せないものは人間に戻す」という手順を指示に書けます。
公開前の点検
これから公開する記事（サイト4の下書き）を一覧して、次を確かめて。 ・タイトルと概要文が空でないか ・カテゴリが付いているか ・本文の中のリンクが 404 になっていないか 直せるものは直して、判断が要るものは一覧で見せて。
bash
mtb sites entries list 4 --all --status Draft \
--fields id,title,excerpt,categories,basename--all と --fields は組み合わせて使うよう指示してください。 全属性のまま50件を返すと、 それだけで読み取るエージェントのコンテキストが埋まります。
公開した記事が実際に書き出されたか
bash
mtb sites entries update 4 42 --entry '{"status":"Publish"}' --verify-publish保存できたことと、サイトに書き出されたことは別です。 --verify-publish は MT のログを見比べて、書き出せていなければ終了コード 8 で終了します。
bash
mtb publish entries --ids 42,43 --wait
curl -s -o /dev/null -w '%{http_code}\n' https://example.com/2026/09/entry.html終了コードで分岐する
エージェントに「失敗したら何をするか」を終了コードごとに指示しておく形です。
| コード | 意味 | エージェントの動き |
|---|---|---|
| 2 | 未認証・認証切れ | mtb auth login をやり直す（対話が要るなら人間に戻す） |
| 3 | 権限不足 | リトライしない。 人間に戻す |
| 4 | 対象が無い | IDを確かめ直す |
| 5 | 呼び出し方の誤り | 送信していない。 直して再実行してよい |
| 6 | 接続できない | 少し待って再実行 |
| 7 | サーバ側のエラー | MT のログを見る |
| 8 | 保存はできたが書き出せなかった | テンプレートの誤りを人間に報告する |
一覧は終了コード。
定期的に実行するもの
| 頻度 | やること | コマンド |
|---|---|---|
| 毎日 | 公開予約の記事が公開されたか | mtb sites entries list <site> --status Future --fields id,title,date |
| 毎日 | エラーログが増えていないか | mtb sites logs list <site> --level error --limit 20 |
| 週次 | 構成の棚卸し（差分で見る） | mtb dump --profile prod --dir ./audit/latest |
| 随時 | 使われていないアセット | mtb sites assets list <site> --all --fields id,url,filename |
既存サイトを棚卸しするも参照してください。
任せるときに指示すること
--yes を無条件に付けさせないこと
DELETE は取り消せません。意図した削除にだけ付ける、と指示に書いてください。 サイトの削除・ログの全消し・テンプレートの初期化は --yes だけでは実行されず、 --confirm <サイト名> が要ります。この入力は人間が行います。
- 接続先を固定する。
.envか--profileで決め、 実行する前にmtb profile showで確かめさせます - 本番に反映する前に差分を見せさせる。 特にテンプレート
- 本文の一括置換は書式に注意。
--no-text-filter 1を付けないと 原稿が変換後の HTML に置き換わります（データの受け渡し）
前提はプロジェクトの CLAUDE.md に1回書いておくと毎回書かずに済みます （指示の書き方）。