reviw 1.3.0 → 1.4.1

package/README.ja.md

@@ -165,7 +165,25 @@ summary: Overall the data looks good, minor issues noted above.
 ```bash
 # Claude Codeで
 /plugin marketplace add kazuph/reviw
-/plugin install reviw-plugin@reviw-marketplace
+/plugin install reviw-plugin@reviw-plugins
+```
+
+### `npx skills` でスキルを入れる
+
+Codex、OpenCode、Cursor など、`npx skills` 対応エージェントで reviw のタスクスキルを使いたい場合はこちらを使います。Claude Code は上のプラグイン導線を使ってください。
+
+```bash
+# まず検出されるスキルを確認
+npx skills add https://github.com/kazuph/reviw --list
+
+# Codex 向けに全スキルをグローバルインストール
+npx skills add https://github.com/kazuph/reviw -g -a codex -s '*' --copy -y
+
+# Codex と OpenCode へまとめてグローバルインストール
+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 プラグイン導線でインストールします。
 ```
 
 ### プラグインディレクトリ構成
@@ -174,9 +192,6 @@ summary: Overall the data looks good, minor issues noted above.
 plugin/
 ├── .claude-plugin/
 │   └── plugin.json          # プラグインメタデータ（名前、バージョン、説明）
-├── commands/
-│   ├── do.md                 # /reviw:doコマンド定義
-│   └── done.md               # /reviw:doneコマンド定義
 ├── agents/
 │   ├── report-builder.md     # レポート生成エージェント
 │   ├── e2e-health-reviewer.md    # E2Eテスト健全性チェック
@@ -187,6 +202,20 @@ plugin/
 │   ├── review-copy-consistency.md # テキスト整合性
 │   └── review-e2e-integrity.md   # E2Eテスト整合性
 ├── skills/
+│   ├── ask/
+│   │   └── SKILL.md          # 要件ヒアリングスキル
+│   ├── bucho/
+│   │   └── SKILL.md          # 部長オーケストレーションスキル
+│   ├── do/
+│   │   └── SKILL.md          # タスク開始スキル
+│   ├── done/
+│   │   └── SKILL.md          # タスク完了スキル
+│   ├── tiny-do/
+│   │   └── SKILL.md          # 軽量タスク開始スキル
+│   ├── tiny-done/
+│   │   └── SKILL.md          # 軽量タスク完了スキル
+│   ├── validate-report/
+│   │   └── SKILL.md          # REPORT.md検証の内部 helper
 │   ├── artifact-proof/
 │   │   └── SKILL.md          # エビデンス収集スキル
 │   └── webapp-testing/
@@ -204,8 +233,11 @@ plugin/
 
 | 種類 | 名前 | 説明 |
 |------|------|------|
-| **コマンド** | `/reviw:do` | タスク開始 - git wtでworktree作成、計画、todo登録 |
-| **コマンド** | `/reviw:done` | 完了チェックリスト - 7レビューエージェント実行、エビデンス収集、レビュー開始 |
+| **タスクスキル** | `/reviw:do` | タスク開始 - git wtでworktree作成、計画、todo登録 |
+| **タスクスキル** | `/reviw:done` | 完了チェックリスト - 7レビューエージェント実行、エビデンス収集、レビュー開始 |
+| **タスクスキル** | `/reviw:tiny-do` | 小タスク向けの軽量開始フロー |
+| **タスクスキル** | `/reviw:tiny-done` | 小タスク向けの軽量完了フロー |
+| **タスクスキル** | `/reviw:bucho` | Claude Code と Codex を束ねる部長モード |
 | **エージェント** | `report-builder` | ユーザーレビュー用レポート準備 |
 | **エージェント** | `review-code-quality` | コード品質: 可読性、DRY、型安全性、エラーハンドリング |
 | **エージェント** | `review-security` | セキュリティ: XSS、インジェクション、OWASP Top 10、秘密情報検出 |
@@ -221,7 +253,22 @@ plugin/
 
 ---
 
-### コマンド
+### タスクスキル
+
+#### 同梱タスクスキル一覧
+
+| スキル | 用途 |
+|------|------|
+| `ask` | 実装前に要求・スコープ・制約・成功条件を明確化する |
+| `bucho` | Claude Code と Codex を tmux 経由で束ねてチーム開発フローを回す |
+| `check-yourself` | 推測を禁止し、実際の検証を強制する |
+| `commit-and-push` | コミットメッセージ生成、commit、push、最終状態確認まで実行する |
+| `do` | worktree 作成、計画策定、レビュー準備を含むフルの開始フローを実行する |
+| `done` | エビデンス収集と reviw レビューを含むフルの完了フローを実行する |
+| `open` | ファイル、成果物、URL を macOS の `open` で開く |
+| `tiny-do` | 小さなタスク向けの軽量開始フローで実装へ入る |
+| `tiny-done` | 小さなタスク向けの軽量完了フローで検証と確認を行う |
+| `validate-report` | `done` から呼ばれる内部 helper として `REPORT.md` を検証する |
 
 #### `/reviw:do <タスク説明>`
 
@@ -243,7 +290,7 @@ plugin/
         └── videos/           # 動画録画
 ```
 
-**タスク再開:** セッション開始時またはコンテキスト圧縮後、コマンドは既存のworktreeを確認（`git wt`）し、`REPORT.md`から再開します。
+**タスク再開:** セッション開始時またはコンテキスト圧縮後、スキルは既存のworktreeを確認（`git wt`）し、`REPORT.md`から再開します。
 
 #### `/reviw:done`
 

package/README.md

@@ -165,7 +165,25 @@ This repository also serves as a Claude Code plugin marketplace. The plugin inte
 ```bash
 # In Claude Code
 /plugin marketplace add kazuph/reviw
-/plugin install reviw-plugin@reviw-marketplace
+/plugin install reviw-plugin@reviw-plugins
+```
+
+### Install Skills with `npx skills`
+
+Use this route when you want the task skills in Codex, OpenCode, Cursor, or other agent environments that support `npx skills`. For Claude Code, use the plugin installation flow above.
+
+```bash
+# Preview what will be installed
+npx skills add https://github.com/kazuph/reviw --list
+
+# Install all reviw skills globally for Codex
+npx skills add https://github.com/kazuph/reviw -g -a codex -s '*' --copy -y
+
+# Install all reviw skills globally for Codex and OpenCode
+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`.
 ```
 
 ### Plugin Directory Structure
@@ -174,9 +192,6 @@ This repository also serves as a Claude Code plugin marketplace. The plugin inte
 plugin/
 ├── .claude-plugin/
 │   └── plugin.json          # Plugin metadata (name, version, description)
-├── commands/
-│   ├── do.md                 # /reviw:do command definition
-│   └── done.md               # /reviw:done command definition
 ├── agents/
 │   ├── report-builder.md     # Report generation agent
 │   ├── e2e-health-reviewer.md    # E2E test health check
@@ -187,6 +202,20 @@ plugin/
 │   ├── review-copy-consistency.md # Text consistency
 │   └── review-e2e-integrity.md   # E2E test integrity
 ├── skills/
+│   ├── ask/
+│   │   └── SKILL.md          # Requirements elicitation skill
+│   ├── bucho/
+│   │   └── SKILL.md          # Manager orchestration skill
+│   ├── do/
+│   │   └── SKILL.md          # Task start skill
+│   ├── done/
+│   │   └── SKILL.md          # Task completion skill
+│   ├── tiny-do/
+│   │   └── SKILL.md          # Lightweight task start skill
+│   ├── tiny-done/
+│   │   └── SKILL.md          # Lightweight task completion skill
+│   ├── validate-report/
+│   │   └── SKILL.md          # Internal REPORT.md validation helper
 │   ├── artifact-proof/
 │   │   └── SKILL.md          # Evidence collection skill
 │   └── webapp-testing/
@@ -204,8 +233,11 @@ plugin/
 
 | Type | Name | Description |
 |------|------|-------------|
-| **Command** | `/reviw:do` | Start a task - create worktree with git wt, plan, register todos |
-| **Command** | `/reviw:done` | Complete checklist - run 7 review agents, collect evidence, start review |
+| **Task Skill** | `/reviw:do` | Start a task - create worktree with git wt, plan, register todos |
+| **Task Skill** | `/reviw:done` | Complete checklist - run 7 review agents, collect evidence, start review |
+| **Task Skill** | `/reviw:tiny-do` | Start a smaller task with the lightweight workflow |
+| **Task Skill** | `/reviw:tiny-done` | Finish a smaller task with lightweight review |
+| **Task Skill** | `/reviw:bucho` | Orchestrate Claude Code and Codex in manager mode |
 | **Agent** | `report-builder` | Prepare reports and evidence for user review |
 | **Agent** | `review-code-quality` | Code quality: readability, DRY, type safety, error handling |
 | **Agent** | `review-security` | Security: XSS, injection, OWASP Top 10, secrets detection |
@@ -221,7 +253,22 @@ plugin/
 
 ---
 
-### Commands
+### Task Skills
+
+#### Bundled task skills
+
+| Skill | Purpose |
+|------|---------|
+| `ask` | Clarify requirements, scope, constraints, and success criteria before implementation |
+| `bucho` | Orchestrate Claude Code and Codex as a managed team through tmux |
+| `check-yourself` | Force real verification instead of assumptions or lightweight spot checks |
+| `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 |
+| `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 |
+| `validate-report` | Internal helper used by `done` to validate `REPORT.md` against artifact-proof reporting rules |
 
 #### `/reviw:do <task description>`
 
@@ -243,7 +290,7 @@ Starts a new task with proper environment setup.
         └── videos/           # Video recordings
 ```
 
-**Task resumption:** When a session starts or after context compaction, the command checks for existing worktrees (via `git wt`) and resumes from `REPORT.md`.
+**Task resumption:** When a session starts or after context compaction, the skill checks for existing worktrees (via `git wt`) and resumes from `REPORT.md`.
 
 #### `/reviw:done`