⚡

质量门并行 quality-gates-parallel

此技能用于并行启动多个质量检查子代理，以提高代码质量和安全性，包括测试执行、代码审查、自动修复等。

测试 0 次安装 0 次浏览 更新于 3/4/2026

版本：2.88.0

name: 质量门并行 description: 使用Claude Code 2.1+原生Task工具并行启动4个质量子代理。分析后读取结果，供协调器决策。 允许工具：TaskCreate, TaskUpdate, TaskList, TaskGet, Read, Write, Bash, 上下文：分叉

质量门并行（原生多代理）

协调器集成，使用Claude Code 2.1+原生Task工具并行启动4个质量子代理，并具有队友协调功能。

v2.88主要变更（模型无关）

  • 模型无关：使用~/.claude/settings.json或CLI/env vars中配置的模型
  • 无需标志：与配置的默认模型一起工作
  • 灵活：与GLM-5, Claude, Minimax或任何配置的模型一起工作
  • 设置驱动：通过ANTHROPIC_DEFAULT_*_MODEL环境变量选择模型

快速开始

# 实施后启动质量检查
/quality-gates-parallel src/auth.ts --complexity 7

# 分析后读取聚合结果
/quality-gates-parallel --read-results <run_id>

原生多代理架构（Claude Code 2.1.16+）

基于：claude-sneakpeek native-multiagent-gates

可用特性

  • TaskCreate：为子代理创建任务
  • TaskUpdate：更新任务状态
  • TaskList：列出所有任务
  • TaskGet：获取任务详情
  • 并行执行：多个代理独立工作
  • 结果聚合：收集所有代理的发现

代理团队集成（v2.88）

最佳场景：集成（代理团队+自定义子代理）

并行质量门结合代理团队协调和专门的ralph-*代理，进行全面的并行验证。

为什么选择场景C用于质量门并行

  • 专为并行执行设计
  • 质量钩子（TeammateIdle, TaskCompleted）是核心功能
  • 需要协调分配4种不同的检查类型
  • 任务列表跟踪所有并行质量阶段

子代理角色

子代理 质量门角色
ralph-tester 测试执行和覆盖
ralph-reviewer 代码质量分析
ralph-coder 自动修复应用

代理团队并行工作流程

当代理团队活跃时：

  1. 团队领导创建质量门任务列表
  2. ralph-tester并行运行测试
  3. ralph-reviewer执行linting和类型检查
  4. ralph-coder应用自动修复

原生集成

这项技能为代理团队设计：

  • 每个质量阶段的TaskCreate
  • 通过Task工具并行执行
  • TaskCompleted钩子用于门验证

工作流程

第1阶段：启动并行质量检查

实施后（协调器步骤6b），启动4个子代理：

// 协调器集成的伪代码
1. 任务复杂性分类（1-10）
2. 如果复杂性 >= 5：
3.    使用TaskCreate创建4个任务：
4.      - 安全审计员（sec-context-depth）
5.      - 代码审查员（code-reviewer）
6.      - 代码清理（deslop）
7.      - 文本清理（stop-slop）
8.    任务并行执行（非阻塞）
9.    继续协调器工作流程
10. 否则：跳过质量检查（低复杂性）

第2阶段：读取结果（预验证）

验证前（协调器步骤7），轮询结果：

# 运行结果读取器
.claude/scripts/read-quality-results.sh <run_id>

第3阶段：协调器决策

协调器读取聚合结果并决定：

// 决策逻辑的伪代码
results = readQualityResults(run_id)

if (results.total_findings == 0) {
    // 无问题 - 继续验证
    proceedToValidation()
} else if (results.critical_findings > 0) {
    // 严重问题 - 阻止并修复
    blockMerge()
    requireFixes()
} else {
    // 小问题 - 仅建议
    proceedWithWarnings()
}

质量代理（4并行）

1. 安全审计员（sec-context-depth）

代理：security-auditor或glm-reviewer 目的：27个安全反模式（OWASP/CWE） 发现：P0（严重），P1（高），P2（中） 命令：/sec-context-depth <file>

覆盖范围：

  • 86% XSS失败率检测
  • 72% Java AI代码漏洞检测
  • SQL注入，命令注入，XSS
  • JWT无算法，弱哈希，ECB模式

2. 代码审查员（code-reviewer）

代理：code-reviewer或codex-cli 目的：官方Claude Code插件，4个并行代理 特性：置信度评分（≥80阈值） 命令：/code-review <file>

架构：

  • 代理#1：CLAUDE.md合规性
  • 代理#2：CLAUDE.md合规性（冗余）
  • 代理#3：Bug检测（仅变更）
  • 代理#4：Git责任/历史分析

3. 代码清理（deslop）

代理：refactorer或gemini-cli 目的：去除AI生成的代码冗余 命令：/deslop

移除：

  • 与代码库不一致的额外注释
  • 额外的防御性检查/try/catch块
  • 为类型问题而强制转换为any
  • 内联导入（移动到顶部）

4. 文本清理（stop-slop）

代理：docs-writer或minimax 目的：从文本中去除AI写作模式 命令：/stop-slop <file>

移除：

  • 填充短语（“Certainly!”, “It is important to note”）
  • 结构性陈词滥调（二元对比，戏剧性分裂）
  • 风格习惯（三重化，节拍性结尾）

与协调器集成

步骤6b.5：质量并行（NEW）

位置：实施后（6b），验证前（7）

触发：复杂性 >= 5或与安全相关的代码

执行：

# 非阻塞并行启动
.claude/scripts/quality-coordinator.sh <target_file> <complexity>

输出：包含4个任务定义的JSON

步骤7：验证与质量结果

验证前：读取聚合结果

# 轮询完成检查
.claude/scripts/read-quality-results.sh <run_id>

输出：包含所有发现的聚合JSON

决策逻辑：

  • 0发现：继续验证
  • 严重发现：阻止并要求修复
  • 轻微发现：仅警告

结果存储

.claude/quality-results/
├── aggregated_<run_id>.json        # 聚合结果
├── sec-context_<run_id>.json       # 安全发现
├── code-review_<run_id>.json       # 代码审查发现
├── deslop_<run_id>.json            # 代码清理发现
├── stop-slop_<run_id>.json         # 文本清理发现
├── *_<run_id>.done                 # 完成标记
└── coordinator.log                # 执行日志

使用示例

手动执行

# 启动质量检查
./.claude/scripts/quality-coordinator.sh src/auth.ts 7

# 读取结果
./.claude/scripts/read-quality-results.sh 20250128_221437_12345

协调器集成

# 在协调器步骤6b（实施后）
quality_check_result=$(./.claude/scripts/quality-coordinator.sh "$file" "$complexity")

# 解析结果并创建任务
if [[ "$complexity" -ge 5 ]]; then
    # 使用TaskCreate创建4个任务
    # 任务并行执行
    # 存储run_id以供后续检索
fi

# 在协调器步骤7（验证前）
quality_results=$(./.claude/scripts/read-quality-results.sh "$run_id")

# 解析结果并做出决策
critical_count=$(echo "$quality_results" | jq '.summary.critical_findings // 0')
if [[ "$critical_count" -gt 0 ]]; then
    # 阻止并要求修复
    echo "CRITICAL: $critical_count security issues found"
else
    # 继续验证
    echo "No critical issues, proceeding to validation"
fi

脚本

钩子

  • quality-parallel-async.sh：编辑/写操作的异步钩子
    • 使用settings.json中的async: true
    • 非阻塞后台执行
    • 结果存储以供后续读取

版本历史

  • 1.0.0 （2026-01-28）：初始原生多代理集成
    • 基于Claude Code 2.1.16+Task工具
    • 4个并行质量代理
    • 结果聚合和轮询

行动报告（v2.93.0）

此技能生成完整的自动报告以追踪：

自动报告

当此技能完成时，会自动生成：

  1. 在Claude对话中：可见结果
  2. 在仓库中：docs/actions/quality-gates-parallel/{timestamp}.md
  3. 元数据JSON：.claude/metadata/actions/quality-gates-parallel/{timestamp}.json

报告内容

每个报告包括：

  • ✅ 摘要：执行的任务描述
  • ✅ 执行细节：持续时间，迭代次数，修改的文件
  • ✅ 结果：发现的错误，建议
  • ✅ 下一步行动：建议的下一步行动

查看先前报告

# 列出此技能的所有报告
ls -lt docs/actions/quality-gates-parallel/

# 查看最新的报告
cat $(ls -t docs/actions/quality-gates-parallel/*.md | head -1)

# 搜索失败的报告
grep -l "Status: FAILED" docs/actions/quality-gates-parallel/*.md

手动生成（可选）

source .claude/lib/action-report-lib.sh
start_action_report "quality-gates-parallel" "任务描述"
# ... 执行 ...
complete_action_report "success" "摘要" "建议"

系统参考