# Conduct Market Research

> 基于指定主题执行市场调研，输出结构化市场洞察报告并落盘到 docs/market-insights/，供 product-planning pipeline 调用。

- **Type:** Skill
- **Install:** `agentstack add skill-xinyiai0724-tools-conduct-market-research`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [xinyiai0724](https://agentstack.voostack.com/s/xinyiai0724)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [xinyiai0724](https://github.com/xinyiai0724)
- **Source:** https://github.com/xinyiai0724/tools/tree/main/skills/planning/conduct-market-research

## Install

```sh
agentstack add skill-xinyiai0724-tools-conduct-market-research
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Skill: conduct-market-research

**类型**: 规划期 Skill（planning/ 组）  
**调用时机**: product-planning pipeline 第 2 节点；也可独立触发

---

## 用途

针对规划主题执行市场调研（行业趋势、用户规模、技术方向、竞争格局），生成结构化市场洞察报告，落盘到 `docs/market-insights/`。

---

## 参数

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `topic` | string | ✅ | 调研主题（如"AI 编程助手市场"） |
| `target_version` | string | ❌ | 关联目标版本，写入报告 frontmatter |
| `focus_areas` | string | ❌ | 重点调研方向，逗号分隔（如"用户规模,技术趋势,竞争格局"） |

---

## 执行步骤

### Step 1 — 跳过检查

若 pipeline 传入 `skip_market=true`，输出 `SKIPPED（skip_market=true）` 并立即返回。

### Step 2 — 调研内容生成

基于 `topic` 和 `focus_areas`，梳理以下维度：
1. **市场规模与增长**：TAM/SAM/SOM 估算（标注数据来源与置信度）
2. **主要玩家格局**：市场份额分布与近期动向（引用参考来源）
3. **用户需求趋势**：痛点演化、诉求变化
4. **技术演进方向**：关键技术栈趋势
5. **对产品规划的影响**：2-3 条可落地的洞察

### Step 3 — 落盘

文件路径：`docs/market-insights/market-{YYYY-MM-DD}-{slug}.md`

> 约束：文件名必须与 frontmatter `id` 一致，即 `id: market-{YYYY-MM-DD}-{slug}` 对应 `docs/market-insights/market-{YYYY-MM-DD}-{slug}.md`。

```yaml
---
id: market-{YYYY-MM-DD}-{slug}
type: MARKET-INSIGHT
title: {topic} 市场洞察
summary: {一句话总结，建议 50-100 字}
category: industry-trend
source: {主要公开来源，多个来源用分号分隔为单行字符串}
createdAt: {YYYY-MM-DD}
target-version: {target_version 或 tbd}
status: published
pinned: false
---
```

- `category` 可按实际内容改为 `industry-trend` / `user-voice` / `pricing` / `regulation`
- `source` 必须是字符串，不使用数组，保证前端 adapter 能直接读取
- `createdAt` 与前端 adapter 的主字段一致

同时更新 `docs/market-insights/_index.yml`：

```yaml
schema: market-insight-index/v1
title: 市场洞察索引
entries:
  - id: market-{YYYY-MM-DD}-{slug}
    title: {topic} 市场洞察
    category: {category}
    createdAt: {YYYY-MM-DD}
    pinned: false
```

### Step 4 — 输出摘要

输出落盘路径与 3 条关键结论摘要。

---

## 错误处理

| 场景 | 处理 |
|------|------|
| `topic` 为空 | 停止执行，要求补充调研主题 |
| `docs/market-insights/` 不存在 | 自动创建目录 |
| 同名文件已存在 | 在文件名追加 `-v2` 后缀，避免覆盖 |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [xinyiai0724](https://github.com/xinyiai0724)
- **Source:** [xinyiai0724/tools](https://github.com/xinyiai0724/tools)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-xinyiai0724-tools-conduct-market-research
- Seller: https://agentstack.voostack.com/s/xinyiai0724
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.