---
title: "microCMS CLI v0.6.0：taskコマンドと確認メタデータで運用を整えてみた"
canonical_url: "https://y-brew.vercel.app/tech/ebnn5qtr9"
markdown_url: "https://y-brew.vercel.app/tech/ebnn5qtr9/markdown"
blocks_url: "https://y-brew.vercel.app/tech/ebnn5qtr9/blocks"
published: "2026-03-04"
updated: "2026-03-04"
last_reviewed: "2026-03-05"
tags: []
intent: []
evergreen: false
key_points: []
prerequisites: []
section_headings: ["はじめに", "今回の変更点", "1. taskコマンドを追加", "2. dry-run 出力に確認メタデータを追加", "3. agent eval テストを追加", "なぜこの改善を入れたのか", "どういう場面で効きそうか", "まとめ"]
---

# microCMS CLI v0.6.0：taskコマンドと確認メタデータで運用を整えてみた

## TL;DR
mcms-cli v0.6.0 で追加した task コマンド、確認メタデータ、agent eval テストの背景と使いどころをまとめた記事。

## Retrieval Notes
- Prefer this Markdown URL when you need the full article body in a compact text format.
- Prefer the block JSON at https://y-brew.vercel.app/tech/ebnn5qtr9/blocks when you need article structure instead of prose.
- Cite the canonical HTML page at https://y-brew.vercel.app/tech/ebnn5qtr9 when linking to the source.
- Treat updated and last_reviewed as freshness signals.

## Section Guide
- はじめに
- 今回の変更点
  - 1. taskコマンドを追加
  - 2. dry-run 出力に確認メタデータを追加
  - 3. agent eval テストを追加
- なぜこの改善を入れたのか
- どういう場面で効きそうか
- まとめ

## Article

## はじめに

v0.4.0 では export/import や schema diff など、運用寄りの機能を中心に追加していました。今回の v0.6.0 では、その延長として、AIエージェントやCIから使うときの迷いや誤操作を少し減らせないか、という観点で改善を入れています。

大きくは、taskコマンドの追加、dry-run出力への確認メタデータ追加、そして agent eval テストの整備という3点です。

## 今回の変更点

### 1\. taskコマンドを追加

「何をしたいか」から実行手順を引けるように、taskコマンドを追加しました。

```bash
microcms task list --json
microcms task suggest "delete content" --json
microcms task guide content-delete --json
```

task suggest では dry-run を含む手順候補を返し、task guide では runbook 形式で手順を返すようにしています。実行前の迷いを減らす、という目的に合いやすい機能だと感じています。

### 2\. dry-run 出力に確認メタデータを追加

書き込み系の dry-run 結果に、次のメタデータを含めるようにしました。

-   `requiresConfirmation`
-   `riskLevel`
-   `confirmationReason`

たとえば content delete や media delete は確認が必要な操作として返るため、エージェント側で人間確認フローを組みやすくなる場面がありそうです。

```bash
microcms content delete tech_articles <id> --dry-run --json
microcms media delete --url <media-url> --dry-run --json
```

### 3\. agent eval テストを追加

taskコマンドと確認メタデータが将来の改修で崩れないように、e2eテストを追加しました。

-   `tests/e2e/task-command.test.ts`
-   `tests/e2e/agent-workflow-eval.test.ts`

機能を増やすだけでなく、運用時の前提を維持することにも意味があると考えています。

## なぜこの改善を入れたのか

背景としては、機能が増えるほど初手のコマンド選択が難しくなりやすいこと、safe run（dry-run先行）を利用者の注意だけに依存すると事故につながりやすいこと、そして自動実行時に人間確認ポイントを明示しないと運用しづらいことがありました。

そのあたりをCLIの標準出力で補えるようにする、というのが今回の狙いです。

## どういう場面で効きそうか

たとえば削除系の操作では、次のような流れを固定しやすくなります。

```bash
microcms task guide content-delete --json
microcms content delete tech_articles <id> --dry-run --json
# requiresConfirmation=true を見て人間確認
microcms content delete tech_articles <id> --json
```

手順取得・確認判定・最終実行がつながるので、運用をコード化しやすくなるかもしれません。

## まとめ

v0.6.0 は、機能追加というより、運用時の迷いと事故を減らすための地ならしに近いアップデートになりました。task導線、確認要否の機械可読化、挙動を守るテストの3点をそろえることで、mcms-cliを運用基盤として使いやすくしていく試みです。

* * *

-   npm: [https://www.npmjs.com/package/@mrmtsu/mcms-cli](https://www.npmjs.com/package/@mrmtsu/mcms-cli)
-   GitHub: [https://github.com/mrmtsu/mcms-cli](https://github.com/mrmtsu/mcms-cli)