convez.ai
SkillAutomaçãoIntermediário
VoidAxon

Prompt Cookbook

VoidAxon/prompt-cookbook

Skills e prompts reutilizáveis para Claude Code e fluxos Git

Ver no GitHub
InicialPluginScore · de 0 a 100

Coleção de skills customizadas (slash commands) e prompts para Claude Code. Inclui automação de mensagens de commit, descrições de PR, análise de imagens, geração de testes e busca de PRs em repositórios. Facilita workflows repetitivos em desenvolvimento com Python.

Instalação

$npx convez-ai VoidAxon/prompt-cookbook

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Gerar mensagens de commit formatadas automaticamente
  • Criar descrições de PR estruturadas para review
  • Analisar imagens diretamente via CLI
  • Gerar especificações de teste a partir de diffs
  • Buscar e consolidar PRs em múltiplos repositórios

Veredito

Skill bem estruturada e prática para equipes que usam Claude Code no fluxo Git diário. Reduz overhead de documentação manual, especialmente em testes. Requer setup inicial e conhecimento de Python/CLI, mas retorno é alto em produtividade.

README

A tradução para o português deste README ainda está na fila.

prompt-cookbook

Claude Code 用のカスタムスキル(スラッシュコマンド)とプロンプト集。

セットアップ

グローバル(全プロジェクトで使用)

~/.claude/skills/ 以下に置くだけで自動的に全プロジェクトで有効になります。

git clone https://github.com/voidaxon/prompt-cookbook.git ~/.claude/skills/prompt-cookbook

プロジェクト単位(特定プロジェクトでのみ使用)

git submodule として追加する場合

cd your-project
git submodule add https://github.com/voidaxon/prompt-cookbook.git .claude/skills/prompt-cookbook

特定スキルだけ使いたい場合はシンボリックリンク

# グローバルにクローン済みの前提
ln -s ~/.claude/skills/prompt-cookbook/git/commit-msg .claude/skills/commit-msg
ln -s ~/.claude/skills/prompt-cookbook/git/pr-desc    .claude/skills/pr-desc

スキル一覧

git

スキルコマンド概要
commit-msg/commit-msg <mode> [context]規約に沿った日本語コミットメッセージを生成
pr-desc/pr-desc <mode> [context]レビュアー向けの日本語 PR 説明文を生成

tools

スキルコマンド概要
snap/snap [prompt]クリップボードの画像を Claude CLI から直接分析
snappath/snappathクリップボードの画像を一時ファイルに保存しパスを返す
generate-testdoc/generate-testdoc pr <no>PRまたはコミットの差分からテスト仕様書(Excel)を生成
find-prs/find-prs <keyword> [opts]組織横断で PR タイトル検索し、oneline/tree/table で出力

使い方

各スキルは <mode> と任意の [context] を引数に取ります。

mode

値説明
stageステージングされた差分から生成
latest直近のコミット履歴から生成
commit <id>指定したコミット ID から生成

context(任意)

チケット番号・背景・注意点など、差分だけでは伝わらない補足情報を渡せます。

/commit-msg stage ABC-123 ログイン画面のバリデーション追加
/pr-desc latest
/pr-desc commit a1b2c3d

サンプル出力は各スキルの examples.md を参照してください。


generate-testdoc

PRまたはコミットの差分を解析し、変更された箇所のみを対象としたテスト観点・テストケースを Excel テンプレートへ出力するスキル。

必要な環境

依存用途
Python 3.8 以上Excel 生成スクリプトの実行
openpyxlExcel ファイルの読み書き
gh CLI--pr 指定時の PR 差分・説明文取得
# Python パッケージのインストール
pip install openpyxl

# gh CLI の認証(--pr を使う場合)
gh auth login

セットアップ

# スキルディレクトリにコピー
cp -r tools/generate-testdoc ~/.claude/skills/generate-testdoc

使い方

--pr を使う場合(最も一般的)

PR タイトルが 1234 患者一覧の検索条件修正 のように KintoneID タイトル の形式であれば、PR 番号だけで実行できます。KintoneID とタイトルは PR タイトルから自動的に抽出されます。

/generate-testdoc pr 456
/generate-testdoc pr 456 repo medley-inc/mall3   # 別リポジトリ

KintoneID・タイトルを手動指定する場合

commit やステージング差分を使う場合は明示的に指定します。

/generate-testdoc 1234 患者一覧の検索条件修正 commit abc1234
/generate-testdoc 1234 患者一覧の検索条件修正

出力

Excel ファイルが ~/Documents/docs/testcase/【{KintoneID}】 {Title}.xlsx に生成されます。

シート内容
テスト観点シートB列: No.、C列: テスト観点グループ名、D列: 確認項目(箇条書き)
テストケースシートA列: 項番、B列: テスト名、C列: 前提条件、D列: 操作手順、E列: 期待値

テスト観点の設計方針

差分の変更種別・リスク度に応じて以下の7角度をテスト設計の思考チェックリストとして活用する。7角度は AI がテストケースを漏れなく生成するための思考軸であり、シートには機能エリア単位のグループ名と確認項目が出力される。

#テスト観点主な用途
①正常系通常フロー・設定通りの初期表示
②異常系・堅牢性null・空文字・型不一致・例外スロー確認
③境界値・極限最大/最小値・境界±1・日付の年跨ぎ・うるう年
④権限・セキュリティ権限あり/なし・越権アクセス
⑤操作性・UXリアルタイムフィードバック・即時反映
⑥連携・複合条件他機能との組み合わせ・相互影響
⑦回帰確認既存機能への変更影響なし(常に追加)

find-prs

GitHub 組織配下の全リポジトリから PR タイトルを検索し、結果を oneline / tree / table の 3 形式で整形出力するスキル。同じ要件の修正が複数の長期ブランチに分散している状況で、横断的に確認・コピペするのに使う。

必要な環境

依存用途
gh CLIPR 検索と base 分支取得
PowerShell(Windows のみ)--copy 明示時に oneline 結果をクリップボードへコピー
gh auth login

使い方

/find-prs <keyword> [--org <name>] [--state <s>] [--format <f>] [--copy|--no-copy]
オプション既定値域説明
<keyword>—任意文字列PR タイトル検索キーワード(例: 1234、患者一覧)
--orgmedley-inc任意組織名GitHub 組織名
--stateallopen / closed / merged / allPR 状態フィルタ
--formattableoneline / tree / table(カンマ区切り併用可)出力形式
--copy / --no-copy--no-copyフラグ--copy 明示指定時のみ Windows でクリップボードへコピー(既定はコピーしない)
/find-prs 1234                                          # 既定: table 形式、コピーなし
/find-prs 1234 --state merged --format tree,oneline     # merged のみ・tree と oneline 併用
/find-prs 1234 --format oneline --copy                  # oneline をクリップボードへコピー

出力形式

形式用途
onelineExcel / Kintone 等に貼り付ける 1 行サマリ(例: mall4最新(#12), release-2025(#13), mall3最新(#34))
treerepo / 分支 / URL をプレフィックス・インデント無しのフラット行リストで表示(repo 名は単独行、分支行は 分支名: URL で識別)
tableブランチ・PR#・State・URL の表形式。タイトルが共通プレフィックスで 1 つに集約できる場合は Title 列を除いて表上に 1 行表示、複数の異なるタイトルが残る場合は Title 列に表示

いずれの形式でも repo グループ単位で連続出力されます。medley-inc 既定の repo 優先順位は mall4 → mall3 → mall-jinei → その他(辞書順)。各 repo 内では develop を先頭にし、他分支は分支名の辞書順で並びます。

table の Title 扱いは、共通プレフィックス集約後の残り件数で切り替わります:

  • 1 件(例: 163092 ... と 163092 ... m3-202508 のように末尾だけ違う)→ Title 列を削除し、表上に **Title:** ... を 1 行表示
  • 2 件以上(明らかに異なるタイトル群)→ Title 列を表内に保持

詳細仕様は tools/find-prs/SKILL.md、出力サンプルは tools/find-prs/examples.md を参照してください。


ディレクトリ構成

prompt-cookbook/
├── git/
│   ├── commit-msg/
│   │   ├── SKILL.md
│   │   └── examples.md
│   └── pr-desc/
│       ├── SKILL.md
│       └── examples.md
└── tools/
    ├── snap/
    │   ├── SKILL.md
    │   └── snap.ps1              # スタンドアロン利用時の PowerShell スクリプト
    ├── snappath/
    │   └── SKILL.md
    ├── find-prs/
    │   ├── SKILL.md
    │   └── examples.md
    └── generate-testdoc/
        ├── SKILL.md
        ├── scripts/
        │   └── generate_testdoc.py   # Excel 生成スクリプト(要 Python + openpyxl)
        └── templates/
            └── test_spec_template.xlsx
Ver o original no GitHub

Bom para

Relacionados