37f 产品研发工作流 Agent

事件到达 OpenClaw
      │
      ▼
识别事件类型
      │
      ├─→ 飞书消息事件 → 意图识别 → 匹配 Skill
      ├─→ 多维表格变更事件 → 解析变更字段 → 匹配状态转换 Skill
      ├─→ GitHub Webhook → 解析 PR/CI 事件 → 匹配代码 Skill
      └─→ 定时事件 → 直接触发对应 Skill
      │
      ▼
加载上下文（从记忆系统读取相关信息）
      │
      ▼
执行 Skill
      │
      ▼
写入记忆 → 回复用户/更新表格/发送通知

# requirement-create
 
从用户消息中提取需求信息，创建需求记录并归档到飞书多维表格。
 
## 触发条件
用户消息包含"创建需求"、"新需求"、"提需求"、"我想做一个"等关键词。
 
## 执行步骤
1. 从用户消息中提取以下信息：
   - 标题（必填）
   - 描述（可选，如果用户未提供则追问）
   - 优先级（可选，默认 P2）
   - 所属模块（可选，根据内容自动推断）
2. 如果标题或描述信息不完整，向用户追问缺失字段
3. 从记忆中读取多维表格 app_token 和需求表 table_id
4. 调用 lark-mcp 在需求多维表格中创建记录，状态设为"待评审"
5. 在需求评审群发送通知消息，包含需求摘要和多维表格链接
6. 将需求信息写入记忆，格式：
   - 记忆键：requirement_{record_id}
   - 内容：标题、描述、优先级、创建人、创建时间
 
## 输出格式
✅ 需求已创建
- 标题：{title}
- 优先级：{priority}
- 状态：待评审
- 模块：{module}
- 多维表格：[查看]({bitable_link})
 
已通知评审群，等待评审。
 
## 示例输出
✅ 需求已创建
- 标题：新增 Solana 课程模块
- 优先级：P1
- 状态：待评审
- 模块：课程
- 多维表格：[查看](https://xxx.feishu.cn/base/xxx)
 
已通知评审群，等待评审。
 
## 权限要求
- 飞书多维表格写入权限
- 飞书消息发送权限
 
## 错误处理
- 多维表格写入失败：提示用户稍后重试，记录错误日志
- 用户信息不完整：最多追问 2 次，仍不完整则创建草稿状态

# requirement-prd-generate
 
根据需求信息和知识库上下文，自动生成 PRD 文档草稿。
 
## 触发条件
- 需求状态从"待评审"变为"已通过"时自动触发
- 用户消息包含"生成 PRD"、"写 PRD"
 
## 执行步骤
1. 从记忆中读取需求详情（标题、描述、优先级、模块）
2. 调用 knowledge-rag-search 检索相关的历史需求和技术文档
3. 基于需求信息和检索结果，生成 PRD 文档，包含：
   - 背景与目标
   - 用户故事
   - 功能需求（按优先级排列）
   - 非功能需求（性能、安全、兼容性）
   - 技术方案建议（基于知识库中的架构文档）
   - 验收标准
   - 里程碑计划
4. 调用 lark-mcp 创建飞书文档，写入 PRD 内容
5. 更新需求多维表格的 PRD 链接字段
6. 在需求评审群发送通知："PRD 已生成，请 @产品经理 审阅"
7. 将 PRD 文档 token 写入记忆
 
## 输出格式
📄 PRD 已生成
- 需求：{requirement_title}
- PRD 文档：[查看]({doc_link})
- 状态：AI 生成-待审阅
 
请 @产品经理 审阅后确认。
 
## PRD 模板
 
### {需求标题} — 产品需求文档
 
#### 1. 背景与目标
（基于需求描述和知识库上下文生成）
 
#### 2. 用户故事
- 作为 [角色]，我希望 [功能]，以便 [价值]
 
#### 3. 功能需求
| 编号 | 功能点 | 优先级 | 描述 |
|------|--------|--------|------|
 
#### 4. 非功能需求
- 性能：
- 安全：
- 兼容性：
 
#### 5. 技术方案建议
（基于知识库中的架构文档生成）
 
#### 6. 验收标准
- [ ] 标准 1
- [ ] 标准 2
 
#### 7. 里程碑
| 阶段 | 时间 | 交付物 |
 
## 权限要求
- 飞书文档创建权限
- 飞书多维表格读写权限
- 向量数据库读取权限（RAG 检索）
- 飞书消息发送权限

# code-pr-review
 
当 GitHub PR 创建或更新时，自动生成审查摘要并关联需求。
 
## 触发条件
- GitHub PR 创建或更新事件
- 用户消息包含"查看 PR"、"PR 审查"
 
## 执行步骤
1. 通过 GitHub MCP 获取 PR 详情（标题、描述、变更文件列表、diff）
2. 从 PR 描述或分支名中提取关联的需求编号
3. 从记忆中读取关联需求的上下文
4. 分析 PR 变更：
   - 变更文件数和行数统计
   - 主要变更内容摘要
   - 潜在风险点（大文件变更、敏感文件修改、缺少测试）
5. 生成审查摘要并发送到开发群
6. 如果 PR 关联了需求，更新需求状态为"待审查"
 
## 输出格式
🔍 PR 审查摘要：#{pr_number} {pr_title}
 
📊 变更统计：
- 文件数：{files_changed}
- 新增：+{additions} 行
- 删除：-{deletions} 行
 
📝 主要变更：
- {change_summary_1}
- {change_summary_2}
 
⚠️ 关注点：
- {risk_point_1}
- {risk_point_2}
 
🔗 关联需求：{requirement_title}
🔗 PR 链接：{pr_url}
 
## 权限要求
- GitHub MCP（PR 读取权限）
- 飞书消息发送权限
- 飞书多维表格读写权限（更新需求状态）

# requirement-test-verify
 
测试完成后更新需求状态，生成测试报告摘要。
 
## 触发条件
- 用户消息包含"测试通过"、"验收通过"、"测试不通过"
- 缺陷表中关联需求的所有缺陷状态变为"已关闭"
 
## 执行步骤
 
### 测试通过
1. 更新需求状态为"待部署"
2. 统计该需求关联的缺陷数量和修复情况
3. 生成测试报告摘要
4. 通知运维团队准备部署
 
### 测试不通过
1. 保持需求状态为"测试中"
2. 自动创建缺陷记录（调用 bug-create）
3. 通知开发负责人
 
## 输出格式（测试通过）
✅ 测试验收通过
- 需求：{requirement_title}
- 关联缺陷：{bug_count} 个（全部已关闭）
- 状态：待部署
- 已通知运维团队
 
## 权限要求
- 飞书多维表格读写权限
- 飞书消息发送权限

# requirement-lifecycle
 
需求全生命周期编排。
 
## 编排类型
事件驱动状态机
 
## 状态转换定义
 
### 待评审 → 已通过
- 触发：飞书卡片回调，action = "approve"
- 执行：requirement-status-change（PM Agent）
- 自动链式触发：requirement-prd-generate（PM Agent）
- 委派：dev-agent → code-issue-create
 
### 已通过 → 开发中
- 触发：PM 确认 PRD + 设计评审通过
- 执行：requirement-status-change（PM Agent）
 
### 开发中 → 待审查
- 触发：GitHub PR 创建事件
- 执行：code-pr-review（Dev Agent）
- 读取共享记忆：requirement_{id}
 
### 待审查 → 测试中
- 触发：GitHub PR 合并事件
- 执行：requirement-status-change（PM Agent）
 
### 测试中 → 待部署
- 触发：用户消息"测试通过"
- 执行：requirement-test-verify（PM Agent）
- 委派：dev-agent → ops-deploy-trigger（需人工确认）
 
### 待部署 → 已上线
- 触发：运维确认部署（飞书卡片回调）
- 执行：requirement-status-change（PM Agent）
- 通知：项目群上线公告

requirement-create
  │ 写入记忆：requirement_rec001 = {title, priority, status, creator}
  │
  ▼
requirement-prd-generate
  │ 读取记忆：requirement_rec001
  │ 写入记忆：prd_doc_token = {doc_token, doc_url}
  │
  ▼
code-pr-review
  │ 读取记忆：requirement_rec001, prd_doc_token
  │ 写入记忆：pr_info = {pr_number, pr_url, review_summary}
  │
  ▼
requirement-test-verify
  │ 读取记忆：requirement_rec001, pr_info
  │ 写入记忆：test_result = {passed, bug_count}
  │
  ▼
ops-deploy-trigger
    读取记忆：requirement_rec001, pr_info, test_result

## 链式调用示例：需求通过 → 自动生成 PRD
 
requirement-status-change Skill 检测到状态变为"已通过"后：
1. 更新多维表格状态
2. 将需求信息写入记忆
3. 在回复消息中提示："需求已通过，正在自动生成 PRD..."
4. OpenClaw 识别到需要调用 requirement-prd-generate
5. requirement-prd-generate 从记忆中读取需求信息，生成 PRD

{
  "msg_type": "interactive",
  "card": {
    "header": {
      "title": { "tag": "plain_text", "content": "📋 需求评审" },
      "template": "blue"
    },
    "elements": [
      {
        "tag": "div",
        "text": {
          "tag": "lark_md",
          "content": "**需求标题**：新增 Solana 课程模块\n**优先级**：P1\n**提出人**：张三\n**描述**：用户对 Solana 生态学习需求增长，需要新增完整的 Solana 开发课程，包含基础、智能合约、DApp 开发三个阶段。"
        }
      },
      {
        "tag": "action",
        "actions": [
          {
            "tag": "button",
            "text": { "tag": "plain_text", "content": "✅ 通过" },
            "type": "primary",
            "value": { "action": "approve", "record_id": "rec001" }
          },
          {
            "tag": "button",
            "text": { "tag": "plain_text", "content": "❌ 拒绝" },
            "type": "danger",
            "value": { "action": "reject", "record_id": "rec001" }
          },
          {
            "tag": "button",
            "text": { "tag": "plain_text", "content": "💬 需要讨论" },
            "value": { "action": "discuss", "record_id": "rec001" }
          }
        ]
      }
    ]
  }
}

审批请求发出
    │
    ├─→ 24h 内确认 → 正常流转
    │
    ├─→ 24h 未确认 → 发送提醒消息
    │       │
    │       ├─→ 48h 内确认 → 正常流转
    │       │
    │       └─→ 48h 未确认 → 升级到上级审批人
    │
    └─→ 部署确认：无超时，必须人工确认