Validation post-vol Output SDK

VérifiéSûr

Validation systématique après exécution des workflows Output SDK : conformité des étapes, conventions, qualité et livrables.

Spar Skills Guide Bot
TestingIntermédiaire
21022/10/2026
Claude Code
#validation#checklist#workflow-orchestration#sdk-conventions#quality-assurance

Recommandé pour

Synthèse automatique

Skill de contrôle post-exécution qui vérifie, à l'aide de listes de contrôle, qu'un plan de workflow Output SDK respecte les conventions (imports, activités Temporal, schémas Zod, stratégie de test) avant de le déclarer terminé.

Points forts

  • Couvre quatre axes distincts : exécution des étapes, conformité aux conventions, qualité du plan et livrables produits
  • Les points de contrôle sont concrets et vérifiables (extension .js des imports, wrapper HttpClient, export dans entrypoint.ts, ApplicationFailure)
  • Impose une section de rapport d'erreur structurée lorsqu'un écart est détecté
  • Rend explicite le handoff vers l'implémentation (commandes CLI, dépendances, critères de succès)

Limites

  • Très spécifique à un « Output SDK » interne (Temporal, @flowsdk/core, @flowsdk/llm) et difficilement réutilisable ailleurs
  • Le skill est en lecture seule (allowed-tools: Read) : il signale les écarts mais ne peut pas corriger le code ou le plan
  • La dernière case de la checklist est tronquée (« project's existin »), signe d'un contenu non finalisé
Quand l'utiliser

À utiliser juste après avoir rédigé ou révisé un plan de workflow Output SDK, pour auditer sa complétude et sa conformité avant de lancer l'implémentation.

Quand l'éviter

Ne pas l'utiliser pour des projets hors Output SDK/Temporal, ni comme substitut à une revue humaine de la conception.

Analyse de sécurité

Sûr
Score qualité72/100

The skill is a purely advisory post-flight checklist for reviewing Output SDK workflow outputs. Its only declared tool is Read, and the content contains no executable commands, network calls, file writes, credential handling, or attempts to override agent instructions. It simply enumerates verification items and reporting steps, so there is no meaningful execution risk.

Aucun point d'attention détecté

Comment cette analyse est faite

Exemples

Audit a workflow plan
Run the post-flight checks on the workflow plan I just wrote for the document-summarization workflow and tell me which checklists fail.
Verify Output SDK conventions
Check that my plan and activity definitions follow Output SDK conventions: .js import extensions, HttpClient instead of axios, and Temporal activities for all external calls.
Confirm implementation readiness
Review my completed workflow plan against the post-flight deliverable checklist and list anything a developer would still need clarified before implementing.

name: output-meta-post-flight description: Post-flight validation for Output SDK workflow operations. Systematic verification of step completion, convention compliance, quality validation, and deliverable verification. allowed-tools: [Read]

Post-Flight Rules for Output SDK Workflows

Execution Verification

After completing all steps in the process_flow, systematically verify:

Step Completion Audit

  • [ ] Every numbered step has been read, executed, and delivered according to its instructions
  • [ ] All steps that specified a subagent were delegated to the correct subagent
  • [ ] If any subagent was not used as specified, document why and report to the user
  • [ ] If any step was not executed according to instructions, explain which part was misread or skipped

Output SDK Convention Compliance

Verify the following conventions were followed:

Import Conventions

  • [ ] All TypeScript/JavaScript imports use .js extension for ES modules
  • [ ] No direct axios usage - HttpClient wrapper used throughout
  • [ ] Proper import paths for Output SDK packages (@flowsdk/core, @flowsdk/llm, etc.)

Workflow Structure

  • [ ] Workflow exported in entrypoint.ts: export * from './path/to/workflow.js';
  • [ ] All external operations wrapped in Temporal activities (steps)
  • [ ] Proper error handling with ApplicationFailure patterns
  • [ ] Retry policies configured appropriately

Documentation & Testing

  • [ ] Comprehensive plan document created with all required sections
  • [ ] Testing strategy defined with specific test scenarios
  • [ ] Implementation checklist provided for developers
  • [ ] All code examples are complete and would compile

Quality Validation

Plan Completeness Check

Ensure the workflow plan includes:

  • [ ] Overview: Clear purpose and use case definition
  • [ ] Technical Specifications: Complete input/output schemas with Zod validation
  • [ ] Activity Definitions: Each activity fully specified with purpose, I/O, and error handling
  • [ ] Prompt Engineering: LLM prompts designed (if applicable) with template variables
  • [ ] Orchestration Logic: Step-by-step workflow execution flow
  • [ ] Retry Policies: Configured for each activity with appropriate timeouts
  • [ ] Testing Requirements: Comprehensive test scenarios and commands

Implementation Readiness

Confirm the plan is ready for implementation:

  • [ ] All schemas defined with exact field types and descriptions
  • [ ] Every activity specified with input/output/processing logic
  • [ ] External services identified with specific SDK client references
  • [ ] Error handling complete for all failure scenarios
  • [ ] Testing scenarios documented with expected outcomes
  • [ ] Performance requirements clear with measurable criteria

Deliverable Verification

Required Outputs

Verify these deliverables were created or updated:

  • [ ] Workflow plan document with full specifications
  • [ ] Activity schemas with Zod validation
  • [ ] Prompt templates (if LLM integration required)
  • [ ] Testing strategy with specific commands
  • [ ] Implementation checklist for developers

Next Steps Documentation

Ensure the following guidance is provided:

  • [ ] Clear handoff to implementation phase
  • [ ] Specific Output SDK CLI commands to execute
  • [ ] Dependencies to install (if any)
  • [ ] Configuration requirements documented
  • [ ] Success criteria clearly defined

Error Reporting

If any issues were encountered:

  1. Document the specific issue and step where it occurred
  2. Explain any deviations from the planned process
  3. Provide recommendations for resolution
  4. Note any missing information that prevented completion

Final Validation

Before marking the workflow planning complete:

  • [ ] Developer can implement without additional clarification
  • [ ] All Output SDK patterns and conventions are followed
  • [ ] Testing approach is comprehensive and executable
  • [ ] Documentation is clear and complete
  • [ ] Plan aligns with project's existing workflow patterns
Skills similaires