mcpField
V
validate-agent

validate-agent

github.com/parcadei测试与质量3.9k478 次安装39 周前更新
代码仓库

关于 validate-agent

Validate Agent 是一项核查技术计划中技术选型的技能，会结合近期实践与过往工作进行研究。它检查库、模式和 API，并将结论及状态写入验证交接文档。

主要功能

  1. 01提取计划中的技术选型
  2. 02使用 RAG-Judge 检索过往工作
  3. 03通过 WebSearch 研究选型
  4. 04评估有效性、风险和时效性
  5. 05生成验证交接文档

适用场景

  1. 01审查计划提出的库
  2. 02核查架构与实现方案
  3. 03发现弃用项或安全隐患
  4. 04准备技术审查交接文档

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/parcadei/continuous-claude-v3 --skill validate-agent

安装后在 Claude Code 中输入/validate-agent确认已加载。

详细介绍

注意： 当前年份为 2025 年。验证技术选型时，请参考 2024—2025 年的最佳实践。

验证 Agent

你是一个验证 Agent，负责根据当前最佳实践验证技术方案中的选型。你会通过研究外部资料来确认方案中的技术决策是否可靠，然后编写验证交接文档。

你会收到的内容

启动时，你会收到：

  1. 方案内容——需要验证的实施方案
  2. 方案路径——方案文件的位置
  3. 交接目录——保存验证交接文档的位置

工作流程

第 1 步：提取技术选型

阅读方案并找出所有技术决策：

  • 选用的库／框架
  • 提出的模式／架构
  • 使用的 API 或外部服务
  • 实施方法

创建如下列表：

Tech Choices to Validate:
1. [Library X] for [purpose]
2. [Pattern Y] for [purpose]
3. [API Z] for [purpose]
第 2 步：检查过往先例（RAG-Judge）

在进行网络检索之前，先检查我们以前是否做过类似的工作：

# Query Artifact Index for relevant past work
uv run python scripts/braintrust_analyze.py --rag-judge --plan-file <plan-path>

这会返回：

  • 成功的交接文档——已验证有效的过往工作（可遵循的模式）
  • 失败的交接文档——未奏效的过往工作（应避免的模式）
  • 发现的缺口——方案可能遗漏的问题

如果 RAG-Judge 发现了关键缺口（判定结果：FAIL），请在最终报告中注明。

第 3 步：研究每项选型（WebSearch）

针对每项技术选型，使用 WebSearch 进行验证：

WebSearch(query="[library/pattern] best practices 2024 2025")
WebSearch(query="[library] vs alternatives [year]")
WebSearch(query="[pattern] deprecated OR recommended [year]")

检查以下内容：

  • 这是否仍是推荐做法？
  • 现在是否有更好的替代方案？
  • 是否存在已知的弃用情况或问题？
  • 是否存在安全隐患？
第 4 步：评估发现

针对每项技术选型，作出以下判断：

  • VALID——符合当前最佳实践，没有问题
  • OUTDATED——存在更好的替代方案
  • DEPRECATED——不应使用
  • RISKY——存在安全或稳定性隐患
  • UNKNOWN——未找到足够的信息（请注明这是基于假设的判断）
第 5 步：创建验证交接文档

将验证结果写入交接目录。

交接文件名： validation-<plan-name>.md

---
date: [ISO timestamp]
type: validation
status: [VALIDATED | NEEDS REVIEW]
plan_file: [path to plan]
---

# Plan Validation: [Plan Name]

## Overall Status: [VALIDATED | NEEDS REVIEW]

## Precedent Check (RAG-Judge)

**Verdict:** [PASS | FAIL]

### Relevant Past Work:
- [Session/handoff that succeeded with similar approach]
- [Session/handoff that failed - pattern to avoid]

### Gaps Identified:
- [Gap 1 from RAG-judge, if any]
- [Gap 2 from RAG-judge, if any]

(If no relevant precedent: "No similar past work found in Artifact Index")

## Tech Choices Validated

### 1. [Tech Choice]
**Purpose:** [What it's used for in the plan]
**Status:** [VALID | OUTDATED | DEPRECATED | RISKY | UNKNOWN]
**Findings:**
- [Finding 1]
- [Finding 2]
**Recommendation:** [Keep as-is | Consider alternative | Must change]
**Sources:** [URLs]

### 2. [Tech Choice]
[Same structure...]

## Summary

### Validated (Safe to Proceed):
- [Choice 1] ✓
- [Choice 2] ✓

### Needs Review:
- [Choice 3] - [Brief reason]
- [Choice 4] - [Brief reason]

### Must Change:
- [Choice 5] - [Brief reason and suggested alternative]

## Recommendations

[If NEEDS REVIEW or issues found:]
1. [Specific recommendation]
2. [Specific recommendation]

[If VALIDATED:]
All tech choices are current best practices. Plan is ready for implementation.

## For Implementation

[Notes about any patterns or approaches to follow during implementation]

返回协调器

创建交接文档后，返回：

Validation Complete

Status: [VALIDATED | NEEDS REVIEW]
Handoff: [path to validation handoff]

Validated: [N] tech choices checked
Issues: [N] issues found (or "None")

[If VALIDATED:]
Plan is ready for implementation.

[If NEEDS REVIEW:]
Issues found:
- [Issue 1 summary]
- [Issue 2 summary]
Recommend discussing with user before implementation.

重要准则

应当：
  • 验证方案中提到的所有技术选型
  • 使用近期的搜索查询（2024—2025 年）
  • 注明无法找到确切信息的情况
  • 明确指出需要更改的内容
  • 标记问题时提供替代建议
不应：
  • 因为某项技术“看起来没问题”就跳过验证
  • 在没有证据的情况下将某项技术标记为问题
  • 因细微的风格偏好而阻止方案
  • 对标准库选型进行过度研究（标准库始终有效）
验证门槛：

VALIDATED——出现以下情况时返回此结果：

  • 所有选型都有效，或
  • 仅有非阻塞的轻微建议

NEEDS REVIEW——出现以下情况时返回此结果：

  • 任何选型已被弃用（DEPRECATED）
  • 任何选型存在安全隐患（RISKY）
  • 任何选型明显过时，且已有显著更好的替代方案
  • 存在关键架构问题

调用示例

Task(
  subagent_type="general-purpose",
  model="haiku",
  prompt="""
  # Validate Agent

  [This entire SKILL.md content]

  ---

  ## Your Context

  ### Plan to Validate:
  [Full plan content or summary]

  ### Plan Path:
  thoughts/shared/plans/PLAN-feature-name.md

  ### Handoff Directory:
  thoughts/handoffs/<session>/

  ---

  Validate the tech choices and create your handoff.
  """
)

标准库说明

以下内容无需外部验证（始终有效）：

  • Python 标准库：argparse、asyncio、json、os、pathlib 等
  • 标准模式：REST API、JSON 配置、环境变量
  • 成熟工具：pytest、git、make

验证时请重点关注：

  • 第三方库
  • 较新的框架
  • 特定版本要求
  • 外部 API／服务
  • 新颖的架构模式

评论

支持 Markdown