Agent skill
acceptance-criteria-writing
Given-When-Then 形式の受け入れ基準を整理し、テスト可能な完了条件の定義を支援する。 要件の明確化、シナリオ設計、検証手順を一貫して整理する。 Anchors: • Software Requirements (Karl Wiegers) / 適用: 要件分析・仕様化 / 目的: テスト可能な要件定義 • BDD in Action (John Ferguson Smart) / 適用: Given-When-Then / 目的: 振る舞い駆動開発 • The Art of Software Testing (Glenford Myers) / 適用: テスト設計 / 目的: 検証可能性の確保 Trigger: 受け入れ基準の作成、ユーザーストーリーの仕様化、テスト可能な要件定義を行う場合に使用。 acceptance criteria, user story, GWT, Given-When-Then, testable requirements, definition of done
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/acceptance-criteria-writing
SKILL.md
acceptance-criteria-writing
概要
Given-When-Then 形式の受け入れ基準を整理し、テスト可能な完了条件の定義を支援する。
ワークフロー
Phase 1: 要件整理
analyze-requirements → [validate-schema]
↓
Phase 2: 基準設計
design-criteria → [validate-schema]
↓
Phase 3: 検証
validate-criteria → [log-usage]
凡例: [script] = Script Task, 無印 = LLM Task
Phase 1: 要件整理
目的: 受け入れ基準の前提と要件を明確化する
アクション:
- ユーザーストーリーと目的を整理する
- 前提条件と制約を洗い出す
- 曖昧な表現をリスト化する
Task: agents/analyze-criteria-requirements.md を参照
完了条件: 要件整理メモと前提一覧が出力されている
Phase 2: 基準設計
目的: Given-When-Then 形式の基準を設計する
アクション:
- 正常系とエッジケースのシナリオを整理する
- テスト可能性の観点で基準を設計する
- テンプレートで表現を統一する
Task: agents/design-acceptance-criteria.md を参照
完了条件: GWTシナリオとエッジケース一覧が出力されている
Phase 3: 検証
目的: 受け入れ基準を検証し、記録を残す
アクション:
- 検証スクリプトで品質を確認する
- 検証結果と改善点を整理する
- ログを更新する
Task: agents/validate-acceptance-criteria.md を参照
完了条件: 検証レポートが出力されている
Task仕様(ナビゲーション)
| Task | 責務 | 実行パターン | 入力 | 出力 |
|---|---|---|---|---|
| analyze-criteria-requirements | 要件と前提の明確化 | seq | 要件/制約 | 要件整理メモ、前提一覧 |
| design-acceptance-criteria | GWT形式の基準設計 | seq | 要件整理メモ | 受け入れ基準、シナリオ一覧 |
| validate-acceptance-criteria | 基準の検証と記録 | seq | 受け入れ基準 | 検証レポート |
実行パターン凡例:
seq: シーケンシャル(前のTaskに依存)
詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照
ベストプラクティス
すべきこと
| 推奨事項 | 理由 |
|---|---|
| Given/When/Then を明確に分ける | 検証可能性が高まるため |
| 正常系とエッジケースを分ける | 抜け漏れが減るため |
| 具体的な数値・条件を記述する | テスト自動化が容易になる |
| 検証スクリプトで品質確認する | 一貫した品質を担保できる |
避けるべきこと
| 禁止事項 | 問題点 |
|---|---|
| 曖昧な表現(「正しく」「適切に」) | テストが困難になる |
| 実装方法を指定する | 要件が硬直化する |
| 複数のアクションを1つのWhenに | シナリオが複雑化する |
| 1つのThenに複数の期待結果 | 検証が曖昧になる |
リソース参照
scripts/(決定論的処理)
| スクリプト | 機能 |
|---|---|
scripts/validate-acceptance-criteria.mjs |
受け入れ基準の品質検証 |
scripts/log_usage.mjs |
使用記録と評価メトリクス更新 |
scripts/quick_validate.mjs |
スキル構造の検証 |
references/(詳細知識)
| リソース | パス | 読込条件 |
|---|---|---|
| GWTパターン | references/gwt-patterns.md | パターン選定時 |
| テスト可能性ガイド | references/testability-guide.md | 4特性確認時 |
| エッジケースパターン | references/edge-case-patterns.md | 例外設計時 |
assets/(テンプレート・素材)
| アセット | 用途 |
|---|---|
assets/acceptance-criteria-template.md |
受け入れ基準テンプレート |
運用ファイル
| ファイル | 目的 |
|---|---|
EVALS.json |
評価メトリクス管理 |
LOGS.md |
実行ログの蓄積 |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?