# HybridOps PV 代理参考指南 > 🌐 [EN](../agent-reference-guide.md) | [PT](../pt/agent-reference-guide.md) | [ES](../es/agent-reference-guide.md) | **ZH** --- **版本**：2.0 **最后更新**：2025-10-19 **故事**：1.9 - PV 代理完整实现 --- ## 概述 本指南为 HybridOps 工作流中所有 9 个用 PV 增强的代理提供了全面的参考。每个代理都设计为处理 9 阶段工作流的特定阶段，整合了 Pedro Valério（PV）思维来增强决策制定、验证和质量保证。 --- ## 快速参考 | 阶段 | 代理名称 | 命令 | 工作流中的角色 | 真实性评分 | | ---- | ----------------------- | ----------------------- | -------------------------------------------- | ---------- | | 1 | process-mapper-pv | `/process-mapper` | 流程发现和分析 | 0.90 | | 2 | process-architect-pv | `/process-architect` | 系统架构设计 | 0.85 | | 3 | executor-designer-pv | `/executor-designer` | 执行者分配和角色定义 | 0.88 | | 4 | workflow-designer-pv | `/workflow-designer` | 流程优化和工作流自动化 | 0.85 | | 5 | qa-validator-pv | `/qa-validator` | 质量保证和验证 | 0.95 | | 6 | clickup-engineer-pv | `/clickup-engineer` | ClickUp 中的任务创建 | 0.80 | | 7 | agent-creator-pv | `/agent-creator` | 人工智能代理架构和角色设计 | 0.80 | | 8 | validation-reviewer-pv | `/validation-reviewer` | 最终质量门审查和批准 | 0.90 | | 9 | documentation-writer-pv | `/documentation-writer` | 技术文档和知识架构 | 0.85 | --- ## 代理详细配置文件 ### 阶段 1：Process Mapper（发现） **文件**：`.claude/commands/hybridOps/agents/process-mapper-pv.md` **命令**：`/process-mapper` **角色**：Morgan Chen - 流程发现专家 **真实性评分**：0.90（非常高） **目的**： 发现、分析和映射当前业务流程，以识别自动化机会和痛点。 **主要命令**： - `*map-process ` - 综合流程映射 - `*analyze-opportunity ` - ROI 和可行性分析 - `*identify-pain-points ` - 识别瓶颈 **主要输出**： - 流程图（当前状态） - 利益相关者识别 - 痛点分析 - 自动化机会评估 **集成点**： - **接收**：业务需求，利益相关者输入 - **产生**：第 2 阶段（架构）的流程文档 - **传递给**：process-architect-pv **验证**：无（发现阶段 - 仅收集信息） --- ### 阶段 2：Process Architect（架构） **文件**：`.claude/commands/hybridOps/agents/process-architect-pv.md` **命令**：`/process-architect` **角色**：Alex Thornton - 系统架构师 **真实性评分**：0.85（高） **目的**： 设计系统架构并定义具有战略一致性的最终状态愿景。 **主要命令**： - `*design-architecture ` - 系统架构设计 - `*define-vision ` - 最终状态愿景定义 - `*assess-feasibility ` - 技术可行性评估 **主要输出**： - 系统架构图 - 数据流规范 - 集成点 - 最终状态愿景文档 **集成点**： - **接收**：第 1 阶段的流程图 - **产生**：第 3 阶段（执行者）的架构规范 - **传递给**：executor-designer-pv **验证**：**检查点 1 - 战略一致性（PV_BS_001）** - 最终状态愿景清晰度 >=0.8 - 战略优先级评分 >=0.7 - 无否决条件 --- ### 阶段 3：Executor Designer（执行者分配） **文件**：`.claude/commands/hybridOps/agents/executor-designer-pv.md` **命令**：`/executor-designer` **角色**：Taylor Kim - 执行者设计专家 **真实性评分**：0.88（非常高） **目的**： 定义角色并为流程的每个步骤分配执行者（人类或人工智能），进行一致性验证。 **主要命令**： - `*design-executors ` - 执行者角色设计 - `*assess-coherence ` - 真实性和一致性评估 - `*assign-responsibilities ` - 创建 RACI 矩阵 **主要输出**： - 执行者定义 - 角色描述 - 一致性评估 - RACI 矩阵 **集成点**： - **接收**：第 2 阶段的架构规范 - **产生**：第 4 阶段（工作流）的执行者分配 - **传递给**：workflow-designer-pv **验证**：**检查点 2 - 一致性验证（PV_PA_001）** - 所有执行者：真实性 >=0.7（否决） - 加权一致性 >=0.8 以获批准 - 系统遵循性 >=0.6 --- ### 阶段 4：Workflow Designer（工作流自动化） **文件**：`.claude/commands/hybridOps/agents/workflow-designer-pv.md` **命令**：`/workflow-designer` **角色**：Jordan Rivers - 流程优化和工作流自动化专家 **真实性评分**：0.85（高） **目的**： 设计详细的工作流，识别自动化候选项，计算 ROI 并应用护栏。 **主要命令**： - `*analyze-process ` - 流程效率分析 - `*design-workflow ` - 带自动化逻辑的工作流设计 - `*calculate-roi ` - ROI 和损益平衡点计算 **主要输出**： - 工作流图（Mermaid） - 自动化规范 - ROI 计算 - 护栏定义 **集成点**： - **接收**：第 3 阶段的执行者分配 - **产生**：第 5 阶段（QA）的工作流规范 - **传递给**：qa-validator-pv **验证**：**检查点 3 - 自动化准备就绪（PV_PM_001）** - 转折点：频率 >2x/月 - 护栏存在（否决） - 标准化 >=0.7 **主要特性**：PV_PM_001 自动化转折点检测 - 仅当频率超过 2x/月阈值时才自动化。 --- ### 阶段 5：QA Validator（质量保证） **文件**：`.claude/commands/hybridOps/agents/qa-validator-pv.md` **命令**：`/qa-validator` **角色**：Samantha Torres - 质量保证和验证专家 **真实性评分**：0.95（极高） **目的**： 定义质量门、测试策略并根据 10 维 META_AXIOMAS 框架进行验证。 **主要命令**： - `*validate-phase ` - 特定阶段验证 - `*check-compliance ` - 公理合规性检查 - `*generate-test-plan ` - 生成综合测试计划 **主要输出**： - 带测试用例的测试计划 - 质量门定义 - 公理评估报告 - 回归测试套件 **集成点**： - **接收**：第 4 阶段的工作流规范 - **产生**：第 6 阶段（ClickUp）的质量保证文档 - **传递给**：clickup-engineer-pv **验证**：**检查点 4 - 公理合规性** - 总体评分 >=7.0/10.0 - 无个人维度 <6.0/10.0 - 10 个维度已验证：真实性、一致性、战略一致性、运营卓越、创新能力、风险管理、资源优化、利益相关者价值、可持续性、适应性 **主要特性**：如果检测到严重质量问题，具有否决权以阻止部署。 --- ### 阶段 6：ClickUp Engineer（任务管理） **文件**：`.claude/commands/hybridOps/agents/clickup-engineer-pv.md` **命令**：`/clickup-engineer` **角色**：Chris Park - ClickUp 工作空间工程师 **真实性评分**：0.80（高） **目的**： 使用适当的任务解剖和自动化触发器创建 ClickUp 工作空间结构。 **主要命令**： - `*create-workspace ` - ClickUp 工作空间创建 - `*generate-tasks ` - 带任务解剖的任务生成 - `*setup-automation ` - 自动化触发器设置 **主要输出**： - ClickUp 工作空间结构 - 带 8 字段任务解剖的任务 - 自动化触发器 - 任务依赖关系图 **集成点**： - **接收**：第 5 阶段的质量保证文档 - **产生**：第 7 阶段（代理）的 ClickUp 配置 - **传递给**：agent-creator-pv **验证**：**检查点 5 - 任务解剖** - 所有 8 个任务解剖字段存在：task_name、status、responsible_executor、execution_type、estimated_time、input、output、action_items - 依赖关系正确映射 - 一致的责任人（在 PV_PA_001 中获批准） --- ### 阶段 7：Agent Creator（人工智能代理设计） **文件**：`.claude/commands/hybridOps/agents/agent-creator-pv.md` **命令**：`/agent-creator` **角色**：Elena Vasquez 博士 - 人工智能代理架构师和角色设计师 **真实性评分**：0.80（高） **目的**： 设计人工智能代理角色，校准真实性评分，生成具有公理验证的代理配置。 **主要命令**： - `*design-agent ` - 交互式代理设计 - `*generate-yaml ` - 代理配置 YAML 导出 - `*test-agent-coherence ` - 角色命令对齐验证 **主要输出**： - 代理角色定义（Markdown） - 代理 YAML 配置 - 真实性校准报告 - 命令参考文档 **集成点**： - **接收**：第 6 阶段的 ClickUp 配置 - **产生**：第 8 阶段（验证审查）的代理定义 - **传递给**：validation-reviewer-pv **验证**：无（代理创建由之前的验证指导） **主要特性**：带正当理由的真实性校准 - 确保代理对其角色具有适当的信心水平。 --- ### 阶段 8：Validation Reviewer（最终质量门） **文件**：`.claude/commands/hybridOps/agents/validation-reviewer-pv.md` **命令**：`/validation-reviewer` **角色**：Marcus Chen - 最终质量门审查者和批准权限 **真实性评分**：0.90（非常高） **目的**： 进行端到端工作流审查，评估风险并提供具有否决权限的正式批准。 **主要命令**： - `*review-workflow ` - 综合端到端审查 - `*assess-risks ` - 风险识别和缓解验证 - `*generate-signoff ` - 生成正式批准文件 **主要输出**： - 工作流审查报告 - 带缓解计划的风险评估 - 批准文件 - 部署准备就绪报告 **集成点**： - **接收**：第 7 阶段的代理定义 - **产生**：第 9 阶段（文档）的批准文件 - **传递给**：documentation-writer-pv **验证**：无（验证代理自我验证） **主要特性**：如果检测到严重差距（未缓解的高风险、缺少安全机制、公理违规），具有否决权以阻止部署。 --- ### 阶段 9：Documentation Writer（知识管理） **文件**：`.claude/commands/hybridOps/agents/documentation-writer-pv.md` **命令**：`/documentation-writer` **角色**：Rachel Morgan - 技术文档撰写者和知识架构师 **真实性评分**：0.85（高） **目的**： 将已批准的工作流转换为清晰且可操作的文档，包括运行手册、指南和流程文档。 **主要命令**： - `*generate-runbook ` - 操作运行手册创建 - `*write-guide ` - 用户指南生成 - `*document-process ` - 业务流程文档 **主要输出**： - 操作运行手册 - 用户指南 - 流程文档 - 故障排除指南 - 快速参考卡 **集成点**： - **接收**：第 8 阶段的批准文件 - **产生**：供最终用户和运营团队的最终文档 - **传递给**：最终用户、运营团队、培训团队、审计/合规 **验证**：无（文档质量通过故事的定义完成进行验证） **主要特性**：版本控制与更新日志生成 - 所有文档都包含版本历史和迁移指南。 --- ## 工作流集成 ### 顺序流 ``` 阶段 1：发现 (process-mapper-pv) ↓ (流程图) 阶段 2：架构 (process-architect-pv) ↓ [检查点 1：战略一致性] ↓ (架构规范) 阶段 3：执行者 (executor-designer-pv) ↓ [检查点 2：一致性验证] ↓ (执行者分配) 阶段 4：工作流 (workflow-designer-pv) ↓ [检查点 3：自动化准备就绪] ↓ (工作流规范) 阶段 5：质量保证和验证 (qa-validator-pv) ↓ [检查点 4：公理合规性] ↓ [检查点 5：任务解剖] ↓ (质量保证文档) 阶段 6：ClickUp 创建 (clickup-engineer-pv) ↓ (ClickUp 配置) 阶段 7：代理创建 (agent-creator-pv) ↓ (代理定义) 阶段 8：验证审查 (validation-reviewer-pv) ↓ (批准文件) 阶段 9：文档 (documentation-writer-pv) ↓ (最终文档) [工作流完成] ``` ### 验证检查点 | 检查点 | 阶段 | 代理 | 启发式/验证器 | 否决条件 | | ------ | ---- | -------------------- | ------------- | -------------- | | 1 | 2 | process-architect-pv | PV_BS_001 | 无 | | 2 | 3 | executor-designer-pv | PV_PA_001 | 真实性 <0.7 | | 3 | 4 | workflow-designer-pv | PV_PM_001 | 无护栏 | | 4 | 5 | qa-validator-pv | axioma-validator | 维度 <6.0 | | 5 | 5 | qa-validator-pv | task-anatomy | 字段缺失 | --- ## 真实性评分指南 真实性评分校准代理如何保守地做出断言和建议： | 评分范围 | 描述 | 代理示例 | | ---------- | -------------------------------------- | -------------------------------------------------------------------------------- | | 0.95-1.00 | 极高 - 不偏不倚和客观的评估 | qa-validator-pv (0.95) | | 0.85-0.94 | 非常高 - 诚实，最小乐观主义 | process-mapper-pv (0.90), validation-reviewer-pv (0.90), executor-designer-pv (0.88) | | 0.75-0.84 | 高 - 客观但允许一些创意 | process-architect-pv (0.85), workflow-designer-pv (0.85), documentation-writer-pv (0.85) | | 0.70-0.74 | 中高 - 平衡的现实主义 | clickup-engineer-pv (0.80), agent-creator-pv (0.80) | **注**：0.70 以下的评分在一致性验证中触发否决条件（检查点 2）。 --- ## 常见模式 ### 代理激活 ```bash # 激活代理 /agent-name # 示例：激活 QA 验证器 /qa-validator # 代理确认激活 Samantha Torres (QA Validator) 已激活。 PV Mind 已加载，真实性评分：0.95 第 5 阶段（质量保证和验证）的上下文已准备好。 命令：*validate-phase, *check-compliance, *generate-test-plan 使用 *help 获取完整命令列表。 ``` ### 命令执行 ```bash # 执行主要命令 *command-name # 示例：验证第 4 阶段的输出 *validate-phase 4 # 示例：生成运行手册 *generate-runbook hybrid-ops-workflow ``` ### 工作流上下文访问 所有代理都接收工作流上下文： ```javascript const workflowContext = pvMind.getPhaseContext(); // 返回：{ // phaseNumber: , // phaseName: "", // inputs: [], // outputs: [], // dependencies: [], // guardrails: [] // } ``` --- ## PV Mind 集成 所有代理都使用带以下内容的 Pedro Valério 思维集成： ### META_AXIOMAS 框架 4 级信念层级： - **级别 -4**：存在（真理基础） - **级别 -3**：认识论（知识验证） - **级别 -2**：社会（协作背景） - **级别 0**：操作（执行规则） ### PV 启发式 - **PV_BS_001**：未来回溯法（战略一致性） - **PV_PA_001**：一致性扫描（执行者验证） - **PV_PM_001**：自动化转折点（频率限制 2x） ### 护栏 所有代理都应用： - 带重试逻辑的错误处理 - 验证规则（最小限制） - 回滚机制（检查点恢复） - 极端情况文档 --- ## 故障排除 ### 代理未找到 **症状**：命令 `/agent-name` 无法识别 **解决方案**：检查代理文件是否存在于 `.claude/commands/hybridOps/agents/-pv.md` ### 检查点验证失败 **症状**：工作流在检查点停止 **解决方案**：查看详细反馈，修正问题，重新尝试检查点。对于否决条件，必须在继续之前修正。 ### 缺少代理上下文 **症状**：代理无法访问上一阶段的输出 **解决方案**：检查工作流 YAML 是否具有正确的阶段依赖关系，确认上一阶段已成功完成。 --- ## 文件位置 ``` .claude/commands/hybridOps/ ├── agents/ │ ├── process-mapper-pv.md (阶段 1) │ ├── process-architect-pv.md (阶段 2) │ ├── executor-designer-pv.md (阶段 3) │ ├── workflow-designer-pv.md (阶段 4) │ ├── qa-validator-pv.md (阶段 5) │ ├── clickup-engineer-pv.md (阶段 6) │ ├── agent-creator-pv.md (阶段 7) │ ├── validation-reviewer-pv.md (阶段 8) │ └── documentation-writer-pv.md (阶段 9) ├── workflows/ │ └── hybrid-ops-pv.yaml (工作流编排) └── docs/ ├── workflow-diagram.md (工作流可视化) └── agent-reference-guide.md (本文档) ``` --- ## 相关文档 - [工作流图](../guides/hybridOps/workflow-diagram.md) - 9 阶段工作流的可视化表示 - [工作流 YAML](../guides/hybridOps/hybrid-ops-pv.yaml) - 工作流编排配置 --- ## 版本历史 | 版本 | 日期 | 更改 | 故事 | | ---- | ---------- | ----------------------------------------------------------- | ---- | | 2.0 | 2025-10-19 | 添加了 5 个缺失的代理（阶段 4、5、7、8、9），更新了工作流参考 | 1.9 | | 1.0 | 2025-10-19 | 初始指南，有 4 个现有代理 | 1.8 | --- **状态**：完整 - 所有 9 个代理已实现并验证 **最后验证**：2025-10-19 **维护者**：AIOX HybridOps 团队