Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

test-design

/test-design

Dobiera techniki projektowania testów, np. klasy równoważności, granice i tablice decyzyjne, a potem wypisuje przypadki testowe.

Repozytorium
skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
23.10.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
7
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 23.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Dobiera techniki projektowania testów, np. klasy równoważności, granice i tablice decyzyjne, a potem wypisuje przypadki testowe.

Argumenty

/test-design [テスト対象名]
Oryginalny opis (EN)

ISTQB/JSTQB のテスト設計(test design)活動を支援するスキル。test-analyze が識別したテスト条件から、テスト対象の特性に応じたテスト技法(同値分割・境界値分析・デシジョンテーブル・状態遷移・カバレッジ基準・エラー推測など)を選定提案し、承認された技法で具体的なテストケース(入力値・前提・期待結果)を導出して、設計書 test-design.md(技法選定根拠・カバレッジ)とケース一覧 test-case.md の 2 本を作る。「テストケースを作って」「テストケースを設計して」「どの技法で網羅すべきか提案して」「境界値/デシジョンテーブルでテストを起こして」と依頼されたときに使う。テストコード実装(test-implement)は対象外。単発のテスト作成依頼(単にユニットテストを書きたいだけ)も対象外。/test-design <テスト対象名> で明示的に呼び出されたときのみ使用する。

Jak działa

  1. このスキルが従う横断原則
  2. 手順
  3. 用語(JSTQB 訳語 / 初出英語併記)
Sekcje z nagłówków SKILL.md, w oryginale · 203 linii, 508 słów
Podgląd SKILL.md
---
name: test-design
description: ISTQB/JSTQB のテスト設計(test design)活動を支援するスキル。test-analyze が識別したテスト条件から、テスト対象の特性に応じたテスト技法(同値分割・境界値分析・デシジョンテーブル・状態遷移・カバレッジ基準・エラー推測など)を選定提案し、承認された技法で具体的なテストケース(入力値・前提・期待結果)を導出して、設計書 test-design.md(技法選定根拠・カバレッジ)とケース一覧 test-case.md の 2 本を作る。「テストケースを作って」「テストケースを設計して」「どの技法で網羅すべきか提案して」「境界値/デシジョンテーブルでテストを起こして」と依頼されたときに使う。テストコード実装(test-implement)は対象外。単発のテスト作成依頼(単にユニットテストを書きたいだけ)も対象外。/test-design <テスト対象名> で明示的に呼び出されたときのみ使用する。
license: MIT
disable-model-invocation: true
user-invocable: true
argument-hint: "[テスト対象名]"
---

# test-design: テスト設計(技法選定 + テストケース導出)

ISTQB/JSTQB のテストプロセス 7 活動のうち **テスト設計(test design)** を担う単機能スキル。
test-analyze が識別した **テスト条件** から、対象特性に応じた **テスト技法(test technique)** を
選定提案し、承認された技法で **具体的なテストケース(入力値・前提・期待結果)** を導出して、
成果物を 2 本作る。**設計判断とケース一覧を 1 ファイルに混在させない**:

- **`test-design.md`(テスト設計書)**: 採用技法と選定根拠・カバレッジ確認・改善提案。
  **技法の選定根拠を必ずこちらに残す**。
- **`test-case.md`(テストケース一覧)**: 前提・入力・期待結果の一覧のみ。技法の根拠は
  `test-design.md` への参照で示す。

このスキルは **テストケースの導出だけ** を行う。テストコード・手順書への具体化(test-implement)・
実行(test-execute)・レポートは各専用スキルの担当で、ここでは呼び出さない。**単発のテスト作成
依頼(単にユニットテストを 1 つ書きたいだけ)は対象外** — その場合は通常のコーディング支援で
対応する。導出するのは **論理的なテストケース(何を・どう入れ・何を期待するか)** で、
**実行可能なコードやデータの実装はしない**(それは `/test-implement`)。

## このスキルが従う横断原則

testing-skills 全 8 スキル共通の原則。型は test-plan が確立する参照実装に揃える。

### 1. ファイル規約 + 任意入力

- 成果物の既定パスは **`docs/test/<テスト対象名>/test-design.md`** と
  **同 `test-case.md`** の 2 本。
- **プロジェクト側(`CLAUDE.md` / `AGENTS.md` 等)に成果物の配置規約があればそちらを優先する**。
  着手前にリポジトリを調べ、既存の `docs/` 構成やテストドキュメントの慣習に合わせる。
- 前工程 test-analyze の成果物 **`docs/test/<テスト対象名>/test-analysis.md`**(テスト条件と
  優先度)が規約パスにあれば **入力として読む**。test-plan.md があればリスク根拠も参照する。
- **test-analysis.md が無くても代作しない**。テスト条件が無い場合は、先に
  **`/test-analyze <テスト対象名>` の実行を提案** するに留める(自分でテスト条件を網羅識別
  しない。既にテスト条件が本文で提示されているなら、それを対象に設計してよい)。

### 2. 調査優先 + 決定のみ質問

- **事実はリポジトリ調査で埋める**。入力の型・範囲・境界・状態遷移・分岐・仕様上の期待結果は、
  利用者に訊く前にコード・仕様から自分で調べる。
- **利用者にしか決められない判断だけ** を `AskUserQuestion` で確認する。test-design では
  主に **どの技法を採用するか・カバレッジ基準の水準・ケース数の上限** がこれに当たる
  (推奨案を先頭に添えて訊く)。技法選定は「提案 → 承認」を必ず経る。
- 流れは **調査 → 技法提案 → 承認 → ケース導出 → ドラフト提示 → 承認 → 規約パスへ書き込み**。

### 3. 改善提案と仕様反映(early testing 原則)

- 設計中に見つけた **テスト対象・仕様・テスタビリティの問題**(期待結果が仕様から確定でき
  ない、境界が曖昧、状態が観測不能でケース化できないなど)は、`test-design.md` の
  「改善提案」セクションで **提示** する。
- **起票前に既決事項を照合する**。前工程成果物(test-plan / test-analysis)とプロジェクトの
  メモリに同じ問題が既に記録され、対応先(詳細設計送り・作業計画送り等)が確定しているものは
  改善提案に **再掲しない**。必要なら「次のステップ」欄に「〜は詳細設計で対応(test-plan §X
  参照)」のような参照 1 行に留める。改善提案には **この工程で新規に見つけた未解決の問題だけ**
  を載せる。
- **仕様の穴は提示で終わらせない**。利用者の決定を `AskUserQuestion` で確認し、決定が出たら
  **その内容を仕様書へ反映する作業まで行う**(反映先の仕様書が規約パスにある場合)。
  実装・詳細設計レベルで解決すべき決定は、仕様書ではなく作業計画・メモリ等へ退避する。
  仕様が確定したら、該当ケースの期待結果を確定値・仕様参照へ更新する。
- **反映が済んだ提案は「改善提案」セクションから削除する**(「反映済み」注記で残さない。
  決定の記録は仕様書の改訂履歴が担う)。全提案が解消したらセクションごと削除して番号を詰め、
  未解決の提案が残っている間だけセクションを維持する。
- **スキル自身がテスト対象のコードを修正しない**。early testing は「早期に欠陥を見つけて
  指摘する」ことであり、コード修正の実施ではない。

### 4. 単機能の堅持

- test-design は **テストケースの成果物だけ** を作る。他スキルを呼び出さず、相互参照もしない。
- 後続工程が必要なら、成果物末尾で **次に `/test-implement` を実行することを提案** するに留める
  (代わりにテストコードを書かない)。

### 5. Progressive disclosure

- 本文は簡潔に保ち、テンプレ・技法カタログ・詳細は `references/` に置く。
- テンプレ: [`references/template-design.md`](references/template-design.md)
  (`test-design.md` の雛形)、
  [`references/template-case.md`](references/template-case.md)(`test-case.md` の雛形)。
- mini サマリ雛形: [`references/mini-template-design.md`](references/mini-template-design.md)
  (`mini-test-design.md` の雛形)、
  [`references/mini-template-case.md`](references/mini-template-case.md)
  (`mini-test-case.md` の雛形。いずれも手順 5 で使う)。
- 技法カタログ:
  [`references/techniques-blackbox.md`](references/techniques-blackbox.md)(ブラックボックス技法)、
  [`references/techniques-whitebox-experience.md`](references/techniques-whitebox-experience.md)
  (ホワイトボックス技法・経験ベース技法)。

### 6. 成果物の記述スタイル

- **略号・コードネームを定義なしで使わない**(例: 仕様書内の `G3` のような社内略号)。
  初出で正式名称・意味を併記するか、平易な表現に開く。成果物単体で読み返して意味が
  取れることを基準にする。
- **スキルの実行記録を成果物に含めない**。利用者との Q&A ログ・フェーズ別実行時間などは
  対話のテレメトリであって、レビュー対象の内容ではない。利用者との決定事項は本文の該当箇所
  (根拠・凡例等)へ埋め込み、実行記録が必要なら scratchpad 等へ分離する。

## 手順

### 手順 0: テスト対象の確定

- 引数 `<テスト対象名>` があればそれを対象名とする。無ければ利用者に一言で確認する。
  対象名は成果物パス `docs/test/<テスト対象名>/` のディレクトリ名にも使う
  (英数字・ハイフンへ正規化)。

### 手順 1: 入力の収集(事実収集)

原則 2 に従い、以下を **自分で調べる**(利用者に訊かない):

- **前工程成果物**: `docs/test/<テスト対象名>/test-analysis.md`(テスト条件・優先度)。
  無ければ原則 1 に従い `/test-analyze` の実行を提案(本文提示済みなら続行可)。
- **仕様・コード**: 入力の型・値域・境界・分岐条件・状態遷移・期待結果の根拠・エラー処理。
- **テスト実行環境**: テストランナー・既存テストの種別(Unit/Integration 等)・CI への組み込み・
  ローカルで再現できる依存(DB・ストレージ等のコンテナ)・別リポジトリや実機に依存する検証の有無。
  手順 3 の自動/手動区分の判定材料にする。
- **配置規約**: `CLAUDE.md` / `AGENTS.md` の成果物配置ルール(原則 1)。

### 手順 2: テスト技法の選定提案

技法は 3 分類のカタログ(references/)から、**テスト条件の特性に応じて選ぶ**:

- **ブラックボックス技法**(仕様ベース):
  [`references/techniques-blackbox.md`](references/techniques-blackbox.md)。
  同値分割・境界値分析・デシジョンテーブル・状態遷移・ペアワイズ・ユースケース。
- **ホワイトボックス技法**(構造ベース)+ **経験ベース技法**:
  [`references/techniques-whitebox-experience.md`](references/techniques-whitebox-experience.md)。
  ステートメント/ブランチカバレッジ・エラー推測・探索的テスト・チェックリスト。

選定の当てはめ(例):

- 連続値・数値範囲がある → 同値分割 + 境界値分析。
- 複数条件の組合せで結果が変わる → デシジョンテーブル。
- 状態を持ち遷移で振る舞いが変わる → 状態遷移。
- 多数のパラメータ組合せ → ペアワイズ。
- コード網羅を保証したい → ステートメント/ブランチカバレッジ。
- 仕様外の壊れ方を突く → エラー推測・探索的テスト。

**採用技法とその根拠(なぜその条件にその技法か)を提示し、承認を得てから導出に進む**
(原則 2)。技法・カバレッジ基準・ケース数上限が利用者依存なら `AskUserQuestion`(推奨案先頭)。

### 手順 3: テストケースの導出

承認された技法で、各テスト条件から **論理的テストケース** を導出する:

- 各ケースに **一意な ID・前提条件・入力(値/操作)・期待結果・対応テスト条件(TC-xx)** を付ける。
- 技法のカバレッジ基準(境界値なら各境界の内外、デシジョンテーブルなら各ルール、ブランチ
  カバレッジなら各分岐の真偽など)を満たすことを意識する。
- 具体値・実行コード・テストデータの **実装はしない**(test-implement の担当)。期待結果は
  仕様・コードから確定できる範囲で書き、確定できないものは改善提案へ回す(原則 3)。
- **各ケースに自動/手動の区分を付ける**。手順 1 で調べたテスト実行環境に基づき、既存の
  テストランナー・CI で機械実行できるケースを「自動」、環境の制約(別リポジトリ・実機・
  目視レビュー依存など)で人手の実行が要るケースを「手動」とする。**判定基準(どの実行手段が
  あるから自動と言えるか)は `test-design.md` に節として残す**。データ準備等に人手が要る
  半自動的な検証手段は、ケースの区分値には出さず設計書の判定基準側に整理する。区分は設計時点の
  判定であり、実装時の食い違いは test-implement が `test-case.md` を更新して正とする。

### 手順 4: ドラフト提示 → 承認 → 書き込み

- [`references/template-design.md`](references/template-design.md) の構成で `test-design.md`、
  [`references/template-case.md`](references/template-case.md) の構成で `test-case.md` の
  ドラフトを作り、**本文で提示して承認を得る**(原則 2)。**技法選定根拠のセクションを
  設計書側に必ず含める**。設計判断(技法・カバレッジ・除外)とケース一覧を混在させない。
- 承認後、規約パス(既定 `docs/test/<テスト対象名>/test-design.md` と同 `test-case.md`、
  プロジェクト規約があれば優先)へ書き込む。
- 手順 1〜3 で見つけた対象・仕様・テスタビリティの問題は `test-design.md` の「改善提案」
  セクションに記載(原則 3)。
- 末尾で **次工程 `/test-implement <テスト対象名>` の実行を提案** する(原則 4)。自分では進めない。

### 手順 5: mini サマリの作成(レビュー収束後)

- 本編 `test-design.md` / `test-case.md` への利用者フィードバックが出なくなり、確認が完了したら、
  同ディレクトリに初見者向けサマリ **`mini-test-design.md`** と **`mini-test-case.md`** を
  作成する。**レビュー中は作らない**(フィードバックのたびに本編と同期し直すことになるため、
  収束後に一度だけ作る)。
- 構成は [`references/mini-template-design.md`](references/mini-template-design.md) /
  [`references/mini-template-case.md`](references/mini-template-case.md) に従う。対象ドメインに
  詳しくない人へ短時間で説明できる状態を目指す。先行する `mini-test-plan.md` /
  `mini-test-analysis.md` があればリスク番号・テスト条件番号を相互参照で一貫させる。

### 手順 6: 終了条件の確認と完了宣言

テスト設計の終了条件(exit criteria)は以下。**利用者に「終わりか」と訊かれる前に、
スキル側で判定して宣言する**:

1. テスト技法の選定が承認済み(手順 2)。
2. 入力の全テスト条件(TC-xx)がテストケースでカバーされている(トレーサビリティ確認)。
3. 全ケースに自動/手動の区分が付いている(手順 3)。
4. 改善提案が空(各提案が仕様反映・対応先確定・ケース明記のいずれかで解消済み)。
5. test-review ゲート: `/test-review <テスト対象名> design` の判定が「通過」または
   「条件付き通過」(記録 `test-review-design.md`)になっている、もしくは利用者がゲートの
   スキップを明示している。未実施なら完了宣言せず、利用者へ実行を促す
   (test-review は明示起動のみで、本スキルからは起動できない)。
6. mini サマリ作成済み(手順 5)。

- 全て満たしたら **「テスト設計は完了」と明言** し、`/test-implement <テスト対象名>` の提案で
  閉じる(原則 4)。
- 満たしていない項目があれば、何が残っているかを列挙して先へ進めない。

## 用語(JSTQB 訳語 / 初出英語併記)

- テスト設計(test design): テスト条件からテストケースを導出する活動。
- テスト技法(test technique): テストケースを体系的に導く方法。ブラックボックス(仕様ベース)/
  ホワイトボックス(構造ベース)/ 経験ベースの 3 分類。
- テストケース(test case): 前提・入力・期待結果の組。ここでは論理的(値の実装前)レベル。
- カバレッジ(coverage): 技法が定める網羅の度合い(各境界・各ルール・各分岐 等)。
Pliki w paczce (7)
  • SKILL.md 16 KB
  • references/mini-template-case.md 1 KB
  • references/mini-template-design.md 1 KB
  • references/techniques-blackbox.md 3 KB
  • references/techniques-whitebox-experience.md 3 KB
  • references/template-case.md 1 KB
  • references/template-design.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · yasunori0418/skills90MIT
mhmdelgazzar/agentex100MIT
bdfinst/agentic-dev-team100MIT
itzcull/software-skills100MIT
brrritscold/compainy100MIT
app-vitals/shipwright90MIT
tadokoro-ryusuke/cc-plugins90MIT
nahid-sparktales/agent-dispatcher90MIT

Migawka bazy z 13.11.2026 · wersja paczki 1591be7f5856 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90test-implement
    Zamienia przypadki testowe na wykonywalny kod, dane testowe i atrapy, z kontrolą składni, bez uruchamiania samych testów.
  • 90test-analyze
    Identyfikuje warunki testowe, czyli to, co warto sprawdzić, na podstawie specyfikacji, kodu i ryzyk, z priorytetami.
  • 100qe-test-design-techniques
    Stosuje systematyczne techniki projektowania testów: analiza wartości brzegowych, klasy równoważności, tablice decyzyjne, testy przejść stanów i testy kombinatoryczne.
  • 95qa
    Pomaga w strategii testów: plan, przypadki testowe, klasy równoważności, raporty defektów i metryki.
  • 100test-design-techniques
    Projektuje przypadki testowe systematycznie: analiza wartości granicznych, podział na klasy równoważności, pairwise, przejścia stanów i tablice decyzyjne.
  • 100qa-manual-istqb
    Tworzy artefakty QA z wymagań: plany testów, przypadki, raporty błędów, zestawy regresyjne i śledzenie zgodnie z ISTQB.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.