validate-agent 是一个验证型智能体技能，职责是核对技术方案中的选型是否站得住脚。它被触发后会接收计划内容、计划文件路径和交接目录，然后按固定流程产出一份验证交接文档。
用途 该技能面向“技术方案评审”环节，在计划进入实施之前，对计划里涉及的技术决策做一轮外部与内部交叉核查，尽量提前发现过时、废弃、有安全或稳定性风险的选型。它本身不负责写代码，只负责验证并输出结论。
主要能力
- 提取技术选型：读取计划，列出所有技术决策，包括所选库/框架、提出的模式与架构、使用的 API 或外部服务以及实现方法。
- 历史先例检查（RAG-Judge）：在联网检索之前，先查询 Artifact Index 中是否有类似工作，返回过往成功的交接（可参考的模式）、失败的交接（应避免的模式）以及可能被计划遗漏的差距。如果 RAG-judge 判定为 FAIL，会把关键差距记录下来带入最终报告。使用的命令为： uv run python scripts/braintrust_analyze.py --rag-judge --plan-file <plan-path>
- 逐项联网研究：对每个技术选择进行检索验证，使用的查询范式包括： WebSearch(query="[library/pattern] best practices 2024 2025") WebSearch(query="[library] vs alternatives [year]") WebSearch(query="[pattern] deprecated OR recommended [year]") 关注点包括：是否仍是推荐做法、是否已有更好替代、是否存在已知废弃或问题、是否有安全隐患。
- 结论分级：对每个技术选择给出 VALID（当前最佳实践，无问题）、OUTDATED（存在更好替代）、DEPRECATED（不应使用）、RISKY（安全或稳定性担忧）、UNKNOWN（资料不足，记为假设）之一。
- 生成验证交接：按约定文件名 validation-<plan-name>.md 写入交接目录，包含前置元数据（date、type、status、plan_file）、总体状态、RAG-Judge 先例检查结果、逐项技术选择的分项结论（用途、状态、发现、建议、来源）、汇总（可继续 / 需复核 / 必须更改）以及建议与实施注意事项。
- 回传协调器：返回“Validation Complete”、状态、交接文件路径、已检查的技术选择数量与问题数量；若状态为 VALIDATED 则说明计划可进入实施，若为 NEEDS REVIEW 则列出问题并建议先与用户讨论。
使用方式 该技能以子智能体方式被调用，示例中通过 Task 传入 subagent_type="general-purpose"、model="haiku"，并把技能内容与上下文（待验证计划内容、计划路径、交接目录）一并交给它执行。执行遵循固定的五步流程：提取技术选择 → 用 RAG-judge 查历史先例 → 对每项做联网检索 → 评估结论 → 写验证交接。
适用场景
- 技术实施计划在动手前的选型评审。
- 需要确认所选第三方库、较新框架、特定版本要求、外部 API/服务或新型架构模式是否符合当前最佳实践。
- 需要参考团队历史成功与失败经验来发现计划遗漏。
限制与边界
- 不做代码实现，只输出验证结论与交接文档。
- 对标准库与成熟工具不展开外部验证，视为始终有效，例如 Python 标准库（argparse、asyncio、json、os、pathlib 等）、标准模式（REST API、JSON 配置、环境变量）以及成熟工具（pytest、git、make）；验证重点放在第三方库、较新框架、特定版本要求、外部 API/服务与新颖架构模式上。
- 不得因“看起来没问题”而跳过验证，也不得在没有证据的情况下标记问题；不因细枝末节的风格偏好阻塞流程；找不到确切信息时需明确记为 UNKNOWN 或假设。
- 验证阈值：当所有选择有效或仅有非阻塞的次要建议时返回 VALIDATED；当出现 DEPRECATED、RISKY（安全）、明显 OUTDATED 且存在更优替代，或存在关键架构担忧时返回 NEEDS REVIEW。
该技能的官方页面与仓库来源已在资料中给出，具体价格、平台支持范围等信息暂未提供。