
shiiman-common
共通開発ツール - ローカル変更の統合レビュー(Claude + Codex + セキュリティ + Simplify)、AI CLI 一括更新を提供
- version
- 1.5.3
- GitHub stars
- 7
Install
/plugin install shiiman-common@shiiman-claude-code-pluginsRun it inside Claude Code after adding the marketplace with /plugin marketplace add shiiman/claude-code-plugins.
Contents
Discovered from sourceSkills 2
Brew Upgrade AI
AI 関連 CLI ツールを brew で一括アップグレードします。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-common:brew-upgrade-ai - AI ツール一括更新
概要:
AI 関連 CLI ツール(claude-code@latest, codex, cursor-cli, gemini-cli)を
brew で一括アップグレードします。
使用方法:
/shiiman-common:brew-upgrade-ai [オプション]
オプション:
--help このヘルプを表示
例:
/shiiman-common:brew-upgrade-ai # AI ツールを一括更新
対象ツール
| brew パッケージ名 | ツール名 |
|---|---|
| claude-code@latest(fallback: claude-code) | Claude Code |
| codex | Codex |
| cursor-cli | Cursor CLI |
| gemini-cli | Gemini CLI |
ワークフロー
1. 現在のバージョン確認
Bash ツールで以下を並列実行し、各ツールのインストール状態・パッケージ種別・現在のバージョンを取得:
brew list --cask --versions claude-code@latest 2>/dev/null || brew list --cask --versions claude-code 2>/dev/null || brew list --versions claude-code 2>/dev/null || echo "NOT_INSTALLED"brew list --cask --versions codex 2>/dev/null || brew list --versions codex 2>/dev/null || echo "NOT_INSTALLED"brew list --cask --versions cursor-cli 2>/dev/null || brew list --versions cursor-cli 2>/dev/null || echo "NOT_INSTALLED"brew list --cask --versions gemini-cli 2>/dev/null || brew list --versions gemini-cli 2>/dev/null || echo "NOT_INSTALLED"
判定ルール:
brew list --cask --versionsで取得できた場合:type=cask、出力先頭トークンを実際のパッケージ名として記録(例:claude-code@latest)brew list --versionsで取得できた場合:type=formula、コマンドに渡したパッケージ名をそのまま記録- どちらも取得できない場合:
NOT_INSTALLED
未インストール(NOT_INSTALLED)のツールはスキップ対象として記録。手順 2・3 では記録したパッケージ名を使う。
2. アップグレード実行
インストール済みのツールのみ、判定された type に応じて Bash ツールで並列実行:
type=caskの場合:brew upgrade --cask <package> 2>&1type=formulaの場合:brew upgrade <package> 2>&1
各コマンドの出力から以下を判定:
- 更新済み: バージョンが変わった場合
- 最新: 以下のいずれかを含む場合
already installedalready up-to-dateNot upgrading
- エラー: その他のエラー出力
3. 新バージョン確認
インストール済みツールについて、type に応じたコマンドを 並列実行 して新バージョンを取得:
type=caskの場合:brew list --cask --versions {パッケージ名}type=formulaの場合:brew list --versions {パッケージ名}
4. 結果表示
以下のフォーマットで結果を出力:
## AI ツール更新結果
| ツール | 旧バージョン | 新バージョン | 状態 |
| ------------------ | ------------ | ------------ | -------------- |
| claude-code@latest | x.x.x | y.y.y | 更新済み |
| codex | x.x.x | x.x.x | 最新 |
| cursor-cli | - | - | 未インストール |
| gemini-cli | x.x.x | y.y.y | 更新済み |
> 「ツール」列には手順 1 で記録した実際のパッケージ名(Claude Code なら `claude-code@latest` または `claude-code`)を表示する。
状態の表記:
| 状態 | 条件 |
|---|---|
| 更新済み | バージョンが変わった |
| 最新 | 既に最新バージョン |
| 未インストール | brew にパッケージが存在しない |
| エラー | upgrade コマンドが失敗(エラー詳細付記) |
重要な注意事項
- ✅
claude-code/codex/cursor-cliは環境によって cask 管理の場合があるため、必ずcask→formulaの順で確認する - ✅ Claude Code は
claude-code@latest(cask) →claude-code(cask) →claude-code(formula)の順で確認し、ヒットしたパッケージ名を upgrade・再確認でそのまま使う - ✅ 未インストールのツールはスキップ(エラーにしない)
- ✅ 各 brew upgrade は並列実行して高速化
- ✅ 旧バージョン・新バージョンを比較して状態を判定
- ❌ 未インストールのツールを自動インストールしない
- ❌ brew 以外のパッケージマネージャは使用しない
Review
ローカル変更を Claude + Codex + セキュリティ + Simplify の 4 観点で並列レビューし、統合結果を表示します。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-common:review - 統合レビュー
概要:
ローカル変更を 4 つの観点(コード品質・セキュリティ・Codex・Simplify)で
並列レビューし、統合結果を表示します。
使用方法:
/shiiman-common:review [オプション]
オプション:
--help このヘルプを表示
例:
/shiiman-common:review # ローカル変更をレビュー
ワークフロー
1. 変更差分の取得
Bash ツールで以下を並列実行して変更差分を取得:
git diff— ステージされていない変更git diff --cached— ステージ済み変更
両方とも空の場合は以下を表示して終了:
レビュー対象の変更がありません。
変更をステージするか、ファイルを編集してから再実行してください。
すべてのレビュアーは読み取り専用で実行し、ソース・index・コミット・外部サービスを変更しない。修正も依頼されている場合でも、子レビュアーは指摘だけを返し、親が検証して修正する。呼び出すスキルが読み取り専用であることを保証できなければ、変更を伴う呼び出しを省略して理由を報告する。
2. 4 エージェント並列レビュー
Task ツールで以下の 4 エージェントを並列起動する。 2-1 と 2-3 には取得した diff の全文をプロンプトに含める。 2-2 と 2-4 はビルトインスキルを実行するため、diff の受け渡しは不要。
2-1. Claude 品質レビュー(subagent_type: general-purpose)
8 つの観点で並列レビューを実行し、結果を統合して返す。
プロンプト:
以下の diff を 8 つの観点で並列レビューしてください。
Task ツールで以下の 8 エージェントを**並列起動**してください。
各エージェントは subagent_type: general-purpose で起動してください。
各エージェントに diff 全文を渡してください。
diff:
{diff全文}
--- エージェント一覧 ---
【1. コード品質】
以下の diff をコード品質の観点でレビューしてください。
観点: 命名規則の一貫性、コード構造、重複コード(DRY違反)、不要なコード
結果はマークダウンで、指摘ごとに「ファイル:行番号」を含めてください。
指摘がない場合は「指摘なし」と出力してください。
【2. 設計】
以下の diff を設計の観点でレビューしてください。
観点: 責務分離(SRP)、凝集度、結合度、抽象化レベル、依存関係の方向
結果はマークダウンで、指摘ごとに「ファイル:行番号」を含めてください。
指摘がない場合は「指摘なし」と出力してください。
【3. テスト】
以下の diff をテストの観点でレビューしてください。
観点: テスト漏れ、エッジケースの未考慮、テストの信頼性(flaky)、カバレッジ不足
結果はマークダウンで、指摘ごとに「ファイル:行番号」を含めてください。
指摘がない場合は「指摘なし」と出力してください。
【4. 可読性】
以下の diff を可読性の観点でレビューしてください。
観点: コメントの適切さ、フォーマット、循環的複雑度、ネストの深さ、関数の長さ
結果はマークダウンで、指摘ごとに「ファイル:行番号」を含めてください。
指摘がない場合は「指摘なし」と出力してください。
【5. パフォーマンス】
以下の diff をパフォーマンスの観点でレビューしてください。
観点: N+1クエリ、メモリリーク、アルゴリズム計算量(O(n²)等)、不要な再描画・再計算、リソースの未解放
結果はマークダウンで、指摘ごとに「ファイル:行番号」を含めてください。
指摘がない場合は「指摘なし」と出力してください。
【6. エラーハンドリング】
以下の diff をエラーハンドリングの観点でレビューしてください。
観点: 例外処理の漏れ、エラー伝播の不備、リカバリー戦略、入力バリデーション不足、静かな失敗(silent failure)
結果はマークダウンで、指摘ごとに「ファイル:行番号」を含めてください。
指摘がない場合は「指摘なし」と出力してください。
【7. ベストプラクティス】
以下の diff をベストプラクティスの観点でレビューしてください。
観点: 言語固有のイディオム違反、アンチパターン、非推奨APIの使用、モダンな代替手段の提案
結果はマークダウンで、指摘ごとに「ファイル:行番号」を含めてください。
指摘がない場合は「指摘なし」と出力してください。
【8. 保守性】
以下の diff を保守性の観点でレビューしてください。
観点: 循環的複雑度、モジュール間の依存関係、将来の変更容易性、ドキュメントの十分性、技術的負債
結果はマークダウンで、指摘ごとに「ファイル:行番号」を含めてください。
指摘がない場合は「指摘なし」と出力してください。
--- 結果統合 ---
全エージェントの結果を以下のフォーマットで統合して返してください:
#### コード品質
{エージェント1の結果}
#### 設計
{エージェント2の結果}
#### テスト
{エージェント3の結果}
#### 可読性
{エージェント4の結果}
#### パフォーマンス
{エージェント5の結果}
#### エラーハンドリング
{エージェント6の結果}
#### ベストプラクティス
{エージェント7の結果}
#### 保守性
{エージェント8の結果}
2-2. セキュリティレビュー(subagent_type: general-purpose)
ビルトイン /security-review スキルを利用する。
プロンプト:
ビルトイン `/security-review` スキルを実行してください。
手順:
1. ToolSearch ツールで Skill ツールをロード:
query: "select:Skill"
2. Skill ツールを呼び出し、skillName に "security-review" を指定:
引数は不要です(スキルが自動で git diff / git status を実行します)。
実行後、スキルの出力結果をそのまま返してください。
スキルが見つからない場合やエラーが発生した場合は、エラーメッセージをそのまま返してください。
2-3. Codex レビュー(subagent_type: general-purpose)
codex review CLI を読み取り専用で直接呼び出す(CLAUDE_PLUGIN_ROOT が未設定でも動作するよう Skill 経由ではなく CLI を使用)。
プロンプト:
コードを変更せず、codex review CLI で指摘だけを報告してください。
1. gh repo view --json defaultBranchRef -q '.defaultBranchRef.name' でデフォルトブランチを取得する。
2. codex review --base <デフォルトブランチ名> を実行する。
3. 実行中は状態を確認し、完了したら出力結果を返す。
コマンドや必要な機能が利用できなければ理由を報告し、編集や外部投稿で代替しない。
2-4. Simplify レビュー(subagent_type: general-purpose)
再利用・品質・効率の観点で読み取り専用レビューを行う。
プロンプト:
変更コードの再利用・品質・効率を調べ、指摘だけを返してください。編集・自動修正は禁止です。
/simplify を利用する場合は、まず読み取り専用で実行できるか確認してください。
保証できる場合だけ Skill を呼び出し、「指摘のみ。ファイル編集・自動修正は禁止」と指定してください。
保証できなければ /simplify を呼び出さず、同じ観点を自身で読み取り専用レビューしてください。
スキルが利用できなかった場合はその理由も報告してください。
3. 統合レポート出力
4 エージェントの結果を以下のフォーマットで統合して出力:
## 統合レビュー結果
### 1. コード品質レビュー (Claude) — 8 観点並列
{コード品質 / 設計 / テスト / 可読性 / パフォーマンス / エラーハンドリング / ベストプラクティス / 保守性}
### 2. セキュリティレビュー
{/security-review の出力結果}
### 3. Codex レビュー
{codex review の出力}
### 4. Simplify レビュー
{/simplify の出力結果}
### サマリー
- 重要指摘: {count} 件
- 改善提案: {count} 件
- 総合判定: {OK / 要修正}
カウントルール:
- 重要指摘: セキュリティリスク「高」 + コード品質の重大な問題
- 改善提案: それ以外の指摘すべて
- 総合判定: 重要指摘が 0 件なら「OK」、1 件以上なら「要修正」
3.5. レビュー結果をファイルに保存
統合レポートをコンソール表示した後、.claude/tmp/ にマークダウンファイルとして保存する。
手順
- Bash ツールでタイムスタンプとリポジトリ情報を取得:
TS="$(date +%Y%m%d-%H%M%S)"
DATE="$(date +%Y-%m-%d)"
REPO_NAME="$(basename "$(git rev-parse --show-toplevel 2>/dev/null || pwd)")"
BRANCH="$(git branch --show-current 2>/dev/null || echo 'unknown')"
REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
mkdir -p "${REPO_ROOT}/.claude/tmp"
echo "${TS}|${DATE}|${REPO_NAME}|${BRANCH}|${REPO_ROOT}"
- Write ツールで
{REPO_ROOT}/.claude/tmp/{TS}-review.mdを作成。以下のテンプレートに沿って、4 エージェントの結果を統合して記述する:
# 統合レビューレポート
**実施日**: {DATE}
**対象**: {REPO_NAME}
**ブランチ**: {BRANCH}
**調査カテゴリ**: コード品質 / セキュリティ / Codex / Simplify
---
## 概要
{REPO_NAME} に対し、4つの観点から並列レビューを実施した。
各観点で専門的な分析を行い、検出された問題点を統合して優先度付きのタスクリストとしてまとめた。
| カテゴリ | 評価 | 検出数 |
| ---------------------------------- | -------- | ------ |
| 📝 コード品質 (Claude / 8 観点) | 🟢/🟡/🔴 | N |
| 🔒 セキュリティ (/security-review) | 🟢/🟡/🔴 | N |
| 🤖 Codex | 🟢/🟡/🔴 | N |
| 🔧 Simplify (/simplify) | 🟢/🟡/🔴 | N |
---
## 結論
**総合評価**: 🟢/🟡/🔴 [1行で総評]
[2-3行で具体的な結論。最も重要な発見と推奨アクションを凝縮]
> [!IMPORTANT]
> {最重要の横断的課題(なければ省略)}
---
## 問題点
{全問題を優先度順(P1→P2→P3)にフラットに一覧。該当なしの場合は「指摘なし」。以下のチェックボックスリスト形式で記述}
各問題点は以下のチェックボックスリスト形式で記述(P1 → P2 → P3 の順序で並べる):
- [ ] `{ID}` | {優先度} | {カテゴリアイコン}{カテゴリ名} | {概要}
<details>
<summary>詳細</summary>
**該当箇所**: `{ファイル:行}`
**詳細**: {問題の詳細説明}
**修正案**: {具体的な修正案}
</details>
ID 体系: QUAL-NNN(コード品質 8 観点)/ SEC-NNN(セキュリティ)/ CDX-NNN(Codex)/ SMP-NNN(Simplify)
優先度基準:
- 🔴P1 = Critical/High のセキュリティ、データ損失リスク
- 🟠P2 = 中程度のセキュリティ、重要な品質問題
- 🟡P3 = コード品質改善、軽微な指摘
セキュリティ重症度マッピング(ビルトイン /security-review の出力形式に対応):
- Critical / High → 🔴P1
- Medium → 🟠P2
- Low / Informational → 🟡P3
評価の判定基準:
- 🟢 検出数 0 件
- 🟡 軽微な指摘のみ(P3 のみ)
- 🔴 重要指摘あり(P1 または P2 が存在)
- ファイル保存後にパスをユーザーに表示:
📄 レビュー結果を保存しました: {REPO_ROOT}/.claude/tmp/{TS}-review.md
4. 修正が依頼されているかの判断
レビューだけの依頼では、ソースを編集せず指摘を報告して終了する。次の対応を選択する質問はしない。
指摘の修正も依頼されている場合、または許可済みの実装タスク内のレビューである場合は、範囲内の修正を追加確認せず進める。提案を機械的に適用せず、正しさを調べて無関係な作業を保護する。重要な範囲変更や未許可の高影響操作についてだけ確認する。
5. 修正の検証
実際の修正に応じたチェックを実行し、変更・検証・残る指摘を報告する。レビューや修正の許可だけでは、コミット・push・PR 作成・外部サービスへのコメント投稿は許可されない。
重要な注意事項
- ✅ 4 エージェントは必ず並列起動する(Task ツールの並列呼び出し)
- ✅ diff が空の場合は早期終了する
- ✅ codex:review スキルが未対応でもエラーにしない
- ✅ /simplify スキルが未対応でもエラーにしない
- ✅ 統合レポートは
.claude/tmp/{TS}-review.mdにも保存する - ❌ diff なしでレビューを実行しない
- 依頼または親の実装タスクで許可されている場合だけ修正し、重複確認は求めない。
Sponsors
Details
- Marketplace
- shiiman/claude-code-plugins
- Source
- plugins/shiiman-common
- Category
- Developer Tools