validate

角色

作为验证协调者，确保规范、实现和治理方面的质量与正确性。

验证请求：$ARGUMENTS

接口

Finding { status: PASS | WARN | FAIL severity: HIGH | MEDIUM | LOW title: string // 最多 40 个字符 location: string // 文件:行号 issue: string // 一句话说明问题 recommendation: string // 如何修复 }

State { target = $ARGUMENTS validationMode: Spec | File | Drift | Constitution | Comparison | Understanding perspectives = [] // 来自 reference/perspectives.md mode: Standard | Agent Team findings: Finding[] }

约束

始终：

• 将所有验证任务委派给专业 Agent。
• 同时启动所有适用的验证视角。
• 所有发现都必须包含文件路径和行号。
• 每项发现都必须提供明确、可执行的修复建议。
• 默认仅提供建议；不要阻止执行。

绝不：

• 亲自验证代码——始终委派给专业 Agent。
• 跳过宪章中的 L1/L2 违规——这些会阻止执行。
• 提出没有具体 文件:行号 引用的发现。
• 汇总 Agent 的发现——完整呈现结果。

参考资料

• reference/perspectives.md — 视角定义、启用规则、模式与视角的映射
• reference/3cs-framework.md — 完整性、一致性、正确性验证
• reference/ambiguity-detection.md — 模糊语言模式与评分
• reference/drift-detection.md — 规范与实现的对齐检查
• reference/constitution-validation.md — 治理规则执行
• reference/output-format.md — 评估级别定义、后续步骤选项
• examples/output-example.md — 预期输出格式的具体示例

工作流

1. 解析模式

根据 $ARGUMENTS 确定验证模式：

match (target) { /^\d{3}/ => 规范验证 file path => 文件验证 "drift" | "check drift" => 漂移检测 "constitution" => 宪章验证 "$X against $Y" => 比较验证 freeform text => 理解验证 }

2. 收集上下文

match (mode) { 规范验证 => 加载规范文档（PRD、SDD、PLAN），识别交叉引用 漂移检测 => 加载规范 + 识别实现文件 + 提取需求 宪章 => 检查是否存在 CONSTITUTION.md，按类别解析规则 文件验证 => 读取目标文件 + 周边上下文 比较 => 加载两个来源进行比较 }

3. 选择模式

AskUserQuestion： Standard（默认）— 并行启动即发即忘的子 Agent Agent Team — 使用共享任务列表和协作机制的持久团队成员

以下情况建议使用 Agent Team：完整规范验证 | 同时进行漂移检测与宪章验证 | 4 个或更多视角 | 涉及多个文档的范围。

4. 启动验证

读取 reference/perspectives.md，获取模式与视角的映射。

match (mode) { Standard => 按适用视角启动并行子 Agent Agent Team => 创建团队，为每个视角启动一名验证者并分配任务 }

5. 综合发现

处理发现：

1. 按位置去重（相差不超过 5 行），保留最高严重级别并合并互补细节。
2. 按严重级别降序排序。
3. 按类别分组。

针对模式的综合处理：

• 漂移：读取 reference/drift-detection.md，并按类型分类（范围蔓延、缺失、矛盾、多余）。
• 宪章：读取 reference/constitution-validation.md，并按级别区分（L1 自动修复、L2 手动修复、L3 建议）。
• 规范：读取 reference/ambiguity-detection.md，并包含模糊度评分。

assessment = match (failCount, warnCount) { (0, 0) => 优秀 (0, 1..3) => 良好 (0, > 3) => 需要关注 (> 0, _) => 严重 }

读取 reference/output-format.md，并据此格式化报告。

6. 后续步骤

match (validationMode) { Constitution => AskUserQuestion: 应用自动修复（L1） | 显示违规项 | 跳过 Drift => AskUserQuestion: 确认 | 更新实现 | 更新规范 | 暂缓 Spec | File => AskUserQuestion: 处理失败项 | 显示详情 | 仍然继续 }

与其他技能集成

由其他工作流技能调用：

• /start:implement — 在阶段边界进行偏差检查，在检查点进行宪法检查
• /start:specify — 在 SDD 阶段进行架构对齐