Skip to content

revsystem/claude-code-plugins

BranchesTags

Repository files navigation

Claude Code Plugins - ドキュメント・コードレビュープラグイン

Claude Code License Version

技術記事レビュー、Terraformコードレビュー、AWSコスト分析を提供するClaude Code Pluginsです。文章校正、AWS公式ドキュメント検証、Terraformコードレビュー、AWSコスト最適化を組み合わせ、高品質な技術文書とインフラの作成をサポートします。

プラグイン一覧

プラグイン 概要 使い方 モデル
document-reviewer 技術記事の文章校正とAWS公式ドキュメント検証 /document-reviewer @article.md inherit
terraform-code-reviewer Terraformコードのセキュリティ・コスト・ベストプラクティスレビュー /terraform-code-reviewer sonnet
aws-cost-analyst AWSコスト分析・異常調査・最適化提案 エージェント（自然言語） sonnet

inherit は Claude Code の実行モデルを継承します。sonnet はコスト効率を考慮した明示指定です。

インストール

前提条件

  • Claude Code がインストールされていること
  • uvx がインストールされていること（AWS 系 MCP サーバーの起動に使用）
  • aws-cost-analyst を使用する場合: AWS CLIが設定済みで、Cost Explorer / Pricing API にアクセスできるプロファイルが必要（シェルの AWS_PROFILE 環境変数を自動参照）

インストール手順

Githubマーケットプレイスを追加する場合

  1. Githubリポジトリにあるマーケットプレイスを追加する
/plugin marketplace add revsystem/claude-code-plugins
  1. プラグインをインストールする

技術記事レビュープラグイン

/plugin install document-reviewer@document-and-code-reviewer

Terraformコードレビュープラグイン

/plugin install terraform-code-reviewer@document-and-code-reviewer

AWSコスト分析プラグイン

/plugin install aws-cost-analyst@document-and-code-reviewer
  1. プラグインを有効化する
/plugin enable

document-and-code-reviewer を選択してEnterキーを押します。

╭─────────────────────────────╮
│ Manage plugins                                           │
│ Select a marketplace to manage plugins:                  │
│                                                          │
│ ❯ document-and-code-reviewer                             │
│   3 plugins installed · 3 disabled                       │
╰─────────────────────────────╯

有効にしたいプラグインを選択して Enable plugin を選択してEnterキーを押します。

╭─────────────────────────────╮
│ document-and-code-reviewer › Manage plugins              │
│                                                          │
│ ❯ ◯ document-reviewer                                   │
│     Review blog articles. · v0.0.4                       │
│                                                          │
│   ◯ terraform-code-reviewer                             │
│     Review Terraform code. · v0.0.4                      │
│                                                          │
│   ◯ aws-cost-analyst                                    │
│     AWS cost analysis. · v0.0.4                          │
╰─────────────────────────────╯
╭─────────────────────────────╮
│ ❯ Enable plugin                                          │
│   Mark for update                                        │
│   Mark for uninstallation                                │
│   Update now                                             │
│   Uninstall now                                          │
│   Back to plugin list                                    │
╰─────────────────────────────╯

ローカルマーケットプレイスを追加する場合

  1. リポジトリをクローンする
git clone https://github.com/revsystem/claude-code-plugins.git
cd claude-code-plugins
  1. ローカルマーケットプレイスとして追加
/plugin marketplace add ./claude-code-plugins
  1. プラグインをインストール

技術記事レビュープラグイン

/plugin install document-reviewer@document-and-code-reviewer

Terraformコードレビュープラグイン

/plugin install terraform-code-reviewer@document-and-code-reviewer

AWSコスト分析プラグイン

/plugin install aws-cost-analyst@document-and-code-reviewer
  1. プラグインを有効化する

前述の、Githubマーケットプレイスを追加する場合の手順を参照してください。

AWS_PROFILE の設定（aws-billing-cost-management / aws-pricing MCPサーバー）

AWS Billing Cost Management MCPサーバーと AWS Pricing MCPサーバーは AWS API にアクセスするため、AWS_PROFILE 環境変数の設定が必要です。

MCPサーバー設定ファイルは ${AWS_PROFILE:-default} 構文を使用しており、シェル環境の AWS_PROFILE を自動的に参照します。未設定の場合は AWS CLI の default プロファイルが使用されます。

シェルで環境変数を設定する

# ~/.bashrc や ~/.zshrc に追加
export AWS_PROFILE=your-aws-profile

設定するプロファイルには、Cost Explorer API と Pricing API へのアクセス権限が必要です。

MCPサーバー設定ファイルの場所（直接編集する場合）

~/.claude/plugins/marketplaces/document-and-code-reviewer/mcps/
├── aws-billing-cost-management-mcp-server.json
└── aws-pricing-mcp-server.json

使用方法

1. document-reviewer - 技術記事レビュー

基本的な使用方法

# 記事全体をレビュー
/document-reviewer @your_article.md
# 特定のセクションをレビュー
/document-reviewer --section "設定手順" @your_article.md
# レビューレベルの指定 (strict/normal/quick)
/document-reviewer --level strict @your_article.md

2. terraform-code-reviewer - Terraformコードレビュー

基本的な使用方法

# Terraformコード全体をレビュー
/terraform-code-reviewer
# 特定のファイルをレビュー
/terraform-code-reviewer --file main.tf
# 特定の観点でレビュー (security/cost/performance/best-practices)
/terraform-code-reviewer --focus security
# レビューレベルの指定 (strict/normal/quick)
/terraform-code-reviewer --level strict

レビューの目的や観点を指定することで、より詳細なレビューが得られます。

# レビュー対象のファイルを指定
/terraform-code-reviewer --level strict Terraformのコードをレビューして。ALBのセキュリティレベルを向上させたい。

3. aws-cost-analyst - AWSコスト分析

aws-cost-analyst はコマンドではなくエージェントとして動作します。自然言語でコスト分析を依頼してください。

# 既存リソースのコスト分析
先月のAWSコストを分析して、サービス別の内訳を教えて。

# 異常コストの調査
今月のAWSコストが急増している原因を調べて。

# コスト最適化の提案
AWSコストの最適化ポイントを特定して、削減額を試算して。

出力例

document-reviewer の出力例

📊 レビュー結果サマリー
- 重大な問題: 3件
- 推奨修正: 7件
- 追加提案: 4件
- 総合評価: B+ (良好、一部改善推奨)

🔴 重大な問題
❌ **技術的誤り**: API エンドポイントの記述が不正確
- 現在の記載: "https://api.example.com/v1"
- 正しい情報: "https://api.example.com/v2"
- 参照先: https://docs.aws.amazon.com/...
- 修正理由: 古いバージョンのAPIを使用しているため

🟡 推奨修正
⚠️ **表現の改善**: より読みやすい文章への修正
- 現在の表現: "この機能を使用することにより..."
- 推奨表現: "この機能を使うと..."
- 改善理由: より簡潔で理解しやすい表現

terraform-code-reviewer の出力例

## 高優先度

### main.tf:12 セキュリティグループがSSHを0.0.0.0/0に開放

現在のコード:
  cidr_blocks = ["0.0.0.0/0"]
修正後:
  cidr_blocks = [var.admin_cidr]
理由: SSHポートの全開放は侵入リスクが高い。接続元を管理用CIDRに限定する。
参照: https://docs.aws.amazon.com/vpc/latest/userguide/security-group-rules.html

## 中優先度

### main.tf:34 インスタンスタイプの見直し

現在のコード:
  instance_type = "t3.large"
修正後:
  instance_type = "t3.medium"
理由: ワークロードに対して過剰なサイズ。月額コスト約30%削減が見込める。
参照: https://docs.aws.amazon.com/ec2/latest/instancetypes/gp.html

aws-cost-analyst の出力例

📊 コスト分析サマリー
- 分析期間: 2026-01-01 〜 2026-01-31
- 総コスト: $3,245.67
- 前月比: +12.3%

## サービス別コスト内訳
| サービス       | コスト     | 割合  | 前月比  |
|---------------|-----------|-------|--------|
| Amazon EC2    | $1,523.45 | 46.9% | +8.2%  |
| Amazon RDS    | $867.23   | 26.7% | +15.1% |
| Amazon S3     | $234.56   | 7.2%  | +3.4%  |
| その他         | $620.43   | 19.1% | +18.7% |

## コスト最適化の推奨事項
| 推奨事項                          | 推定削減額  | 難易度 | 優先度 |
|----------------------------------|-----------|--------|--------|
| EC2 Savings Plans 適用            | $380/月   | 低     | 高     |
| 未使用EBSボリューム削除             | $45/月    | 低     | 高     |
| RDS インスタンスサイズの見直し       | $120/月   | 中     | 中     |

アーキテクチャ

プラグイン構成

claude-code-plugins/
├── .claude-plugin/
│   └── marketplace.json                   # マーケットプレイス設定
├── document-reviewer/                     # 技術記事レビュープラグイン
│   ├── agents/
│   │   ├── article-reviewer.md                # 文章校正エージェント
│   │   ├── official-document-checker.md       # AWS公式ドキュメント検証エージェント
│   │   └── resources/
│   │       └── terminology-standards.md       # 用語規約リソース
│   ├── commands/
│   │   └── document-reviewer.md               # 技術記事統合レビューコマンド
│   └── mcps/
│       └── aws-knowledge-mcp-server.json      # AWSナレッジベース検索
├── terraform-code-reviewer/               # Terraformコードレビュープラグイン
│   ├── agents/
│   │   └── terraform-code-reviewer.md         # Terraformコードレビューエージェント
│   ├── commands/
│   │   └── terraform-code-reviewer.md         # Terraformコードレビューコマンド
│   └── mcps/
│       └── aws-knowledge-mcp-server.json      # AWSナレッジベース検索
└── aws-cost-analyst/                      # AWSコスト分析プラグイン
    ├── agents/
    │   └── aws-cost-analyst.md                # AWSコスト分析エージェント
    └── mcps/
        ├── aws-billing-cost-management-mcp-server.json  # AWS Billing Cost Management MCP
        └── aws-pricing-mcp-server.json                  # AWS Pricing MCP

MCP サーバーの重複（aws-knowledge-mcp-server）は Claude Code の自動重複排除機能により、ランタイムで1インスタンスのみ起動されます。各プラグインの自己完結性を優先し、意図的に重複を許容しています。

設定

レビューレベル

  • strict: 最も厳格なレビュー（本格的な公開前）
  • normal: 標準的なレビュー（日常的な使用）
  • quick: 簡易レビュー（素早い確認）

カスタマイズ

各エージェントの設定は、対応するMarkdownファイルを編集することで変更できます：

  • agents/article-reviewer.md: 文章校正ルールの調整
  • agents/official-document-checker.md: 技術検証ルールの調整
  • agents/terraform-code-reviewer.md: Terraformコードレビュールールの調整
  • agents/aws-cost-analyst.md: AWSコスト分析ルールの調整
  • agents/resources/terminology-standards.md: 用語規約の調整

ライセンス

このプロジェクトは MIT License の下で公開されています。

About

Provide a plugins for reviewing the documents and code.

Resources

Readme

License

MIT license
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases 10

v0.0.10 Latest
Jul 11, 2026
+ 9 releases

Packages

 
 
 

Contributors