К основному содержанию
команда CX Codex

run-survey — команда для Claude Code: что делает и как установить

Команда run-survey запускает клиентские опросы с расчётом выборки, набором вопросов и шагами автоматизации. Пригодится продуктовым командам и исследователям.

Apache-2.0 ★ 450 обновлён 2026-04-03

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/run-survey.md
Открыть на GitHub

Что делает run-survey

Команда координирует запуск исследований по целевым сегментам: собирает бриф, готовит пул вопросов с ветвлением и логикой, формирует списки рассылки и следит за динамикой ответов. Вся структура процесса сохраняется в .claude/plans/plan-<timestamp>.json для аудита, включая граф зависимостей и метрики качества.

В пайплайне задействованы субагенты research-lead, cs-analyst и скиллы survey-design и stakeholder-ops. При сбоях QA или рассылки лимит повторов по умолчанию равен двум, после чего срабатывает эскалация к стейкхолдерам. Для подготовки выгрузки команда передаёт очищенные данные в связку с командой synthesize-feedback.

Какие задачи решает

  • спланировать клиентский опрос под конкретную персону и цель
  • сформировать банк вопросов с логикой шкал и ветвлениями
  • подготовить чеклист дистрибуции для рассылок по email и in-app
  • зафиксировать схему запуска и аудит исследования в JSON-файле

Примеры запросов агенту

  • /customer-feedback-orchestration:run-survey --audience "admins" --goal adoption --channels "email,in-app" --deadline 2025-12-15
  • /customer-feedback-orchestration:run-survey --audience "champions" --goal satisfaction --channels "community" --sample_size 150
  • /customer-feedback-orchestration:run-survey --audience "exec sponsors" --goal "roadmap validation" --channels "CS-led" --deadline 2026-01-30

Как установить run-survey

Вручную: положить файлы

.claude/commands/run-survey.md

Вызов — /run-survey. Для всех проектов — ~/.claude/commands/

Вопросы о run-survey

Как установить run-survey в Claude Code?

Сохраните файл команды по пути .claude/commands/run-survey.md.

Что делает команда run-survey?

Она проводит опрос через последовательность шагов: сбор брифа, проектирование вопросов, подготовка выборки, контроль ответов и передача результатов на синтез.

Какие входные параметры принимает команда?

Обязательно задаются аудитория, цель, каналы дистрибуции и дедлайн, а также опционально размер выборки sample_size и бюджет на поощрение incentive.

Исходный текст

run-survey.md · Apache-2.0
---
name: run-survey
description: Launches customer surveys with sampling plans, question sets, and automation hooks.
usage: /customer-feedback-orchestration:run-survey --audience "admins" --goal adoption --channels "email,in-app" --deadline 2025-12-15
---

# Command: run-survey

## Inputs
- **audience** – persona or segment target (admins, champions, exec sponsors).
- **goal** – objective (adoption, roadmap validation, satisfaction, messaging test).
- **channels** – comma-separated distribution methods (email, in-app, community, CS-led).
- **deadline** – fielding end date or fixed duration.
- **incentive** – optional reward description or budget.
- **sample_size** – desired number of responses (numeric).

### GTM Agents Pattern & Plan Checklist
> Mirrors GTM Agents orchestrator blueprint @puerto/plugins/orchestrator/README.md#112-325.

- **Pattern selection**: Survey orchestration typically runs **pipeline** (brief → question design → sampling → monitoring → handoff). If question design + sampling prep run in parallel, note a **diamond** block with merge gate in the plan header.
- **Plan schema**: Save `.claude/plans/plan-<timestamp>.json` capturing audience, goals, sampling logic, dependency graph (legal, CS, research ops), error handling, and success metrics (response rate, completion %, demographic balance).
- **Tool hooks**: Reference `docs/gtm-essentials.md` stack—Serena for MAP automation diffs, Context7 for research SOPs + historic surveys, Sequential Thinking for pre/post-readouts, Playwright for survey QA.
- **Guardrails**: Default retry limit = 2 for distribution/QA failures; escalation ladder = Research Lead → Customer Marketing → Exec sponsor.
- **Review**: Run `docs/usage-guide.md#orchestration-best-practices-puerto-parity` before launch to confirm dependencies, approvals, deliverables.

## Workflow
1. **Brief Assembly** – capture goals, personas, hypotheses, and stakeholder approvals.
2. **Question Design** – generate question bank with logic, scales, and branching recommendations.
3. **Sampling & Distribution** – build target lists, dedupe suppression lists, schedule sends.
4. **Monitoring** – track response rates, data quality, and audience balance; trigger boosts if needed.
5. **Handoff** – package clean dataset + metadata for `synthesize-feedback` command.

## Outputs
- Survey plan (audience, sample, channels, incentive, timeline).
- Question set with logic map and translation/localization notes.
- Distribution checklist + automation steps for MAP/CS tooling.
- Plan JSON entry stored/updated in `.claude/plans` for audit trail.

## Agent/Skill Invocations
- `research-lead` – validates methodology and question quality.
- `cs-analyst` – ensures sampling + data integrity.
- `survey-design` skill – provides templates and guardrails.
- `stakeholder-ops` skill – outlines approvals + comms.

## GTM Agents Safeguards
- **Fallback agents**: document substitutes (e.g., CS Analyst covering Research Lead) when leads unavailable.
- **Escalation triggers**: if response rate misses guardrail twice or sampling bias detected, escalate via GTM Agents rip-cord and log corrective actions in plan JSON.
- **Plan maintenance**: update plan JSON/change log when audiences, question sets, or tooling stacks change to preserve audit parity.

---

© gtmagents · Apache-2.0 · gtmagents/gtm-agents

Похожие слэш-команды

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →
posthog-survey-creator PostHog Скилл posthog-survey-creator помогает спроектировать опрос в PostHog: подобрать шаблон или составить вопросы, выбрать аудиторию и настроить расписание. Создаёт опрос как черновик. CX Codex +1 225установок voice simota Скилл voice для Claude Code: собирает NPS, CSAT, CES, классифицирует отзывы и выдаёт отчёты с выводами. Замыкает цикл фидбэка. CX Codex +1 736установок zoho-survey membrane Скилл для работы с Zoho Survey прямо из IDE. Создавайте опросы, собирайте ответы и анализируйте результаты через CLI Membrane — без ручного управления ключами. CX Codex +1 202установок creating-surveys PostHog Скилл creating-surveys для Claude Code создаёт опросы и формы в PostHog через MCP. Он подключается, когда агенту поручают подготовить опрос или вызвать survey-create. CX Codex +1 127установок survey-design Owl-Listener Скилл survey-design для Claude Code: помогает составлять нейтральные анкеты, подбирать шкалы оценок и рассчитывать выборку. Измеряет мнения пользователей в цифрах. CX Codex +1 2 100установок k2f-survey-form suzheng Скилл k2f-survey-form проектирует структуру и визуальное оформление опросов и анкет в разметке K2F без лишних вопросов и выдуманных юридических дисклеймеров. CX Codex +1 574установок

Из того же набора224

Весь набор →
measure-engagement Команда measure-engagement для Claude Code собирает метрики здоровья комьюнити, тональность обсуждений и результаты экспериментов в отчёт с планом действий. Помогает оценить состояние сообщества и определить дальнейшие действия. CX Codex +1 ★ 450звёзд репо prioritize-gaps Команда prioritize-gaps оценивает проблемные точки клиентского пути, закрепляет ответственных и формирует дорожную карту устранения разрывов. Помогает при разборе онбординга или удержания. CX Codex +1 ★ 450звёзд репо map-journey Команда map-journey для Claude Code, которая проводит воркшоп по картированию пути клиента: от сбора данных до плана с владельцами задач. Запускается с параметрами персоны, среза пути и горизонта анализа. CX Codex +1 ★ 450звёзд репо plan-community-calendar Команда plan-community-calendar строит календарь событий сообщества с темами, форматами и владельцами на 8 недель или квартал. CX Codex +1 ★ 450звёзд репо configure-rules Команда configure-rules в Claude Code проверяет данные, собирает логику, сопоставляет варианты, проводит QA и развёртывает правила персонализации для web- и in-app-каналов. CX Codex +1 ★ 450звёзд репо forecast-renewals Команда forecast-renewals для построения сегментированных прогнозов возобновления контрактов с оценкой здоровья счётов, анализом отклонений и готовыми отчётами для руководства. Собирает данные по ARR, NRR и рискам в одну картину. CX Codex +1 ★ 450звёзд репо experiment-design-kit Скилл experiment-design-kit помогает превращать продуктовые идеи в проверяемые гипотезы с метриками, каталогом вариантов и защитными лимитами. CX Codex +1 ★ 450звёзд репо run-community-event Команда run-community-event готовит сценарий community-события или прямого эфира, план модерации и задачи после встречи. Задайте формат, ведущих, дату и цели. CX Codex +1 ★ 450звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой