reviw 1.5.1 → 1.6.0

package/README.ja.md

@@ -39,9 +39,14 @@
 
 ### メディアサイドバー
 - 左サイドバーに画像・動画のサムネイルギャラリーを表示
-- サムネイルクリックで対応するメディアにスクロール＆ソース行ハイライト
+- サムネイルクリックで対応するメディアにスクロール＆ハイライト
+- ↑↓キーで前後のメディアへジャンプ、Escapeで選択解除
 - 番号バッジ付きで素早く識別
 
+### メディア埋め込み規律チェック（AIフレンドリー）
+- メディアファイルが `![alt](path)` 埋め込みではなく `[text](path)` リンクで書かれている場合、`reviw file.md` はエラー（exit 1）で起動を拒否
+- 行番号とそのまま適用できる修正案を全件表示するので、AIエージェントが自動修正してリトライできる
+
 ### メディアフルスクリーン
 - Markdownプレビューの画像をクリックでフルスクリーンビューアを開く
 - 動画をクリックでYouTube風キーボードショートカット付きフルスクリーン再生（Space/K、J/L、矢印キー、0-9）
@@ -183,8 +188,9 @@ npx skills add https://github.com/kazuph/reviw -g -a codex -s '*' --copy -y
 npx skills add https://github.com/kazuph/reviw -g -a codex -a opencode -s '*' --copy -y
 ```
 
-`npx skills` が配るのは `plugin/skills/` 配下のスキル群です。Claude Code のプラグイン command や hooks はこの経路では入らず、上の Claude Code プラグイン導線でインストールします。
-```
+`npx skills` が配るのは `plugin/skills/` 配下のスキル群です。`-a codex -g --copy` を付けると、Codex のグローバルスキル置き場である `~/.agents/skills/` にコピーされます。`~/.agents/skills` が symlink の場合は、そのリンク先に実体が置かれます。
+
+Claude Code のプラグイン command や hooks はこの経路では入らず、上の Claude Code プラグイン導線でインストールします。
 
 ### プラグインディレクトリ構成
 
@@ -210,6 +216,10 @@ plugin/
 │   │   └── SKILL.md          # タスク開始スキル
 │   ├── done/
 │   │   └── SKILL.md          # タスク完了スキル
+│   ├── exit-notifier/
+│   │   ├── SKILL.md          # background task 終了通知スキル
+│   │   └── scripts/
+│   │       └── watch-exit-notify.sh
 │   ├── tiny-do/
 │   │   └── SKILL.md          # 軽量タスク開始スキル
 │   ├── tiny-done/
@@ -247,6 +257,7 @@ plugin/
 | **エージェント** | `review-e2e-integrity` | E2E: ユーザーフロー再現、モック汚染検出 |
 | **エージェント** | `e2e-health-reviewer` | E2E: goto制限、レコードアサーション、ハードコード検出 |
 | **スキル** | `artifact-proof` | エビデンス収集（スクリーンショット、動画、ログ） |
+| **スキル** | `exit-notifier` | background task の終了と stdout/stderr を現在の tmux / Herdr pane に通知 |
 | **スキル** | `webapp-testing` | Playwrightによるブラウザ自動化と検証 |
 | **フック** | PreToolUse | git commit/push前にレビューを促すリマインダー |
 | **フック** | UserPromptSubmit | AI コンテキストに完了チェックリストを注入 |
@@ -265,6 +276,7 @@ plugin/
 | `commit-and-push` | コミットメッセージ生成、commit、push、最終状態確認まで実行する |
 | `do` | worktree 作成、計画策定、レビュー準備を含むフルの開始フローを実行する |
 | `done` | エビデンス収集と reviw レビューを含むフルの完了フローを実行する |
+| `exit-notifier` | background task の終了結果と stdout/stderr を現在の tmux / Herdr pane に返す |
 | `open` | ファイル、成果物、URL を macOS の `open` で開く |
 | `tiny-do` | 小さなタスク向けの軽量開始フローで実装へ入る |
 | `tiny-done` | 小さなタスク向けの軽量完了フローで検証と確認を行う |

package/README.md

@@ -39,9 +39,14 @@ A lightweight browser-based tool for reviewing and annotating tabular data, text
 
 ### Media Sidebar
 - Thumbnail gallery of all images and videos in the left sidebar
-- Click any thumbnail to scroll to the corresponding media and highlight the source line
+- Click any thumbnail to scroll to the corresponding media and highlight it
+- ArrowUp/ArrowDown to jump between media, Escape to clear the selection
 - Numbered badges for quick identification
 
+### Media Embed Discipline (AI-friendly)
+- `reviw file.md` refuses to start (exit 1) when media files are written as `[text](path)` links instead of `![alt](path)` embeds
+- The error lists every violation with line numbers and ready-to-apply fixes, so AI agents can self-correct and retry
+
 ### Media Fullscreen
 - Click images in Markdown preview to open fullscreen viewer
 - Click videos to open fullscreen playback with YouTube-like keyboard shortcuts (Space/K, J/L, arrow keys, 0-9)
@@ -183,8 +188,9 @@ npx skills add https://github.com/kazuph/reviw -g -a codex -s '*' --copy -y
 npx skills add https://github.com/kazuph/reviw -g -a codex -a opencode -s '*' --copy -y
 ```
 
-`npx skills` distributes the skill directories under `plugin/skills/`. Claude Code plugin commands and hooks are installed through the Claude Code plugin flow above, not through `npx skills`.
-```
+`npx skills` distributes the skill directories under `plugin/skills/`. With `-a codex -g --copy`, the skills are copied into Codex's global skills directory at `~/.agents/skills/`. If `~/.agents/skills` is a symlink, the copied files land in the symlink target.
+
+Claude Code plugin commands and hooks are installed through the Claude Code plugin flow above, not through `npx skills`.
 
 ### Plugin Directory Structure
 
@@ -210,6 +216,10 @@ plugin/
 │   │   └── SKILL.md          # Task start skill
 │   ├── done/
 │   │   └── SKILL.md          # Task completion skill
+│   ├── exit-notifier/
+│   │   ├── SKILL.md          # Background task exit notification skill
+│   │   └── scripts/
+│   │       └── watch-exit-notify.sh
 │   ├── tiny-do/
 │   │   └── SKILL.md          # Lightweight task start skill
 │   ├── tiny-done/
@@ -247,6 +257,7 @@ plugin/
 | **Agent** | `review-e2e-integrity` | E2E: user flow reproduction, mock contamination |
 | **Agent** | `e2e-health-reviewer` | E2E: goto restrictions, record assertions, hardcoding |
 | **Skill** | `artifact-proof` | Collect evidence (screenshots, videos, logs) |
+| **Skill** | `exit-notifier` | Notify the current tmux / Herdr pane when background tasks exit, including captured stdout/stderr |
 | **Skill** | `webapp-testing` | Browser automation and verification with Playwright |
 | **Hook** | PreToolUse | Remind to review before git commit/push |
 | **Hook** | UserPromptSubmit | Inject completion checklist into AI context |
@@ -265,6 +276,7 @@ plugin/
 | `commit-and-push` | Generate a commit message, create the commit, push it, and confirm a clean git state |
 | `do` | Start the full task workflow with worktree setup, planning, and review preparation |
 | `done` | Run the full completion workflow with evidence collection and reviw-based review |
+| `exit-notifier` | Report background task completion and captured stdout/stderr back into the current tmux / Herdr pane |
 | `open` | Open files, artifacts, and URLs with macOS `open` |
 | `tiny-do` | Start a smaller task with the lightweight workflow |
 | `tiny-done` | Finish a smaller task with the lightweight completion flow |