Communityライティング&編集github.com

AnjanJ/shipkit

Claude Codeを使用して優れたコードをリリースするためのスキル、エージェント、ルール、ナレッジベースです。codeberg.org/AnjanJ/shipkit のミラーです。

shipkit とは?

このスキルは、Claude Code上で動作する包括的な品質保証(QA)ワークフローを提供します。最近変更されたファイルや特定のファイルを対象に、偵察、質問、テスト計画、仕様作成、実行・検証の5フェーズにわたって徹底的なQAを実行します。テストフレームワークの自動検出、リスクレベルに基づくファイル分類、ユーザーへの事前質問によるテスト方針の確認など、実践的なテスト開発手法を支援します。各フェーズでは、変更内容の分析、テストケースの構造化、そして最終的な出荷判断(SHIP IT / FIX AND RE-TEST / NEEDS REWORK)までを一貫して行います。

対応✓Claude Code~Codex CLI~Cursor
npx skills add AnjanJ/shipkit

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

/qa — 品質保証ワークフロー

このスキルを実行すると、最近の変更または特定のファイルに対して徹底的なQAを実行します。

最近変更されたファイル

!git diff --name-only HEAD~1 2>/dev/null | head -20 || echo "最近の変更は検出されませんでした"

フェーズ1: 偵察

  1. テストフレームワークを検出 — 以下のファイルを確認:
    • Gemfile に rspec/minitest → RSpec または Minitest
    • mix.exs → ExUnit
    • package.json に jest/vitest → Jest または Vitest
    • playwright.config → Playwright
  2. 変更されたファイルを特定 — $ARGUMENTS がファイルパスの場合はそれを使用し、それ以外の場合は git diff --name-only HEAD~1 を実行
  3. 各ファイルをリスクレベルで分類:
    • CRITICAL: 認証、支払い、データモデル、共有ユーティリティ、APIエンドポイント
    • HIGH: ビジネスロジック、サービス、コントローラー
    • MEDIUM: ビュー、シリアライザー、ヘルパー、設定
    • LOW: ドキュメント、コメント、フォーマット
  4. 各変更ファイルとその既存テスト(あれば)を読み取る。 約5ファイル以上変更がある場合は、この読み取りを codebase-explorer エージェントに委譲し、その要約から作業する — メインコンテキストは質問とテストのために確保する。
  5. コンテキストテーブルを作成:
ファイル種類リスク既存テスト?
............

フェーズ2: 質問

テストを書く前に、AskUserQuestion を使用して3~8個の質問を行います。 質問はグループ化し、一度に1つずつ尋ねないでください。

良い質問(リスクに焦点):

  • 「これは支払いフローに影響します。返金のエッジケースをテストすべきですか?」
  • 「新しいバリデーションは空入力を拒否します。Unicodeのみの文字列はどうしますか?」
  • 「このサービスは外部APIを呼び出しています。モックにするか、統合テストをすべきですか?」

悪い質問(これらは尋ねない):

  • 「このコードは何をしますか?」(自分で読むこと)
  • 「テストを書くべきですか?」(はい、常に)
  • 「どのテストフレームワークを使うべきですか?」(検出すること)

フェーズ3: テスト計画

仕様を書く前に、構造化されたテスト計画を提示してください。 カテゴリ別に整理:

テストカテゴリ

  1. ハッピーパス — 期待される入力が期待される出力を生成する
  2. エッジケース — 境界値、空入力、最大値、nil/null
  3. エラーケース — 無効な入力、ネットワーク障害、タイムアウト、権限拒否
  4. 異常/攻撃的 — SQLインジェクション文字列、スクリプトタグ、絵文字、10MB文字列、同時アクセス
  5. パフォーマンス — N+1クエリ、無制限コレクション、低速クエリ(CRITICAL/HIGHリスクのみ)
  6. 統合 — コンポーネント間の相互作用(複数ファイルが変更された場合のみ)

テーブルとして提示:

#カテゴリテスト説明リスクレベル
1ハッピーパス有効なパラメータでレコードを作成HIGH
............

続行する前にユーザーの承認を待ちます。

フェーズ4: 仕様作成

以下のパターンに従って仕様を作成:

  • アサーションはテストごとに1つ(実用的な場合)
  • 説明的な名前 — it "レコードが見つからない場合404を返す" は it "動作する" ではない
  • Arrange-Act-Assert 構造
  • ミステリーゲストなし — すべてのテストデータがテスト内で可視
  • 実装ではなく振る舞いをテスト — プライベートメソッドを直接テストしない
  • フレームワークに適したファクトリー/フィクスチャを使用
  • describe/contextブロックで振る舞いごとにグループ化

テストコードの品質

テストもコードです — 同じ原則を適用:

  • KISS: 過度に設計されたテストヘルパーは不要。セットアップが10行を超える場合は、テストまたはテスト対象コードを簡略化する。
  • YAGNI: 発生し得ないシナリオはテストしない。不可能な状態に対して「念のため」テストを追加しない。
  • DRY(ただし抑制を): 巧妙な共有サンプルよりも明確な重複を優先。テストは3つのヘルパーファイルにジャンプすることなく、上から下まで読めるべき。
  • クリーンコード: ドキュメントのように読める説明的なテスト名。ミステリーゲストなし — すべてのデータがテスト内で可視。

フレームワーク固有のテストノート(RSpec、Minitest、ExUnit、Jest/Vitest)については @reference.md を参照。

フェーズ5: 実行と検証

  1. 新しい仕様を実行 — 対象を絞った実行(新しいファイルのみ)
  2. 障害を修正 — エラーを読み、ソースを読み、根本原因を修正
  3. 全スイートを実行 — 他に何も壊れていないことを確認
  4. QAレポートを作成 — @reference.md のレポートテンプレート、コアバリュー監査、合理化チェックを参照。

評決: SHIP IT / FIX AND RE-TEST / NEEDS REWORK

関連スキル