YouTrack
Você gerencia issues no YouTrack do usuário via MCP oficial (servidor youtrack).
Pré-requisito e degradação
Path A — MCP youtrack conectado: use as tools diretamente.
Path B — MCP ausente/failed: não simule. Aponte /pwdev-youtrack:init e,
se YOUTRACK_BASE_URL/token existirem (check-setup.sh), ofereça o fallback
REST via ${CLAUDE_PLUGIN_ROOT}/scripts/yt-api.sh para operações pontuais.
Lembre: env var nova só vale após reiniciar a sessão.
Mapa de intenção → tool
| Intenção |
Tool |
| Buscar issues |
search_issues (query language abaixo) |
| Detalhar issue |
get_issue (ID legível PROJ-123) |
| Criar issue |
get_issue_fields_schema ANTES → create_issue (ou create_draft_issue para revisão) |
| Atualizar campos/estado |
update_issue · responsável: change_issue_assignee |
| Comentar / ler comentários |
add_issue_comment / get_issue_comments |
| Tags |
manage_issue_tags |
| Vincular issues |
link_issues |
| Registrar horas |
log_work (formato 1h 30m) |
| Artigos |
search_articles / get_article / create_article / update_article |
| Projetos e pessoas |
find_projects · get_project · find_user · get_current_user |
Detalhes e pegadinhas: ${CLAUDE_PLUGIN_ROOT}/references/mcp-tools.md.
Query language — essencial
assignee: me #Unresolved · project: ODARA type: Bug priority: Critical ·
State: {In Progress} · created: {This week} · has: -{Assignee} ·
sort by: {updated} desc. Cheat sheet completo:
${CLAUDE_PLUGIN_ROOT}/references/query-language.md.
Fluxos recomendados
- Criar issue: schema do projeto → montar proposta (summary, description,
campos) → mostrar ao usuário → criar só após confirmação.
- Triagem:
assignee: me #Unresolved sort by: {updated} desc → resumir por
prioridade/estado → propor ações, executar as confirmadas.
- Log de trabalho: confirmar issue, duração e data antes de
log_work —
registro de tempo errado suja relatório de faturamento.
Regras
- Mutação só com confirmação — create, update, delete, log_work: mostre o
que vai fazer antes de fazer.
- Nunca invente custom field ou valor de enum — consulte
get_issue_fields_schema na dúvida.
- Comunique-se por IDs legíveis (
PROJ-123), nunca IDs internos.
- Leia
.claude/pwdev-youtrack-context.md (projeto/board padrão) antes de
perguntar o que já está registrado.
- Conteúdo escrito no YouTrack segue o idioma do projeto do usuário.
Limites
- Não gerencia boards, sprints, anexos nem operações em lote — ver
youtrack-rest
- Não monta relatórios agregados — ver
/pwdev-youtrack:report
- Não altera permissões nem configuração administrativa da instância
Skills relacionadas
youtrack-rest — boards, sprints, relatórios de tempo, anexos, bulk
1---2name: youtrack3description: >4 Issues, busca, comentários, tags, artigos e registro de trabalho no YouTrack5 Cloud via MCP oficial. Use quando o usuário disser "YouTrack", "criar issue",6 "minhas issues", "buscar tarefas", "comentar na issue", "atribuir para",7 "mudar o estado", "registrar horas", "artigo da knowledge base", ou citar um8 ID tipo PROJ-123. Boards e sprints são da skill youtrack-rest.9metadata:10 source: https://skillmd.com/skills/pwdev-solucoes/youtrack11 version: 1.0.012---1314# YouTrack1516Você gerencia issues no YouTrack do usuário via MCP oficial (servidor `youtrack`).1718## Pré-requisito e degradação1920**Path A — MCP `youtrack` conectado**: use as tools diretamente.2122**Path B — MCP ausente/failed**: não simule. Aponte `/pwdev-youtrack:init` e,23se `YOUTRACK_BASE_URL`/token existirem (`check-setup.sh`), ofereça o fallback24REST via `${CLAUDE_PLUGIN_ROOT}/scripts/yt-api.sh` para operações pontuais.25Lembre: env var nova só vale após reiniciar a sessão.2627## Mapa de intenção → tool2829| Intenção | Tool |30|---|---|31| Buscar issues | `search_issues` (query language abaixo) |32| Detalhar issue | `get_issue` (ID legível `PROJ-123`) |33| Criar issue | `get_issue_fields_schema` **ANTES** → `create_issue` (ou `create_draft_issue` para revisão) |34| Atualizar campos/estado | `update_issue` · responsável: `change_issue_assignee` |35| Comentar / ler comentários | `add_issue_comment` / `get_issue_comments` |36| Tags | `manage_issue_tags` |37| Vincular issues | `link_issues` |38| Registrar horas | `log_work` (formato `1h 30m`) |39| Artigos | `search_articles` / `get_article` / `create_article` / `update_article` |40| Projetos e pessoas | `find_projects` · `get_project` · `find_user` · `get_current_user` |4142Detalhes e pegadinhas: `${CLAUDE_PLUGIN_ROOT}/references/mcp-tools.md`.4344## Query language — essencial4546`assignee: me #Unresolved` · `project: ODARA type: Bug priority: Critical` ·47`State: {In Progress}` · `created: {This week}` · `has: -{Assignee}` ·48`sort by: {updated} desc`. Cheat sheet completo:49`${CLAUDE_PLUGIN_ROOT}/references/query-language.md`.5051## Fluxos recomendados5253- **Criar issue**: schema do projeto → montar proposta (summary, description,54 campos) → mostrar ao usuário → criar só após confirmação.55- **Triagem**: `assignee: me #Unresolved sort by: {updated} desc` → resumir por56 prioridade/estado → propor ações, executar as confirmadas.57- **Log de trabalho**: confirmar issue, duração e data antes de `log_work` —58 registro de tempo errado suja relatório de faturamento.5960## Regras6162- **Mutação só com confirmação** — create, update, delete, log_work: mostre o63 que vai fazer antes de fazer.64- **Nunca invente custom field ou valor de enum** — consulte65 `get_issue_fields_schema` na dúvida.66- Comunique-se por IDs legíveis (`PROJ-123`), nunca IDs internos.67- Leia `.claude/pwdev-youtrack-context.md` (projeto/board padrão) antes de68 perguntar o que já está registrado.69- Conteúdo escrito no YouTrack segue o idioma do projeto do usuário.7071## Limites7273- Não gerencia boards, sprints, anexos nem operações em lote — ver `youtrack-rest`74- Não monta relatórios agregados — ver `/pwdev-youtrack:report`75- Não altera permissões nem configuração administrativa da instância7677## Skills relacionadas7879`youtrack-rest` — boards, sprints, relatórios de tempo, anexos, bulk