AgentSkillsCN

external-validation

制定调用外部大语言模型验证服务的协议,为PRD与实施方案提供客观公正的评审意见。在以下场景中使用此技能:(1) 使用外部模型验证PRD;(2) 以全新视角验证实施方案;(3) 配置外部验证器的选择;(4) 将内部与外部的验证反馈整合;或(5) 处理外部验证过程中的错误。

SKILL.md
--- frontmatter
name: external-validation
description: Protocol for invoking external LLM validation services to provide unbiased critique of PRDs and implementation plans. Use this skill when (1) validating PRDs with an external model, (2) validating implementation plans with fresh perspective, (3) configuring external validator selection, (4) merging internal and external validation feedback, or (5) handling external validation errors.

External Validation

Protocol for invoking external LLM validation to provide unbiased critique of artifacts.

Core Principle

WHY External Validation: Internal validation (same model that created the artifact) can suffer from:

  • Model blindness (model won't catch its own mistakes)
  • Confirmation bias (validating own reasoning)
  • Pattern repetition (same model, same blind spots)

External validation uses a DIFFERENT model to provide fresh perspective.

When to Use External Validation

StageArtifactRequired?
validate-prdPRDOptional but recommended
validate-planImplementation PlanOptional but recommended
validate-implImplementationRequired (code tools)

Model Selection Strategy

Rule: External validator MUST be a different model family than the creator.

Creator ModelRecommended Validator
GPT-5.2Claude Opus or Gemini
Claude OpusGPT-5.2 or Gemini
Claude SonnetGPT-5.2 or Gemini
GeminiGPT-5.2 or Claude Opus

Feedback Merging Protocol

When combining internal and external validation feedback:

  1. Status: FAIL if either validator fails
  2. Issues: Combine and deduplicate from both validators
  3. Trust external: If external finds critical issues internal missed

Status File Integration

json
{
  "stages": {
    "validate-prd": {
      "status": "completed",
      "output": "PRD validated",
      "validator": "internal + gemini-3.0-pro"
    }
  },
  "externalValidation": {
    "prdValidation": {
      "status": "completed",
      "model": "gemini-3.0-pro",
      "result": "PASS",
      "issues": 0
    }
  }
}

Error Handling

If external service is unavailable:

  • Fall back to internal validation only
  • Record skipped status with reason
  • Continue pipeline with warning

Anti-Patterns

  • ❌ Using same model for external validation
  • ❌ Skipping external validation on complex PRDs
  • ❌ Ignoring external feedback when internal passes

Environment Variables

bash
EXTERNAL_VALIDATE=true              # Enable external validation
EXTERNAL_VALIDATION_MODEL="gemini-3.0-pro"  # Model to use
EXTERNAL_VALIDATION_TIMEOUT=30000   # 30 seconds