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

backlog-notation — скилл для Claude Code: установка

Скилл для Claude Code подсказывает синтаксис Backlog notation для задач, комментариев, wiki и pull request. Помогает преобразовать Markdown и подготовить текст для этих материалов.

MIT 333 установок ★ 102 обновлён 2026-10-18

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add nulab/bee --skill backlog-notation -a claude-code
Открыть на GitHub

Что делает backlog-notation

Скилл подсказывает синтаксис Backlog notation для заголовков, выделения текста, списков, чек-листов, таблиц, ссылок, цветов и блоков кода. Он также помогает преобразовать Markdown и подготовить текст для описания задачи, комментария, wiki-страницы или pull request.

В справочнике есть правила таблиц, объединения ячеек, экранирования и поддерживаемых языков для блоков кода. Чек-листы работают только в описаниях задач. Если не проверить правило проекта, разметка отобразится как обычные символы, потому что Backlog не преобразует Markdown и Backlog notation автоматически.

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

  • оформить описание задачи в Backlog notation
  • преобразовать Markdown в разметку Backlog
  • составить таблицу с заголовком и объединёнными ячейками
  • добавить чек-лист в описание задачи
  • вставить ссылку или блок кода в Backlog

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

  • Проверь правило форматирования проекта и подготовь описание задачи в Backlog notation.
  • Преобразуй этот Markdown-текст в Backlog notation для комментария в Backlog.
  • Составь таблицу и блок кода для wiki-страницы Backlog, используя правильный синтаксис.

Как установить backlog-notation

1Через Skills CLI (Vercel)

npx skills add nulab/bee --skill backlog-notation -a claude-code

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

~/.claude/skills/backlog-notation/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/backlog-notation/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о backlog-notation

Как установить backlog-notation в Claude Code?

Выполните npx skills add nulab/bee --skill backlog-notation -a claude-code. Скилл будет доступен по пути ~/.claude/skills/backlog-notation/SKILL.md.

Что делает backlog-notation?

Он объясняет синтаксис Backlog notation и помогает писать или преобразовывать форматированный текст для Backlog: описания задач, комментарии, wiki и pull request.

Работают ли чек-листы в комментариях и wiki?

Нет. По правилам этого синтаксиса чек-листы поддерживаются только в описаниях задач.

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

SKILL.md · MIT
---
name: backlog-notation
description: Syntax reference for Backlog notation (Backlog記法), one of the two per-project text formatting rules on Nulab Backlog — the other, and the default for new projects, is Markdown. Use when posting or editing formatted text on Backlog — issue descriptions (課題の説明), comments (コメント), wiki pages, pull requests — via the bee CLI or Backlog API; when converting Markdown to Backlog notation (Markdown から Backlog記法への変換); when asked how to write headings, bold, tables (表), checklists, colored text, links, or code blocks in Backlog記法; or when the project's rule is unknown (this skill shows how to check textFormattingRule first — text posted in the wrong rule renders as literal characters). Do not use for projects confirmed to use Markdown, for Markdown files outside Backlog, or for Backlog operations with no text to format (status changes, assignees, listing data).
---

# backlog-notation

Backlog notation (Backlog記法) syntax reference.

## When this applies

Every Backlog project is set to one text formatting rule: **Markdown** (the default for new projects) or **Backlog notation**. This reference covers Backlog notation only. It is not a Backlog-wide standard, and it does not apply to Markdown projects — in those, write plain Markdown and ignore everything below.

Backlog renders text strictly by the project's rule: Backlog notation posted to a Markdown project (or vice versa) is not converted — it shows up as literal characters like `''bold''` or `**bold**`. Determine the rule like this:

1. **The user or project instructions (AGENTS.md, CLAUDE.md) already state the rule** — the usual case. Follow what is stated; do not spend an API call re-verifying it.
2. **The rule is not stated anywhere** — check it once before posting:

   ```sh
   bee project view -p PROJECT_KEY --json textFormattingRule
   # {"textFormattingRule":"backlog"}   -> use this reference
   # {"textFormattingRule":"markdown"}  -> use Markdown instead
   ```

   If you cannot run bee (e.g. this skill is installed without it), fetch `/api/v2/projects/PROJECT_KEY` from the Backlog API and read `textFormattingRule`, or ask the user.

Backlog notation is **not Markdown** — never mix the two syntaxes in one text.

## Quick Reference

| Feature            | Syntax                                                |
| ------------------ | ----------------------------------------------------- |
| Heading            | `* H1` / `** H2` / `*** H3` / `**** H4`               |
| Bold               | `''text''`                                            |
| Italic             | `'''text'''`                                          |
| Strikethrough      | `%%text%%`                                            |
| Color              | `&color(red) { text }`                                |
| Color + background | `&color(#fff, #333) { text }`                         |
| Bullet list        | `- item` (nest with `--`)                             |
| Numbered list      | `+ item` (nest with `++`)                             |
| Checklist          | `- [ ] todo` / `- [x] done` (issue descriptions only) |
| Link               | `[[https://example.com]]`                             |
| Labeled link       | `[[label>https://example.com]]`                       |
| Issue link         | `PROJECT-123` (auto-linked)                           |
| Quote              | `> text` or `{quote}...{/quote}`                      |
| Code block         | `{code}...{/code}`                                    |
| Code (lang)        | `{code:java}...{/code}`                               |
| Image              | `#image(URL or filename)`                             |
| Thumbnail          | `#thumbnail(URL or filename)` (< 200KB)               |
| Table of contents  | `#contents`                                           |
| Line break         | `&br;`                                                |
| Escape             | `\` before special characters                         |

## Tables

Separate cells with `|`. End a row with `h` for a header row. Prefix a cell with `~` for a row header. Use `>` to merge a cell with the one to its left.

```
|Name|Value|Note|h
|~Header|data 1|data 2|
|Span two||>|
```

## Markdown → Backlog Notation Conversion

| Markdown            | Backlog Notation       |
| ------------------- | ---------------------- |
| `# H1`              | `* H1`                 |
| `**bold**`          | `''bold''`             |
| `*italic*`          | `'''italic'''`         |
| `~~strike~~`        | `%%strike%%`           |
| `1. item`           | `+ item`               |
| ` ``` `             | `{code}` / `{/code}`   |
| `[text](url)`       | `[[text>url]]`         |
| `![alt](url)`       | `#image(url)`          |
| `\|---\|` separator | `\|h` at end of row    |
| N/A                 | `&color(red) { text }` |

## Complete Example

A realistic issue description combining the elements above:

```
* 障害報告: 画像アップロードが失敗する

** 概要
''2026-08-21 14:00'' 頃から、5MB 以上のファイルで失敗する。%%当初はネットワーク起因と推測%% → サーバ側の設定と判明。

** 再現手順
+ 課題画面を開く
+ 5MB 以上の画像を添付する
+ &color(red) { エラー「upload failed」が表示される }

** 環境
|項目|値|h
|~ブラウザ|Chrome 128|
|~プラン|スタンダード|

** 対応
- [x] 原因調査
- [ ] nginx の client_max_body_size を修正
- [ ] BUG-101 の再発防止策に反映

{code:shell}
curl -F "[email protected]" https://xxx.backlog.com/api/v2/...
{/code}

詳細は [[運用wiki>https://xxx.backlog.com/wiki/PROJ/ops]] を参照。
```

## Gotchas

- No inline code syntax — only block-level `{code}...{/code}`
- `{quote}` blocks cannot be nested
- Checklists work only in issue descriptions, not in comments or wikis
- Supported code languages: `java`, `cs`, `js`, `python`, `ruby`, `perl`, `php`, `sql`, `html`, `xml`, `css`, `shell`, etc.

© nulab · MIT · nulab/bee

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
spec-to-backlog atlassian Скилл spec-to-backlog для Claude Code и Codex превращает спецификацию в Confluence в эпик и связанные задачи Jira. Разбивает требования на задачи и создаёт их в проекте. CX Codex +1 379установок team-backlog sametcelikbicak Скилл team-backlog для Claude Code разбивает PRD на вертикальные тикеты с критериями приёмки и зависимостями. После согласования он записывает их в .team/03-backlog.md. CX Codex +1 ★ 71звёзд репо om-backlog open-mercato Скилл om-backlog превращает продуктовый бриф или спецификацию в дерево задач трекера: эпики, истории с критериями приёмки, подзадачи. Показывает дерево и ждёт подтверждения. CX Codex +1 2 300установок backlog-grooming-assistant Jeremy Longshore Скилл backlog-grooming-assistant помогает структурировать бэклог, готовит конфигурации задач и даёт пошаговые инструкции для груминга в enterprise-проектах. CX Codex +1 1установок backlog-capture mvschwarz Скилл backlog-capture для Claude Code и ещё пяти агентных сред, который превращает сырые заметки в структурированные записи бэклога. Запускается после встреч и звонков, когда нужно быстро зафиксировать идею, не дать ей потеряться. CX Codex +1 ★ 8 928звёзд репо backlog nschurmann Скилл backlog для Claude Code превращает описание идеи или функции в список коротких пользовательских историй. Он разбивает задачу на вертикальные части, готовые к разработке. CX Codex +1 ★ 265звёзд репо

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

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

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