compose-email — команда для Claude Code: структурированное письмо за минуту
Команда compose-email для составления профессиональных писем по методу What-Why-How. Задаёшь контекст — получаешь готовый черновик с правильной структурой, тоном и call-to-action.
MIT ★ 2 707 обновлён 2026-03-05
.claude/commands/compose-email.mdЧто делает compose-email
Команда применяет проверенный фреймворк: WHAT (суть письма в первом предложении), WHY (почему это важно адресату), HOW (конкретное действие). На основе этого строит тело письма с учётом аудитории — техническому коллеге пишет иначе, чем руководству.
Процесс начинается с вопросов: кому ты пишешь (коллега, PM, лидер), зачем (статус, запрос ресурсов, эскалация), насколько срочно. Потом генерирует тему, которая сканируется глазом, и структурированное тело с маркерами, жирным шрифтом и понятным следующим шагом. После черновика предлагает варианты: сделать тональность жёстче или мягче, развернуть или сократить, подогнать под Slack или Teams.
Установка — добавить файл в директорию команд своего редактора кода. Работает в Claude Code; интеграции для Codex, GitHub Copilot и Gemini CLI лежат в соответствующих папках проекта.
Какие задачи решает
- написать письмо, которое не потеряется в спаме и начальстве
- структурировать сложный запрос без бла-бла в начале
- подобрать тон под аудиторию — от коллег до executives
- сделать subject line, который читатель поймёт с первого взгляда
- быстро набросать черновик и доработать его за две итерации
Примеры запросов агенту
- Нужна помощь в письме менеджеру о переносе дедлайна для API миграции
- Сверстай письмо статус-репорт про завершение спринта для техлида
- Помоги написать письмо стейкхолдерам о проблеме в production и плане её решить
Как установить compose-email
Вручную: положить файлы
.claude/commands/compose-email.mdВызов — /compose-email. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/compose-email.mdВызов — /prompts:compose-email. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/compose-email.prompt.mdВручную: положить файлы
.gemini/commands/compose-email.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о compose-email
Как установить compose-email в Claude Code?
Скопируй файл .claude/commands/compose-email.md из репозитория в папку .claude/commands/ своего проекта. Затем вызови команду /compose-email с контекстом или без него, если хочешь ответить на вопросы агента.
Что делает compose-email?
Генерирует профессиональное письмо на основе What-Why-How фреймворка. Задаёт уточняющие вопросы об адресате и цели письма, затем создаёт черновик с темой, структурированным телом и call-to-action, подогнанные под тон аудитории.
Какие аудитории поддерживает команда?
Четыре типа: технические коллеги (с жаргоном), нетехнические стейкхолдеры (простой язык), кросс-функциональные команды (баланс) и менеджмент (фокус на результатах). Тон и уровень деталей подстраиваются под каждый тип.
Исходный текст
compose-email.md · MIT
---
description: Draft a professional email using the What-Why-How framework. Use when you need to compose emails to colleagues, stakeholders, or leadership.
argument-hint: [context or paste existing draft]
allowed-tools: Read, AskUserQuestion
---
# Draft Professional Email
Generate a professional, well-structured email using communication best practices for software developers.
## Arguments
`$ARGUMENTS` - Optional context, topic, or existing draft to refine
## Workflow
### Step 1: Gather Context
If `$ARGUMENTS` is empty or insufficient, use AskUserQuestion to gather:
**Question 1: Recipient Type** (header: "Audience")
- Technical peer (developer, engineer)
- Non-technical stakeholder (PM, executive, customer)
- Cross-functional team (mixed audience)
- Manager or leadership
**Question 2: Email Purpose** (header: "Purpose")
- Status update or progress report
- Request (review, approval, resources)
- Information sharing (FYI, announcement)
- Escalation or raising concern
- Following up on prior conversation
**Question 3: Urgency** (header: "Urgency")
- Urgent - needs response today
- Standard - within 1-2 days
- Low priority - for awareness only
### Step 2: Apply Communication Framework
Use the **What-Why-How** structure:
1. **WHAT** (Opening - 1-2 sentences)
- Lead with the key message or request
- State the purpose immediately
- No throat-clearing ("I hope this email finds you well...")
2. **WHY** (Context - 2-3 sentences)
- Provide necessary background
- Explain relevance to the recipient
- Include only essential context
3. **HOW** (Action - clear next steps)
- Specific call-to-action
- Clear deadline if applicable
- Who needs to do what
### Step 3: Apply Email Best Practices
**Subject Line:**
- Specific and scannable (5-8 words ideal)
- Include action needed: "[Action Required]", "[FYI]", "[Decision Needed]"
- Include deadline if urgent: "[Due Friday]"
**Body Structure:**
- Bullets for multiple points (3-5 max)
- Bold key information
- One topic per email
- Short paragraphs (2-3 sentences max)
**Tone Calibration by Audience:**
| Audience | Tone | Jargon Level |
| --- | --- | --- |
| Technical peer | Direct, precise | High (use technical terms) |
| Non-technical | Business-focused | Low (translate jargon) |
| Cross-functional | Balanced | Medium (explain as needed) |
| Leadership | Concise, impact-focused | Low (focus on outcomes) |
### Step 4: Generate Draft
Produce a complete email with:
```markdown
## Email Draft
**Subject:** [Clear, specific subject line]
---
[Opening - WHAT: Key message/request]
[Context - WHY: Background and relevance]
[Body - Details as needed, use bullets for lists]
[Closing - HOW: Clear call-to-action]
[Sign-off]
```
### Step 5: Offer Refinements
After presenting the draft, offer:
1. **Tone adjustment** - Make more/less formal
2. **Length adjustment** - Expand or condense
3. **Jargon translation** - Adjust technical language level
4. **Format change** - Different structure for different medium (Slack, Teams)
## Example Usage
```bash
# With context
/soft-skills:draft-email Need to ask team lead for deadline extension on API migration
# Refine existing draft
/soft-skills:draft-email "Hi team, wanted to let you know about the deployment..."
# Start fresh
/soft-skills:draft-email
```
## Output
Present the draft in a clear format showing:
1. **Subject line** with rationale
2. **Email body** with WHAT/WHY/HOW sections labeled
3. **Refinement options** for iteration
## Anti-Patterns to Avoid
- Generic subjects ("Quick question", "Update", "FYI")
- Burying the request at the end
- Wall of text without structure
- Missing clear call-to-action
- Over-apologizing or excessive hedging
- CC'ing unnecessarily
© softaworks · MIT · softaworks/agent-toolkit