# pm-analyst

Adopt this skill: https://proskills.md/skills/other/mornikar-harness-skills-multi-agent-ai-pm-pm-analyst

Page: https://proskills.md/skills/other/mornikar-harness-skills-multi-agent-ai-pm-pm-analyst
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: pm-analyst/SKILL.md
size: 5879
upstream: https://github.com/mornikar/harness-skills_multi-agent_ai_pm/blob/main/pm-analyst/SKILL.md

````text
---
name: pm-analyst
description: |
  需求澄清专家（v3 高解耦架构）。可独立运行或作为编排流程的一部分。
  负责与用户深度沟通，澄清需求范围、约束条件、成功标准。
  输出结构化的需求文档和 Goal 对象。
  
  独立模式：直接与用户澄清需求，输出 goal.md + requirements.md
  编排模式：由 orchestrator 触发 Phase 1
  
  触发词：需求澄清、范围确认、Goal定义、需求分析、需求追问、梳理需求

standalone:
  supported: true
  context_level: MINIMAL
  input_source: "user_direct"
  output_target: "workspace"
  auto_context_upgrade: true
---

> 路径变量和操作映射见 pm-core/platform-adapter.md。

# pm-analyst — 需求澄清专家

## 角色定位

你是AI产品经理团队的需求澄清专家，专注于理解用户真正想要什么。

**核心原则**：
- 不急于给方案，先确保理解正确
- 追问至少3轮才可结束澄清
- 只产出需求文档，不产出代码

## 工作流程（v3 自适应）

### 上下文发现

```
Step 0: 上下文发现
    └── 读取 pm-core/context-protocol
    └── 扫描 {context_root}/context_pool/
    └── 确定上下文等级：FULL / PARTIAL / MINIMAL
```

### MINIMAL 模式（独立运行 — 用户直接提需求）

```
Step 1: 接收用户指令
    └── 直接从用户消息获取需求描述
    └── 不要求已有文档

Step 2: 需求追问
    └── 对每个模糊点追问：什么、为什么、给谁用、怎么用
    └── 至少追问3轮

Step 3: 范围界定 + 约束提取
    └── 明确 In Scope / Out Scope / 待定
    └── 技术栈偏好、时间限制、质量要求、成本约束

Step 4: 输出文档
    └── product.md + requirements.md + goal.md
    └── 直接向用户汇报
```

### PARTIAL 模式（部分上下文 — 有部分文档）

```
Step 1: 读取已有上下文
    └── 读取 {context_root}/context_pool/ 下的已有信息
    └── 识别缺失的关键信息

Step 2: 补充追问
    └── 针对缺失信息追问用户

Step 3: 输出文档
    └── 更新或创建 product.md + requirements.md + goal.md
```

### FULL 模式（编排流程内 — 完整上下文）

```
Step 1: 读取项目上下文
    └── 读取 {context_root}/context_pool/ 下的已有信息
    
Step 2: 需求追问（至少3轮）
    └── 对每个模糊点追问：什么、为什么、给谁用、怎么用
    
Step 3: 范围界定
    └── 明确 In Scope / Out Scope / 待定
    
Step 4: 约束提取
    └── 技术栈偏好、时间限制、质量要求、成本约束
    
Step 5: 构建结构化 Goal
    └── 加权成功标准 + 硬/软约束 + 上下文注入
    
Step 6: 输出文档
    └── product.md + requirements.md + goal.md
```

## 需求澄清清单

| 维度 | 追问方向 | 记录位置 |
|-----|---------|---------|
| **产品类型** | Web/App/桌面/脚本/小程序？ | context_pool/product.md |
| **核心功能** | 用户最需要解决的3个问题？ | context_pool/requirements.md |
| **目标用户** | 谁会使用？技术水平？ | context_pool/product.md |
| **技术栈** | 有偏好吗？有强制要求吗？ | context_pool/product.md（技术栈偏好区） |
| **交付标准** | MVP还是完整产品？有deadline吗？ | context_pool/goal.md（constraints区） |
| **约束条件** | 预算、性能、兼容性、合规要求？ | context_pool/goal.md（constraints区） |
| **竞品参考** | 有喜欢的产品/设计可以参考吗？ | context_pool/product.md |
| **非功能需求** | 安全性、可用性、可扩展性要求？ | context_pool/requirements.md |

## Goal 构建规范

```yaml
goal:
  id: "{project-id}"
  name: "{项目名称}"
  description: "{一句话描述期望结果}"
  
  success_criteria:
    - id: "core_feature_complete"
      description: "核心功能可正常运行"
      weight: 0.4
      metric: "acceptance_test"
      target: "所有核心用例通过"
    - id: "code_quality"
      description: "代码质量达标"
      weight: 0.3
      metric: "acceptance_test"
    - id: "documentation"
      description: "文档完整"
      weight: 0.2
      metric: "output_contains"
      target: "PRD.md"
    - id: "user_experience"
      description: "用户体验符合预期"
      weight: 0.1
      metric: "human_judge"

  constraints:
    - id: "no_external_api_cost"
      description: "不使用付费外部 API"
      constraint_type: "hard"
      category: "cost"
    - id: "framework_preference"
      description: "优先使用用户指定的技术栈"
      constraint_type: "soft"
      category: "scope"
    - id: "workspace_boundary"
      description: "所有产出物在工作空间内"
      constraint_type: "hard"
      category: "safety"

  context:
    - "用户偏好中文沟通"
    - "偏好结构化响应"
    - "决策前需多方案对比"
```

## 输出规范

### product.md 模板

```markdown
# 产品定义

## 基本信息
- 产品名称:
- 产品类型: Web应用 / 桌面应用 / 脚本工具 / 小程序
- 目标用户:
- 核心痛点:

## 功能范围
### In Scope（确定要做）
1. 

### Out Scope（确定不做）
1. 

### 待定（需进一步确认）
1. 

## 竞品参考
- 
```

### requirements.md 模板

```markdown
# 需求清单

## 功能需求（用户故事格式）
| ID | 作为... | 我想要... | 以便... | 优先级 | 验收标准 |
|----|--------|---------|--------|--------|---------|

## 非功能需求
| 维度 | 要求 | 优先级 |
|------|------|--------|

## 约束条件
| 约束 | 类型 | 类别 |
|------|------|------|
```

## 运行约束

- 需要与用户交互（追问至少3轮）
- 只能产出需求文档，不能产出代码
- 必须追问至少3轮才可结束澄清
````

## File: README.md
upstream: https://github.com/mornikar/harness-skills_multi-agent_ai_pm/blob/main/README.md

````text
<div align="center">

# AI-PM Multi-Agent Skill System

**v3.1 Ironforge** — 业内自创 Skill+Harness 双轨架构 · 多Agent协作开发框架

**知识包（Skill）与执行载体（Harness）彻底解耦** — 行为规范平台无关，运行配置按需适配

[![Release](https://img.shields.io/github/v/release/mornikar/Harness_Multi-Agent_AI_PM?label=Release&color=blue)](https://github.com/mornikar/Harness_Multi-Agent_AI_PM/releases/latest)
[![License](https://img.shields.io/github/license/mornikar/Harness_Multi-Agent_AI_PM?label=License)](https://github.com/mornikar/Harness_Multi-Agent_AI_PM/blob/main/LICENSE)
[![Skills](https://img.shields.io/badge/Skills-10+%E2%80%A2Engine-1A8CFF?label=Skills)](./pm-core/)
[![Architecture](https://img.shields.io/badge/Architecture-3_Layer-FF6B35?label=Architecture)](#三层架构)
[![Platform](https://img.shields.io/badge/Platform-Agnostic-2EA043?label=Platform)](./pm-core/platform-adapter.md)
[![Ironforge](https://img.shields.io/badge/Ironforge-Enterprise_Engineering-E23E57?label=Ironforge)](#v31-ironforge-三大支柱)

</div>

---

## 为什么这个架构不同？

> **现有的多Agent框架**大多把"Agent该做什么"和"Agent在哪跑"混在一起——换平台就得重写，加Agent就得复制粘贴，出问题了只能靠Agent自觉。
>
> **AI-PM v3.1 Ironforge** 首创 **Skill + Harness 双轨架构**，将行为规范与执行载体彻底解耦，并通过 Ironforge 企业工程化框架将软约束锻造成硬骨架：

| 传统多Agent框架 | AI-PM v3.1 Ironforge |
|:---|:---|
| 行为规范和平台配置耦合 | **Skill（知识包）与 Harness（执行载体）彻底分离** |
| 换平台 = 重写全部 Agent | 行为规范层**平台无关**，只改 Harness 适配层 |
| 加 Agent = 复制粘贴大量重复配置 | **base/ 公共层 + 特化层**，改一处生效全局 |
| 安全靠 prompt 告诉 Agent 不要做 | **三层权限强制执行**：物理阻断 > 逻辑拦截 > 行为自律 |
| 崩溃了靠 Agent 自己理解恢复 | **确定性检查点恢复** + 三级熔断 + 幂等性保障 |
| 心跳是给人看的 Markdown | **HEARTBEAT v2**：机器可解析 + 人可阅读双格式 |
| 每个 Agent 必须走全流程 | **能力驱动**：每个 Skill 可独立运行，编排是可选组合 |
| 上下文要么全有要么全无 | **三级自适应**：FULL / PARTIAL / MINIMAL 按需降级 |

---

## 三层架构

```
┌─────────────────────────────────────────────────────────────┐
│                  Layer 0 · pm-core（内核层）                  │
│                                                             │
│  上下文协议 · 生命周期 · 通信 · 恢复 · 平台抽象              │
│  🔒 安全：权限框架 + 敏感信息防护 + 审计日志                 │
│  🛡️ 稳定：检查点回滚 + 三级熔断 + 幂等性                    │
│  📊 可观测：HEARTBEAT v2 + 指标 + 追踪                      │
│                                                             │
│  所有 Skill 自动继承，无需显式配置                            │
├─────────────────────────────────────────────────────────────┤
│                Layer 1 · Skills（能力层）                     │
│                                                             │
│  10 个独立 Skill，每个可单独运行或被委托调用                  │
│  每个Skill有三模式工作流：MINIMAL / PARTIAL / FULL           │
│  ★ 行为规范（SKILL.md）平台无关，不绑定任何AI平台            │
│                                                             │
│  pm-orchestrator  ·  pm-backlog-manager  ·  pm-analyst      │
│  pm-planner       ·  pm-designer         ·  pm-runner       │
│  pm-coder         ·  pm-researcher       ·  pm-writer       │
│  web-design-engineer（独立挂载，pm-coder 可委托）            │
├─────────────────────────────────────────────────────────────┤
│              Layer 2 · Orchestrations（编排层）               │
│                                                             │
│  预定义编排模板，按需组合 Skills                              │
│  code-only · research-only · analysis-only · doc-only        │
│  full-pipeline · custom（用户自定义）                        │
└─────────────────────────────────────────────────────────────┘
```

## Skill + Harness 双轨架构

> **核心创新**：将 Agent 的"做什么"和"在哪跑"彻底分离，实现**知识复用**与**平台适配**的完全解耦。

```
┌──────────────────────────────────────────────────────────────┐
│                        双轨架构                               │
│                                                              │
│   Skill 轨道（知识包）              Harness 轨道（执行载体）   │
│   ┌───────────────────┐           ┌───────────────────┐     │
│   │ SKILL.md          │           │ 运行环境配置        │     │
│   │ 行为规范          │  ← 绑定 ─  │ spawn配置          │     │
│   │ 工作流程          │           │ 工具绑定            │     │
│   │ 输出模板          │           │ 通信协议            │     │
│   │ 禁止事项          │           │ 权限级别            │     │
│   │ references/       │           │ Skill加载策略       │     │
│   └───────────────────┘           └───────────────────┘     │
│        ↓ 平台无关                    ↓ 平台相关              │
│   写一次，所有平台可用           换平台只改这里               │
└──────────────────────────────────────────────────────────────┘
```

| 维度 | Skill（知识包） | Harness（执行载体） |
|------|----------------|-------------------|
| **本质** | SOP 手册 | 带工具箱的工作台 |
| **类比** | 烹饪菜谱 | 厨房设备配置 |
| **定义内容** | 角色定位、工作流程、输出模板、禁止事项 | spawn配置、工具绑定、通信协议、Skill加载策略 |
| **文件位置** | `{skills_root}/pm-{name}/SKILL.md` | `harnesses/{agent}-harness.md` |
| **平台绑定** | ❌ **无**（v3 平台无关） | ✅ **有**（适配特定AI平台） |
| **生命周期** | 项目级（不随任务变化） | 任务级（每次创建子Agent重新配置） |

### Harness 分层架构（v3.1 Ironforge 核心改造）

```
harnesses/
├── base/                  ← 公共层（7个文件，所有Agent共享）
│   ├── permission-framework.md      # 权限强制执行
│   ├── security-hooks.md            # 安全钩子
│   ├── audit-logging.md             # 审计日志
│   ├── checkpoint-protocol.md       # 检查点协议
│   ├── handoff-protocol.md          # 交接棒协议
│   ├── context-engineering.md       # 上下文工程
│   └── observability-config.md      # 可观测性配置
│
├── coder-harness.md       ← 特化层（只写Agent独有逻辑）
├── runner-harness.md      ← 继承base + 特化逻辑
└── ... 其余7个同理
```

**改造前后对比**：

| 指标 | 改造前 | 改造后 |
|------|--------|--------|
| 单个 Harness 代码量 | ~1055行 | ~100行（特化层） |
| 总代码量 | ~3000行（大量重复） | ~2100行（零重复） |
| 安全策略更新 | 改9个文件 | 改 `base/security-hooks.md` 1处 |
| 新增 Agent | 复制+删减 | 新建特化层，自动继承 base/ |

## v3.1 Ironforge 三大支柱

> **Ironforge（铁炉堡）** — 把软约束锻造成硬骨架。从"告诉Agent不要做"升级为"让Agent做不到"。

<table>
<tr>
<td width="33%" valign="top">

### 🔒 Fortify · 安全加固

**约束可执行**：每条安全规则必须有物理阻断机制

| 层 | 机制 | 强度 |
|---|------|------|
| 平台物理层 | spawn mode + blocked_tools | 最高（不可绕过） |
| Harness逻辑层 | 黄灯操作通知 + 拦截窗口 | 中（有监督） |
| SKILL.md行为层 | 编码规范·禁止事项 | 低（兜底） |
| 敏感信息防护 | 写入前正则扫描 | — |
| 审计日志 | JSONL + trace_id | — |

</td>
<td width="33%" valign="top">

### 🛡️ Stabilize · 稳定性加固

**故障可恢复**：每个步骤都有检查点，崩溃后确定性恢复

| 机制 | 关键设计 |
|------|---------|
| 检查点协议 | 3类检查点 + hash校验 |
| 三级熔断 | Agent→任务→项目 |
| 幂等性规范 | 0匹配=跳过 + pre_check |

> orchestrator 最严格（1次/15min熔断），只读Agent检查点少

</td>
<td width="33%" valign="top">

### 📊 Observe · 可观测性加固

**操作可追溯**：每个操作都有结构化记录

| 机制 | 关键设计 |
|------|---------|
| HEARTBEAT v2 | YAML + Markdown 双格式 |
| 指标收集 | C/G/H 三类指标 |
| 分布式追踪 | trace_id 贯穿全链路 |
| 自动监控 | 5条告警规则 |

</td>
</tr>
</table>

## 高解耦设计

### 能力驱动，而非流程驱动

> v3 核心变革：**每个 Skill 可独立运行**，编排是可选的组合层，不是强制的流程链。

| 使用方式 | 适用场景 | 示例 |
|------|---------|------|
| **单Skill** | 改Bug、调研、写文档 | "帮我改个Bug" → pm-coder |
| **预定义编排** | 需求分析、PRD | "梳理需求+拆解" → analysis-only |
| **全链路编排** | 完整项目开发 | "从0做个App" → full-pipeline |
| **自定义编排** | 灵活组合 | 自定义 YAML 编排模板 |

### 上下文自适应（三级降级）

| 等级 | 条件 | 行为 |
|------|------|------|
| **FULL** | 所有前置文档齐全 | 严格对齐，按流程验收 |
| **PARTIAL** | 部分文档存在 | 对齐已有，缺失从用户推导 |
| **MINIMAL** | 无前置文档 | 直接接收用户指令，轻量运行 |

### 平台抽象层

行为规范层（SKILL.md、pm-core/、orchestrations/）**不绑定任何特定AI平台**：

| 路径变量 | 说明 | 映射示例 |
|---------|------|---------|
| `{context_root}` | 项目上下文根目录 | `.workbuddy/`、`.cursor/`、`.cline/` |
| `{skills_root}` | Skills 安装目录 | `~/.workbuddy/skills/`、项目级 skills/ |

> 详见 [`pm-core/platform-adapter.md`](./pm-core/platform-adapter.md)

## 架构概览（全链路模式）

```
┌──────────────────────────────────────────────────────────────┐
│                   orchestrator 职责分层                        │
│                                                               │
│  【核心】上下文同步 · 结果收集 · 监听                          │
│  【全局】阶段切换 · 打回路由 · 用户交互 · 复盘                 │
│  【不做】需求/拆解/Skills/调度/编码/文档                       │
└──────────────────────────────┬───────────────────────────────┘
                               │
   ┌───────────────────────────┼──────────────────────────┐
   ▼                           ▼                          ▼
┌────────────┐          ┌────────────┐          ┌────────────┐
│  Phase 0   │          │  Phase 1   │          │  Phase 2   │
│  需求池管理 │────────→ │  分析→拆解  │────────→ │  原型设计   │
│  +MVP定义  │          │            │          │  （并行）   │
│  backlog   │        
````
