版本：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 |
文件：.claude/commands/hybridOps/agents/process-mapper-pv.md
命令：/process-mapper
角色：Morgan Chen - 流程发现专家
真实性评分：0.90（非常高）
目的： 发现、分析和映射当前业务流程，以识别自动化机会和痛点。
主要命令：
*map-process <process-name>- 综合流程映射*analyze-opportunity <opportunity-id>- ROI 和可行性分析*identify-pain-points <process-id>- 识别瓶颈
主要输出：
- 流程图（当前状态）
- 利益相关者识别
- 痛点分析
- 自动化机会评估
集成点：
- 接收：业务需求，利益相关者输入
- 产生：第 2 阶段（架构）的流程文档
- 传递给：process-architect-pv
验证：无（发现阶段 - 仅收集信息）
文件：.claude/commands/hybridOps/agents/process-architect-pv.md
命令：/process-architect
角色：Alex Thornton - 系统架构师
真实性评分：0.85（高）
目的： 设计系统架构并定义具有战略一致性的最终状态愿景。
主要命令：
*design-architecture <process-id>- 系统架构设计*define-vision <initiative-name>- 最终状态愿景定义*assess-feasibility <design-id>- 技术可行性评估
主要输出：
- 系统架构图
- 数据流规范
- 集成点
- 最终状态愿景文档
集成点：
- 接收：第 1 阶段的流程图
- 产生：第 3 阶段（执行者）的架构规范
- 传递给：executor-designer-pv
验证：检查点 1 - 战略一致性（PV_BS_001）
- 最终状态愿景清晰度 >=0.8
- 战略优先级评分 >=0.7
- 无否决条件
文件：.claude/commands/hybridOps/agents/executor-designer-pv.md
命令：/executor-designer
角色：Taylor Kim - 执行者设计专家
真实性评分：0.88（非常高）
目的： 定义角色并为流程的每个步骤分配执行者（人类或人工智能），进行一致性验证。
主要命令：
*design-executors <process-id>- 执行者角色设计*assess-coherence <executor-id>- 真实性和一致性评估*assign-responsibilities <process-id>- 创建 RACI 矩阵
主要输出：
- 执行者定义
- 角色描述
- 一致性评估
- RACI 矩阵
集成点：
- 接收：第 2 阶段的架构规范
- 产生：第 4 阶段（工作流）的执行者分配
- 传递给：workflow-designer-pv
验证：检查点 2 - 一致性验证（PV_PA_001）
- 所有执行者：真实性 >=0.7（否决）
- 加权一致性 >=0.8 以获批准
- 系统遵循性 >=0.6
文件：.claude/commands/hybridOps/agents/workflow-designer-pv.md
命令：/workflow-designer
角色：Jordan Rivers - 流程优化和工作流自动化专家
真实性评分：0.85（高）
目的： 设计详细的工作流，识别自动化候选项，计算 ROI 并应用护栏。
主要命令：
*analyze-process <process-id>- 流程效率分析*design-workflow <process-id>- 带自动化逻辑的工作流设计*calculate-roi <automation-id>- ROI 和损益平衡点计算
主要输出：
- 工作流图（Mermaid）
- 自动化规范
- ROI 计算
- 护栏定义
集成点：
- 接收：第 3 阶段的执行者分配
- 产生：第 5 阶段（QA）的工作流规范
- 传递给：qa-validator-pv
验证：检查点 3 - 自动化准备就绪（PV_PM_001）
- 转折点：频率 >2x/月
- 护栏存在（否决）
- 标准化 >=0.7
主要特性：PV_PM_001 自动化转折点检测 - 仅当频率超过 2x/月阈值时才自动化。
文件：.claude/commands/hybridOps/agents/qa-validator-pv.md
命令：/qa-validator
角色：Samantha Torres - 质量保证和验证专家
真实性评分：0.95（极高）
目的： 定义质量门、测试策略并根据 10 维 META_AXIOMAS 框架进行验证。
主要命令：
*validate-phase <phase-id>- 特定阶段验证*check-compliance <workflow-id>- 公理合规性检查*generate-test-plan <workflow-id>- 生成综合测试计划
主要输出：
- 带测试用例的测试计划
- 质量门定义
- 公理评估报告
- 回归测试套件
集成点：
- 接收：第 4 阶段的工作流规范
- 产生：第 6 阶段（ClickUp）的质量保证文档
- 传递给：clickup-engineer-pv
验证：检查点 4 - 公理合规性
- 总体评分 >=7.0/10.0
- 无个人维度 <6.0/10.0
- 10 个维度已验证：真实性、一致性、战略一致性、运营卓越、创新能力、风险管理、资源优化、利益相关者价值、可持续性、适应性
主要特性：如果检测到严重质量问题，具有否决权以阻止部署。
文件：.claude/commands/hybridOps/agents/clickup-engineer-pv.md
命令：/clickup-engineer
角色：Chris Park - ClickUp 工作空间工程师
真实性评分：0.80（高）
目的： 使用适当的任务解剖和自动化触发器创建 ClickUp 工作空间结构。
主要命令：
*create-workspace <workflow-id>- ClickUp 工作空间创建*generate-tasks <workflow-id>- 带任务解剖的任务生成*setup-automation <task-id>- 自动化触发器设置
主要输出：
- 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 中获批准）
文件：.claude/commands/hybridOps/agents/agent-creator-pv.md
命令：/agent-creator
角色：Elena Vasquez 博士 - 人工智能代理架构师和角色设计师
真实性评分：0.80（高）
目的： 设计人工智能代理角色，校准真实性评分，生成具有公理验证的代理配置。
主要命令：
*design-agent <agent-name>- 交互式代理设计*generate-yaml <agent-id>- 代理配置 YAML 导出*test-agent-coherence <agent-id>- 角色命令对齐验证
主要输出：
- 代理角色定义（Markdown）
- 代理 YAML 配置
- 真实性校准报告
- 命令参考文档
集成点：
- 接收：第 6 阶段的 ClickUp 配置
- 产生：第 8 阶段（验证审查）的代理定义
- 传递给：validation-reviewer-pv
验证：无（代理创建由之前的验证指导）
主要特性：带正当理由的真实性校准 - 确保代理对其角色具有适当的信心水平。
文件：.claude/commands/hybridOps/agents/validation-reviewer-pv.md
命令：/validation-reviewer
角色：Marcus Chen - 最终质量门审查者和批准权限
真实性评分：0.90（非常高）
目的： 进行端到端工作流审查，评估风险并提供具有否决权限的正式批准。
主要命令：
*review-workflow <workflow-id>- 综合端到端审查*assess-risks <workflow-id>- 风险识别和缓解验证*generate-signoff <workflow-id>- 生成正式批准文件
主要输出：
- 工作流审查报告
- 带缓解计划的风险评估
- 批准文件
- 部署准备就绪报告
集成点：
- 接收：第 7 阶段的代理定义
- 产生：第 9 阶段（文档）的批准文件
- 传递给：documentation-writer-pv
验证：无（验证代理自我验证）
主要特性：如果检测到严重差距（未缓解的高风险、缺少安全机制、公理违规），具有否决权以阻止部署。
文件：.claude/commands/hybridOps/agents/documentation-writer-pv.md
命令：/documentation-writer
角色：Rachel Morgan - 技术文档撰写者和知识架构师
真实性评分：0.85（高）
目的： 将已批准的工作流转换为清晰且可操作的文档，包括运行手册、指南和流程文档。
主要命令：
*generate-runbook <workflow-name>- 操作运行手册创建*write-guide <guide-type> <topic>- 用户指南生成*document-process <process-name>- 业务流程文档
主要输出：
- 操作运行手册
- 用户指南
- 流程文档
- 故障排除指南
- 快速参考卡
集成点：
- 接收：第 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）。
# 激活代理
/agent-name
# 示例：激活 QA 验证器
/qa-validator
# 代理确认激活
Samantha Torres (QA Validator) 已激活。
PV Mind 已加载，真实性评分：0.95
第 5 阶段（质量保证和验证）的上下文已准备好。
命令：*validate-phase, *check-compliance, *generate-test-plan
使用 *help 获取完整命令列表。# 执行主要命令
*command-name <parameters>
# 示例：验证第 4 阶段的输出
*validate-phase 4
# 示例：生成运行手册
*generate-runbook hybrid-ops-workflow所有代理都接收工作流上下文：
const workflowContext = pvMind.getPhaseContext(<phase-number>);
// 返回：{
// phaseNumber: <number>,
// phaseName: "<name>",
// inputs: [<previous-phase-outputs>],
// outputs: [<expected-deliverables>],
// dependencies: [<phase-ids>],
// guardrails: [<safety-checks>]
// }所有代理都使用带以下内容的 Pedro Valério 思维集成：
4 级信念层级：
- 级别 -4：存在（真理基础）
- 级别 -3：认识论（知识验证）
- 级别 -2：社会（协作背景）
- 级别 0：操作（执行规则）
- PV_BS_001：未来回溯法（战略一致性）
- PV_PA_001：一致性扫描（执行者验证）
- PV_PM_001：自动化转折点（频率限制 2x）
所有代理都应用：
- 带重试逻辑的错误处理
- 验证规则（最小限制）
- 回滚机制（检查点恢复）
- 极端情况文档
症状：命令 /agent-name 无法识别
解决方案：检查代理文件是否存在于 .claude/commands/hybridOps/agents/<agent-name>-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 (本文档)
| 版本 | 日期 | 更改 | 故事 |
|---|---|---|---|
| 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 团队