Cursor Dev Journal · Журнал разработки и публикация на huskynet

Локальный контур Cursor: правила документации во всех проектах, публикация в чат и записи WordPress на huskynet.ru, журнал по воркспейсам.

Работает на вашей машине (~/.cursor/), не внутри отдельного git-репозитория приложения.

Возможности

• Четыре файла документации в каждом осмысленном проекте: README.md, doc/ARCHITECTURE.md, doc/CHANGELOG.md, doc/AI_RULES.md
• Запрет лишних markdown (NOTES.md, TODO.md, PLAN.md и т.п.), пока вы явно не попросили
• Публикация в общий чат Cursor Dev Log по хештегу #husky_chat (можно указать другой чат URL /dialog/SLUG)
• Публикация README.md как записи WordPress: #husky_post / #husky_post_edit
• Привязка уже существующего поста по URL (#husky_post_edit https://huskynet.ru/4109/)
• Скриншоты из вложений чата Cursor — без слов «со скрином» в хештеге
• Локальный индекс dev-journal.html (проекты, даты, действия, ссылки)
• Команда /log — открыть индекс в Cursor

Требования

• Cursor с User Rules и personal skills
• Python 3 (python или py -3)
• WordPress на https://huskynet.ru с Application Password
• Тема чата с REST my-chat/v1 (сообщения) и стандартный REST /wp/v2/posts, /wp/v2/media

Установка

1. Skill уже лежит в C:\Users\huskynet\.cursor\skills\dev-journal\.
2. Скопируйте C:\Users\huskynet\.cursor\dev-journal.local.json.example → dev-journal.local.json.
3. Заполните username и application_password (Users → Profile → Application Passwords). Не коммитьте этот файл.
4. User Rule «Документация и запрет мусора» должен быть включён в Customize → Rules.

Первый #husky_chat без slug создаёт чат Cursor Dev Log и записывает chat_slug.

Использование

Обновить документацию проекта

В воркспейсе проекта попросите привести README и doc/* к коду. README — полный (возможности, требования, установка, сценарии, дерево, стек), образец полноты: OBD Assist. Тексты только про этот репозиторий. Не писать «канон OmniDrive» — OmniDrive лишь эталон структуры четырёх файлов.

Запись в журнал-чат

Вставьте скрины в чат Cursor при необходимости, затем:

#husky_chat

Другой чат:

#husky_chat https://huskynet.ru/dialog/SLUG

README → пост WordPress

Новый пост:

#husky_post

Обновить уже привязанный:

#husky_post_edit

Старый пост, созданный до этой схемы (первый раз нужна ссылка):

#husky_post_edit https://huskynet.ru/4109/

H1 в README: Название · краткое пояснение (это же заголовок записи на сайте). Из тела поста ведущий H1 снимается, чтобы не дублировать title темы.

Категории и теги на записи — только если явно попросить в том же сообщении (без отдельного хештега), например: «добавь категорию Android и тег Cursor #husky_post_edit». Уже стоящие термины сами не сбрасываются. «Переименуй категорию X в Y» — сменить рубрику этой записи; если Y уже есть, берётся она, дубль не создаётся. Имя категории во всём WordPress не меняется.

На сайте из README вырезается раздел «Документация» (относительные ссылки на doc/ не работают). Внизу поста — раскрывающийся блок «История изменений» из doc/CHANGELOG.md.

Шапка сообщения в чате: жирное имя проекта, затем #РодительскийКаталог и тег действия (#Feature #Fix #Docs #Info #Release #Refactor), пустая строка, затем текст. Дату не пишем — она уже у сообщения. Дополнительные теги в шапку — обычной фразой («добавь теги Foo Bar») вместе с #husky_chat.

Посмотреть, какие проекты уже заведены

В чате Cursor: /log
или файл: C:\Users\huskynet\.cursor\dev-journal.html

Скриншоты

Win+Shift+S → Ctrl+V в поле агента, либо перетащить файл. Несколько файлов — несколько вложений. В хештеге про картинки писать не нужно. Для записи WP все картинки идут в начало текста, первая ещё и обложка.

Структура проекта

~/.cursor/skills/dev-journal/
├── SKILL.md                 # когда агент публикует (хештеги)
├── HOWTO.md                 # краткая шпаргалка
├── reference.md             # endpoints API
├── README.md                # этот файл
├── doc/
│   ├── ARCHITECTURE.md
│   ├── CHANGELOG.md
│   └── AI_RULES.md
├── templates/
│   └── chat-header.html     # шапка сообщения в чате
└── scripts/
    └── publish.py           # чат, посты, лог, README→HTML

Рядом, не в skill:

• ~/.cursor/dev-journal.local.json — креды и маппинг проектов (секреты)
• ~/.cursor/dev-journal-log.jsonl — события
• ~/.cursor/dev-journal.html — индекс
• ~/.cursor/commands/log.md — команда /log
• User Rule в Customize → Rules

Тема чата (списки в пузыре): wp-content/themes/chat-theme5_5_5_5_1/style.css — обычные ul столбиком; flex только у списков диалогов после h2.

Технологии

• Cursor User Rules — короткие правила на каждый промпт
• Cursor Agent Skills — процедура публикации и скрипт
• Cursor Commands — макрос /log только по /
• Python 3 stdlib — HTTP Basic, media, posts, markdown→HTML
• WordPress REST — Application Passwords

Настройка

Конфиг (поля): base_url, username, application_password, chat_title, chat_slug, is_public, projects (заполняет скрипт: post_id, post_url, name по пути воркспейса).

Ключ маппинга — абсолютный путь папки. Перенос проекта сбрасывает привязку, пока снова не укажете URL поста.

Не читайте dev-journal.local.json вслух в чате.

История изменений

Формат — Keep a Changelog.

[Unreleased]

Added

• #husky_post / #husky_post_edit: вложения --image все в начало тела записи; первая ещё и обложка (featured_media)
• Категории и теги WP: --category-add/--remove/--rename, --tag-add/--remove/--rename; без флагов таксономия записи не меняется; --rename только у этой записи, существующий термин переиспользуется
• Чат: дополнительные пилюли --tag-add по явной просьбе в промпте (без отдельного хештега)

Changed

• --category-rename / --tag-rename больше не меняют имя термина во всём WordPress — только набор рубрик/тегов у записи

Fixed

• Загрузка PNG в /wp/v2/media: при HTTP 500 (хостинг) повтор JPEG
• Поиск рубрики по умолчанию: slug unsorted (русская «Не сортировано»), не только uncategorized

[1.0.0] — 2026-08-28

Первый срез рабочей обвязки Cursor → huskynet.

Added

• Четыре файла документации самого skill (этот репозиторий обвязки Cursor)
• README-шаблон полноты по образцу OBD Assist (https://huskynet.ru/4109/): возможности, требования, установка, использование, дерево, стек; changelog в README не дублировать
• #husky_post / #husky_post_edit: вырез раздела «Документация» из README; внизу поста <details> с doc/CHANGELOG.md
• #husky_post_edit + URL записи (?p= или slug, не /dialog/) — привязка старого WP-поста к воркспейсу
• Команда /log (~/.cursor/commands/log.md)
• Локальный журнал dev-journal.html / dev-journal-log.jsonl
• Хештеги #husky_chat, #husky_post, #husky_post_edit вместо свободных фраз
• Конвертация HTML-таблиц в списки при публикации в чат

Changed

• Шапка чата: жирное имя проекта, без даты; хештеги #РодительскийКаталог и #Feature / #Fix / #Docs / #Info / #Release / #Refactor
• README H1: Название · краткое пояснение; заголовок WP-поста из этого H1, дубль H1 в теле снимается
• User Rule: не называть структуру «каноном OmniDrive» в чужих проектах
• Тема чата style.css 2.16: списки в пузыре вертикальные, не двухколоночный flex

Fixed

• Визуал «таблицы» в чате: это был display:flex; justify-content:space-between на всех ul li в .chat-message