Claude Skill

api-idempotency-testing

Use this skill when you need to assess API retry and duplicate-request behavior against sourced side-effect evidence; triggers include API 幂等性测试 and API idempotency testing.

LLM Mart · 0 points · 1 views 0 listing impressions 0 install-command copies
Download naodeng-awesome-qa-skills-skills_en_testing-types_api-idempotency-testing-9df700b.zip · 8 KB

Install

skills CLI npx skills add https://github.com/naodeng/awesome-qa-skills/tree/main/skills/en/testing-types/api-idempotency-testing
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install naodeng-awesome-qa-skills@llmmart
Git git clone https://github.com/naodeng/awesome-qa-skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole naodeng/awesome-qa-skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

API Idempotency Testing

design verifiable candidates for duplicate requests, retries, idempotency keys, timeouts, and side effects. Produce AIT-## findings. This Skill organizes traceable API-quality candidates only; it does not execute tests or turn a design inventory into coverage, pass, or release evidence.

When to Use

  • When you need API idempotency testing candidates from API contracts, idempotency-key rules, retry policies, timeout evidence, business side effects, message records, and database observations.
  • When you need selection rationale, applicability constraints, evidence gaps, and the smallest validation action.
  • When inputs are incomplete but a bounded first pass can preserve blocked or unassessed boundaries.

Do not use it to execute tests, invent contract or behavior, replace a complete strategy, or accept risk for a Human.

Output Format Options

  • Use Markdown by default; use tables, JSON, or CSV only when explicitly requested or required by the delivery format.
  • Separate static analysis, unexecuted work, evidence states, and Human decisions; keep items unassessed, blocked, or NOT_RUN when runtime evidence is absent.

How to Use

  1. Read prompts/api-idempotency-testing.md and provide the objective, scope, material, environment, and evidence.
  2. Complete the known, missing, conflicting, stale, out_of_scope, and assumptions input audit before findings.
  3. Record AIT-## with the subject, preconditions, behavior of concern, source evidence, and validation, plus impact/priority, owner role, close condition, and evidence state.
  4. Preserve conflicts, unknown constraints, and open questions when evidence is incomplete.

Domain Execution Essentials

  • Extract key scope, payload equivalence, lifetime/expiry boundary, concurrency, and replay contracts. Separate response replay from order/payment/message side-effect obligations.
  • Deliver request sequence, responses, commit ledger, and contract decision per scenario; assess both side effects and response obligations.
  • When deriving domain candidates, read and follow prompts/api-idempotency-testing.md for the domain procedure and oracle; retain valid controls, evidence gaps, and validation actions for each item.

Core Constraints

  • Do not execute tests, assume missing rules, versions, thresholds, data, or responses, or treat candidate counts as coverage proof.
  • File presence, names, design declarations, and Eval configuration are not runtime evidence.
  • Mark unknowns unassessed, blocked, or pending clarification instead of filling them with convention.
  • Do not edit requirements, code, test assets, or target systems.

Pre-delivery Check

  • Recorded the known, missing, conflicting, stale, out_of_scope, and assumptions input audit.
  • Every AIT-## has source, evidence state, impact/priority, owner role, close condition, and validation.
  • Facts, inferences, recommendations, unexecuted work, and Human decisions remain separate.
  • Findings are not execution results, coverage proof, or release claims.

Reference Files

  • Read evals/eval.yaml and matching cases for regression; configuration does not prove project results.
  • Use evals/trigger-prompts.csv and evals/local-rules.json for trigger checks; missing skill.selection evidence is BLOCKED.

Common Pitfalls

  • Do not turn a method name, file presence, or candidate count into test execution, coverage, pass, or release evidence when scope or evidence is incomplete.
  • Do not fill in missing rules, thresholds, data, environments, or results from convention; preserve unassessed, blocked, and pending items.
  • Do not expand this specialist design or review into a complete strategy, full test cases, runtime execution, or a release decision.

Best Practices

  • Complete the six-part input audit before selecting the smallest traceable and verifiable finding scope.
  • Keep the source, evidence state, impact/priority, owner role, close condition, validation method, and residual risk for every finding.
  • Write validation suggestions as next actions; do not upgrade package structure, candidate counts, or local Eval configuration into real quality conclusions.
Files (awesome-qa-skills)
  • agents
    • openai.yaml 347 B
      Loading…
  • evals
    • cases
      • basic-success.yaml 895 B
        Loading…
      • domain-method-control.yaml 1.4 KB
        Loading…
      • domain-method-success.yaml 1.3 KB
        Loading…
      • edge-incomplete-input.yaml 652 B
        Loading…
      • edge-scope-boundary.yaml 725 B
        Loading…
    • eval.yaml 531 B
      Loading…
    • local-rules.json 142 B
      Loading…
    • trigger-prompts.csv 565 B · in bundle
  • prompts
    • api-idempotency-testing.md 4.4 KB
      Loading…
  • SKILL.md 4.6 KB
    ---
    name: api-idempotency-testing
    description: Use this skill when you need to assess API retry and duplicate-request behavior against sourced side-effect evidence; triggers include API 幂等性测试 and API idempotency testing.
    license: PolyForm-Noncommercial-1.0.0
    metadata:
      version: "1.0.0"
      compatibility: ""
      author: "Awesome QA Skills contributors"
      language: "en"
      category: "testing-types"
      source: "https://github.com/naodeng/awesome-qa-skills"
      license-url: "https://polyformproject.org/licenses/noncommercial/1.0.0"
    ---
    
    # API Idempotency Testing
    
    design verifiable candidates for duplicate requests, retries, idempotency keys, timeouts, and side effects. Produce AIT-## findings. This Skill organizes traceable API-quality candidates only; it does not execute tests or turn a design inventory into coverage, pass, or release evidence.
    
    ## When to Use
    
    - When you need API idempotency testing candidates from API contracts, idempotency-key rules, retry policies, timeout evidence, business side effects, message records, and database observations.
    - When you need selection rationale, applicability constraints, evidence gaps, and the smallest validation action.
    - When inputs are incomplete but a bounded first pass can preserve blocked or unassessed boundaries.
    
    Do not use it to execute tests, invent contract or behavior, replace a complete strategy, or accept risk for a Human.
    
    ## Output Format Options
    
    - Use Markdown by default; use tables, JSON, or CSV only when explicitly requested or required by the delivery format.
    - Separate static analysis, unexecuted work, evidence states, and Human decisions; keep items unassessed, blocked, or NOT_RUN when runtime evidence is absent.
    
    ## How to Use
    
    1. Read prompts/api-idempotency-testing.md and provide the objective, scope, material, environment, and evidence.
    2. Complete the known, missing, conflicting, stale, out_of_scope, and assumptions input audit before findings.
    3. Record AIT-## with the subject, preconditions, behavior of concern, source evidence, and validation, plus impact/priority, owner role, close condition, and evidence state.
    4. Preserve conflicts, unknown constraints, and open questions when evidence is incomplete.
    
    ## Domain Execution Essentials
    
    - Extract key scope, payload equivalence, lifetime/expiry boundary, concurrency, and replay contracts. Separate response replay from order/payment/message side-effect obligations.
    - Deliver request sequence, responses, commit ledger, and contract decision per scenario; assess both side effects and response obligations.
    - When deriving domain candidates, read and follow [prompts/api-idempotency-testing.md](prompts/api-idempotency-testing.md) for the domain procedure and oracle; retain valid controls, evidence gaps, and validation actions for each item.
    
    ## Core Constraints
    
    - Do not execute tests, assume missing rules, versions, thresholds, data, or responses, or treat candidate counts as coverage proof.
    - File presence, names, design declarations, and Eval configuration are not runtime evidence.
    - Mark unknowns unassessed, blocked, or pending clarification instead of filling them with convention.
    - Do not edit requirements, code, test assets, or target systems.
    
    ## Pre-delivery Check
    
    - [ ] Recorded the known, missing, conflicting, stale, out_of_scope, and assumptions input audit.
    - [ ] Every AIT-## has source, evidence state, impact/priority, owner role, close condition, and validation.
    - [ ] Facts, inferences, recommendations, unexecuted work, and Human decisions remain separate.
    - [ ] Findings are not execution results, coverage proof, or release claims.
    
    ## Reference Files
    
    - Read evals/eval.yaml and matching cases for regression; configuration does not prove project results.
    - Use evals/trigger-prompts.csv and evals/local-rules.json for trigger checks; missing skill.selection evidence is BLOCKED.
    
    ## Common Pitfalls
    
    - Do not turn a method name, file presence, or candidate count into test execution, coverage, pass, or release evidence when scope or evidence is incomplete.
    - Do not fill in missing rules, thresholds, data, environments, or results from convention; preserve unassessed, blocked, and pending items.
    - Do not expand this specialist design or review into a complete strategy, full test cases, runtime execution, or a release decision.
    
    ## Best Practices
    
    - Complete the six-part input audit before selecting the smallest traceable and verifiable finding scope.
    - Keep the source, evidence state, impact/priority, owner role, close condition, validation method, and residual risk for every finding.
    - Write validation suggestions as next actions; do not upgrade package structure, candidate counts, or local Eval configuration into real quality conclusions.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.