Reviw Plugin

yunomi Plugin for Claude Code

yunomi CLI ツールを Claude Code と連携させるプラグインです。タスク管理、レビューワークフロー、報告書作成を効率化します。

インストール

# Claude Code で実行
/plugin marketplace add kazuph/yunomi
/plugin install yunomi-plugin@yunomi-plugins

npx skills で使う

Claude Code プラグインではなく、Codex、OpenCode、Cursor などの skills 対応エージェントへ task skill 群だけを入れたい場合は npx skills を使います。Claude Code は上の導線を使ってください。

# 検出される skill を確認
npx skills add https://github.com/kazuph/yunomi --list

# 例: Codex にグローバルインストール
npx skills add https://github.com/kazuph/yunomi -g -a codex -s '*' --copy -y

# 例: Codex / OpenCode にまとめてインストール
npx skills add https://github.com/kazuph/yunomi -g -a codex -a opencode -s '*' --copy -y

この経路で入るのは plugin/skills/ の skill だけです。-a codex -g --copy を付けると、Codex のグローバルスキル置き場である ~/.agents/skills/ にコピーされます。~/.agents/skills が symlink の場合は、そのリンク先に実体が置かれます。

Claude Code の command や hooks まで含めたい場合は、上のプラグイン導線を使ってください。

更新

プラグインを最新版に更新するには、一度アンインストールしてから再インストールしてください：

claude plugin uninstall yunomi-plugin@yunomi-plugins
claude plugin install yunomi-plugin@yunomi-plugins

※ 新しいエージェントや機能を反映するには、Claude Code の再起動も必要です。

旧マーケットプレイス名からの移行

yunomi-marketplace（旧名）を使用していた場合は、以下で削除してください：

# 旧プラグインのアンインストール
claude plugin uninstall yunomi-plugin@yunomi-marketplace

# 旧マーケットプレイスの削除（どちらか一方を実行）
/plugin marketplace remove yunomi-marketplace          # Claude Code内で実行
claude plugin marketplace remove yunomi-marketplace    # ターミナルで実行

その後、上記の「インストール」セクションの手順で再インストールしてください。

機能一覧

Task Skills（スラッシュスキル）

スキル	説明
/yunomi:ask	要件を深掘りして AskUserQuestion で認識ズレを防ぐ
/yunomi:check-yourself	推測を禁止し、実機検証を強制する
/yunomi:commit-and-push	変更をコミットして push まで完了させる
/yunomi:do <タスク説明>	タスク開始スキル - git wt で worktree 作成、計画策定、Todo 登録
/yunomi:done	タスク完了スキル - エビデンス収集、yunomi でレビュー開始
/yunomi:open <file-or-url>	macOS の open でファイルや URL を開く
/yunomi:tiny-do <タスク説明>	小タスク向け軽量開始スキル
/yunomi:tiny-done	小タスク向け軽量完了スキル
/yunomi:bucho <指示>	Claude Code と Codex を束ねる部長モード

Task Skill 一覧

名前	用途
ask	実装前に AskUserQuestion を使って要求・制約・成功条件を明確化する
bucho	Claude Code と Codex を tmux 経由で指揮してチーム開発フローを回す
check-yourself	推測を止めて、webapp-testing / backend-testing / mobile-testing による実検証へ強制する
commit-and-push	変更内容からコミットメッセージを作り、commit / push / 最終状態確認まで実行する
do	worktree 作成、計画策定、Todo 登録、レビュー準備を含むフルのタスク開始フローを始める
done	完了条件チェック、証跡収集、レビュー起動を含むフルのタスク完了フローを実行する
exit-notifier	tmux / Herdr で background task の終了と stdout/stderr を現在 pane に通知する
open	直近で触れたファイルや URL、または明示したパスを macOS の open で開く
tiny-do	小さなタスク向けに、軽量な開始フローで実装へ入る
tiny-done	小さなタスク向けに、軽量な検証と確認フローで完了へ進む
validate-report	done から呼ばれる内部 helper として、REPORT.md が artifact-proof の 5 ルールを満たしているかをチェックする

Agents（サブエージェント）

エージェント	説明
report-builder	レビューしてもらうための報告書・エビデンス整理専門
e2e-health-reviewer	E2Eテストの健全性レビュー（goto制限、レコードアサーション、ハードコード検出）

使用方法:

Task ツールで subagent_type: "report-builder" を指定
Task ツールで subagent_type: "e2e-health-reviewer" を指定
（/done時は両方を並列実行）

Skills（自動参照スキル）

スキル	説明
artifact-proof	エビデンス収集（スクショ・動画・ログ）+ yunomi でのレビューワークフロー
exit-notifier	background で実行した npx yunomi などの終了結果と stdout/stderr を tmux / Herdr pane に返す

Hooks（自動フック）

イベント	動作
PreToolUse (git commit/push)	yunomi でのレビュー完了確認リマインダー
UserPromptSubmit	完了報告前チェックリスト（AIへのカンペ）

UserPromptSubmit hook の詳細

ユーザーがメッセージを送信した直後、AIが応答を生成する前に、以下のチェックリストがAIのコンテキストに追加されます（ユーザーには見えません）：

• 実装完了（1/3）: ビルド成功・型エラーなし
• 動作検証完了（2/3）: 開発サーバー起動・webapp-testing で検証
• レビュー完了（3/3）: エビデンス収集・/done スキル実行・yunomi でレビュー・ユーザー承認

これにより、AIが「実装しました！」だけで完了報告することを防ぎ、yunomi のワークフローに従うよう促します。

ワークフロー

/yunomi:do <タスク説明>
    ↓
git wt で worktree 作成 + 計画策定
    ↓
実装作業
    ↓
/yunomi:done
    ↓
エビデンス収集 + 報告書作成
    ↓
npx yunomi で報告書を開く（フォアグラウンド）
    ↓
ユーザーがコメント → Submit & Exit
    ↓
フィードバックを Todo に登録
    ↓
修正 → 再レビュー
    ↓
承認されたら完了

完了基準

段階	内容
1/3	実装完了
2/3	ビルド・起動・動作検証完了
3/3	yunomi でレビュー → ユーザー承認

実装完了だけでは 1/3。yunomi でレビューを受けて初めて完了。

ディレクトリ構成

yunomi-plugin/
├── .claude-plugin/
│   └── plugin.json          # プラグインマニフェスト
├── agents/
│   └── report-builder.md    # 報告書作成エージェント
├── skills/
│   ├── ask/
│   │   └── SKILL.md         # 要件ヒアリングスキル
│   ├── bucho/
│   │   └── SKILL.md         # 部長オーケストレーションスキル
│   ├── do/
│   │   └── SKILL.md         # タスク開始スキル
│   ├── done/
│   │   └── SKILL.md         # タスク完了スキル
│   ├── exit-notifier/
│   │   ├── SKILL.md         # background task 終了通知スキル
│   │   └── scripts/
│   │       └── watch-exit-notify.sh
│   ├── tiny-do/
│   │   └── SKILL.md         # 軽量タスク開始スキル
│   ├── tiny-done/
│   │   └── SKILL.md         # 軽量タスク完了スキル
│   ├── validate-report/
│   │   └── SKILL.md         # REPORT.md検証の内部 helper
│   └── artifact-proof/
│       └── SKILL.md         # エビデンス収集 + yunomi レビュースキル
├── hooks/
│   └── hooks.json           # 自動フック設定
└── README.md

yunomi の基本的な使い方

# Markdown を開く
npx yunomi report.md

# CSV を開く
npx yunomi data.csv

# git diff を開く
git diff HEAD | npx yunomi

# 複数ファイル
npx yunomi file1.md file2.csv

詳細は yunomi-master スキルを参照してください。

License

MIT