csharp-testing

csharp-testing スキルの概要

csharp-testing は何のためのものか

csharp-testing スキルは、xUnit、FluentAssertions、モック、インテグレーションテストのパターンを使って、C# と .NET のテストを実装・改善するための実践ガイドです。雑に「テストを書いて」と頼むのではなく、粗いテスト作業を、保守しやすいきれいな実装に落とし込みたい人に向いています。

どんな人に向いているか

既存の .NET コードベースにテストを追加したいとき、壊れやすいテストや価値の低いテストを見直したいとき、すでに C# を使っているアプリに新しいテスト基盤を立てたいときに、csharp-testing スキルを使ってください。特に、構造が必要で、読みやすいアサーションが必要で、ユニットテストとインテグレーションテストの境界を明確にしたいテスト自動化の作業に役立ちます。

何が違うのか

このスキルは、具体的なテスト判断にフォーカスしています。xUnit をいつ使うか、いつモック化するか、Testcontainers や WebApplicationFactory を優先すべきか、Arrange-Act-Assert でどう整理するか。だからこそ csharp-testing スキルは、場当たり的なプロンプトよりも有用です。単発の断片的なコードではなく、実際のワークフローへ導いてくれるからです。

csharp-testing スキルの使い方

インストールして有効化する

スキルディレクトリ内で csharp-testing install の流れを使うか、リポジトリの skill install コマンドパターン経由で導入し、そのうえでテスト作業を依頼する前にエージェントへこのスキルを指定してください。共有リポジトリのインストールパスを使う場合、基本のコマンドは次のとおりです。

npx skills add affaan-m/everything-claude-code --skill csharp-testing

スキルに適切な入力を与える

csharp-testing usage を最大限活かすには、プロダクションコード、テスト対象、すでに使っているフレームワーク、検証したい振る舞いを一緒に渡すのが効果的です。「このサービスのテストを書いて」という弱い依頼だと選択肢が多すぎます。より強い依頼では、クラス名、フレームワーク、切り離す依存関係、カバーしたい境界条件まで明示します。

まず確認すべきファイル

素早く csharp-testing guide を把握したいなら、最初に SKILL.md を読み、そのあと README.md、AGENTS.md、metadata.json、および存在するなら関連フォルダを確認してください。このリポジトリでは SKILL.md が主たる正本です。なので、アプリに当てはめる前に、推奨スタック、有効化トリガー、テスト構成を先に理解するのが最初の仕事です。

出力だけでなく、ワークフローを指示する

有用な依頼は、たいてい次のような形になります。「Test Automation 用に csharp-testing を使い、OrderService の xUnit テストを書いて。repository と logger の依存関係はモック化し、FluentAssertions を使い、Arrange-Act-Assert を維持して、DB の挙動が重要ならインテグレーションテストの推奨も 1 つ入れてください。」このレベルまで具体的に伝えると、関係ない流儀を勝手に足すことなく、適切なテスト種別、アサーションの書き方、フィクスチャの形を選びやすくなります。

csharp-testing スキル FAQ

csharp-testing は新規テスト専用ですか？

いいえ。csharp-testing スキルは、既存テストのレビュー、壊れやすいテストのリファクタリング、失敗ケースをユニットテストにするべきかインテグレーションテストにするべきかの判断にも役立ちます。単なるテスト生成ではなく、テスト設計が課題のときに向いています。

ただのプロンプトと比べて何が違いますか？

普通のプロンプトでもコードは出せますが、csharp-testing は出力を .NET 向けの選択に絞り込みやすくします。たとえば、xUnit の作法、FluentAssertions、NSubstitute や Moq、必要に応じた WebApplicationFactory などです。その結果、後片付けや手戻りが少なくなることが多いです。

初心者でも使いやすいですか？

はい。ただし、テスト対象のコードと「正しい」とは何かを説明できることが前提です。初心者ほど、プロジェクト全体のテストスイートを丸ごと頼むより、小さな対象メソッド、期待する入力、期待する結果を渡したほうが効果が出ます。

使わないほうがいいのはどんなときですか？

プロジェクトが C#/.NET ではない場合、言語非依存の QA ガイダンスが必要な場合、あるいは問題がテストの仕組みを超えて広い場合は、csharp-testing を使わないでください。適用先のコードがなく、フレームワーク比較だけをしたい場合も、あまり向いていません。

csharp-testing スキルの改善方法

テストの境界をもっと明確にする

品質を大きく上げるのは、何を隔離し、何を実物として扱うかをはっきりさせることです。ユニットテストが欲しいなら、どの協力オブジェクトをモック化するのかを書いてください。インテグレーションテストが欲しいなら、DB、HTTP 層、外部サービスのどれを実際に動かすのかを指定してください。

失敗パターンを共有する

csharp-testing の結果をより良くするには、どんなリスクを避けたいのかを明示するのが近道です。たとえば、タイミング起因の不安定さ、読みにくいアサーション、過剰なモック化、境界ケースの不足、遅いインテグレーションテストなどです。そうすれば、スキルは一般論ではなく、実際の問題に合わせて最適化できます。

テスト数ではなく、テストの形を依頼する

csharp-testing skill から実用的な出力を得たいなら、命名規則、Arrange-Act-Assert の構成、フィクスチャのスタイル、アサーションライブラリの選定まで指定してください。「成功、入力検証失敗、依存関係失敗の 3 テストを書いて」は、「もっとテストを書いて」よりずっと強い依頼です。

リポジトリの制約を踏まえて反復する

最初の出力を見たあとで、コードベースがすでに何を使っていて、何を変えてはいけないのかを伝えてください。たとえば、既存の xUnit フィクスチャ、モックライブラリ、命名規則、CI の実行時間上限などです。そうすることで csharp-testing ガイドが実際のリポジトリに沿ったものになり、見た目は正しくてもビルドに合わない助言を防げます。