本文へ移動
cccskills
無料GitHub で公開

acceptance-criteria-writer

Write measurable acceptance criteria for requirements or user stories. Use when the user says "write acceptance criteria", "definition of done", "how do we test this", "fit criteria", "given when then", "Gherkin scenarios", "what does done look like", "testable conditions", "how will we know this works" - even if they don't explicitly say "acceptance criteria".

インストール方法を見る

含まれるファイル(1)

  • SKILL.md5.1 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Overview

Based on Mastering the Requirements Process by Suzanne & James Robertson - the Fit Criteria concept, where every requirement gets a quantified, measurable condition that proves it has been satisfied. Also draws on User Stories Applied by Mike Cohn for the 3 C's (Card, Conversation, Confirmation) where Confirmation = acceptance criteria, and Writing Effective Use Cases by Alistair Cockburn where the Success Guarantee (postcondition) is the use case's acceptance criterion. The key insight from Robertson: if you cannot write a fit criterion for a requirement, the requirement is too vague to implement.

Workflow

Step 1: Identify the requirement or story to test

Start from a documented requirement (FR-XXX), user story, or use case. Extract:

  • What the system should do (the behavior)
  • Why it matters (the rationale - drives which edge cases to cover)
  • Who is the actor (drives the perspective of the criteria)

Step 2: Write the primary acceptance criterion (happy path)

Use Robertson's Fit Criterion format for precision:

FIT CRITERION: [Measurable condition that proves the requirement is met]
MEASUREMENT: [How to verify - manual test, automated check, metric threshold]

Or Gherkin format for scenario-based criteria:

GIVEN [precondition / context]
WHEN [action / trigger]
THEN [expected outcome / observable result]

Step 3: Write criteria for the four paths

Every requirement needs criteria covering:

  • Happy path: The expected successful flow
  • Edge cases: Boundary conditions, empty states, maximum values
  • Error path: Invalid input, system failures, timeout scenarios
  • Empty/null path: No data, first-time use, zero results

Example for a search feature:

Happy: GIVEN products exist WHEN user searches "laptop" THEN matching results display within 500ms
Edge: GIVEN 10,000+ results WHEN user searches THEN first page loads with pagination controls
Error: GIVEN search service is unavailable WHEN user searches THEN error message displays with retry option
Empty: GIVEN no products match WHEN user searches "xyznonexistent" THEN "no results" message displays with suggestions

Step 4: Quantify vague criteria (Robertson's Fit Criteria)

Convert subjective requirements into measurable conditions:

VagueFit Criterion
"Easy to use"80% of new users complete [task] within 5 minutes without assistance
"Fast"95th percentile response time < 500ms under [load condition]
"Secure"Passes [standard] penetration test with zero critical findings
"Reliable"99.9% uptime measured monthly; mean time to recovery < 4 hours
"Scalable"Supports [N] concurrent users with < 10% performance degradation

Step 5: Link criteria to test type

For each criterion, specify how it will be verified:

AC-001: [criterion]
TEST TYPE: [unit / integration / E2E / manual / performance / security]
AUTOMATION: [yes / no - with justification if no]

Step 6: Review with the "three amigos"

Walk through criteria with: the BA (requirements perspective), a developer (feasibility), and a tester (completeness). Criteria that the tester cannot execute or the developer cannot implement need revision.

Anti-Patterns

1. Vague criteria that cannot be tested Bad: "The system should be user-friendly." Good: "80% of users complete the checkout flow in under 3 minutes on first attempt."

2. Only happy-path criteria Bad: Acceptance criteria that only describe the successful flow. Good: Criteria covering happy, edge, error, and empty paths for every requirement.

3. Implementation-specific criteria Bad: "The React component renders a dropdown with CSS class .select-primary." Good: "The user can select a value from a constrained list of options."

4. Criteria without a measurement method Bad: "The system loads quickly." (How will you measure this?) Good: "Page load < 2 seconds measured at the 95th percentile using [monitoring tool]."

5. Copy-paste criteria across stories Bad: Same generic acceptance criteria on every story ("meets coding standards"). Good: Each story has criteria specific to its behavior and business logic.

Quality Checklist

  • Every requirement or story has at least one acceptance criterion
  • Happy path, edge case, error path, and empty/null path covered
  • All criteria are measurable (Robertson's Fit Criteria test)
  • No subjective language without a quantified proxy metric
  • Criteria are written from the user's perspective, not the developer's
  • Each criterion specifies how it will be verified (test type)
  • Three amigos review completed (BA, dev, tester)
  • Criteria are independent of implementation technology

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Rate any product, feature, or experience on the 11-star scale (Brian Chesky's Airbnb thought experiment). Use when user says "rate this experience", "11-star", "star rating", "experience audit", "how good is this", "experience rating", "product audit", "quality assessment", or wants to evaluate product quality and identify improvement paths. Also trigger when user wants to benchmark a feature, assess where a product stands, or map out what "great" looks like - even if they don't explicitly say "11-star".

日本語の概要は準備中です。原文の説明を表示しています。

qa-aman/claude-skills202026年9月10日 更新

Generate A/B copy variants grounded in Eugene Schwartz's awareness and market-sophistication stages and John Caples' tested-headline discipline. Every variant declares its angle, the awareness stage it targets, and a falsifiable hypothesis, and the skill recommends which pair to test first and what delta counts as signal. Use when the user says "A/B test this", "write variants", "give me options", "test different angles", "copy variants", "ab copy", "test this headline", "multiple versions", "which version is better", or wants to test copy before publishing. For reviewing copy that already exists, see copy-review. For sample size and stopping rules, see growth-experiment. For diagnosing a page rather than its words, see page-cro. For full paid ad sets by platform, see ad-campaign-writer.

日本語の概要は準備中です。原文の説明を表示しています。

qa-aman/claude-skills202026年9月10日 更新

Build a strategic account plan for winning, retaining, or expanding a named account. Use when the user says "build an account plan", "strategic account planning", "how do I grow this account", "account expansion strategy", "whitespace analysis", "QBR prep", "key account review", "map the stakeholders in this account", "land and expand plan", "how do I break into [company]", or wants a structured strategy for a specific account.

日本語の概要は準備中です。原文の説明を表示しています。

qa-aman/claude-skills202026年9月10日 更新

Write paid ad copy for LinkedIn, Google, Meta, and YouTube. Produces multiple variants per platform, each targeting a different Eugene Schwartz awareness level and Cialdini persuasion principle. Use when the user asks for ad copy, ad variants, "write LinkedIn ads", Google ads, Meta ads, paid social copy, ad headlines, or wants creative for a paid campaign. Reads brand voice, ICP, and positioning from knowledge/. For organic social posts, see linkedin-post or social-calendar. For the landing page the ad points at, see landing-page-writer. For testing variants, see ab-copy-writer.

日本語の概要は準備中です。原文の説明を表示しています。

qa-aman/claude-skills202026年9月10日 更新

Design clean and consistent APIs. Use when the user says "design an API", "API design review", "design these endpoints", "REST API for X", "GraphQL schema", "API contract", "how should this endpoint work", "review my API design", or wants to create or improve an API interface - even if they don't explicitly say "API design".

日本語の概要は準備中です。原文の説明を表示しています。

qa-aman/claude-skills202026年9月10日 更新

Write a clear, reviewable audit workpaper documenting procedures, evidence, and conclusions. Use when an auditor says "write a workpaper", "document this audit procedure", "tick and tie this", "I need to document my testing", "substantive testing workpaper", "controls testing documentation", "audit evidence memo", "prepare the workpaper for this balance", "document the audit steps I performed", or needs to capture any audit work in a format that supports review and sign-off. Also trigger when someone has completed audit testing and needs to write it up even if they don't use the word "workpaper".

日本語の概要は準備中です。原文の説明を表示しています。

qa-aman/claude-skills202026年9月10日 更新

qa-aman のスキルをすべて見る

このスキルの問題を報告する