view --main record-session-avtomatizirovannoe-dokumentirovanie-rabochego-protsessa.md

record-session — Автоматизированное документирование рабочего процесса

Name: record-session — Автоматизированное документирование рабочего процесса
Author: mindfold-ai/Trellis

record-session – это решение для автоматизированного документирования рабочего процесса, позволяющее эффективно фиксировать прогресс и создавать отчеты о выполненных задачах. Инструмент предназначен для удобной работы с командной строкой и предоставляет возможность быстрого создания сессий, содержащих информацию о внесенных изменениях и выполненных работах. Это незаменимый CLI-инструмент для команд, стремящихся к прозрачности и отслеживаемости.

Работает на основе Python-скриптов и интегрируется с системой контроля версий. С помощью record-session можно легко создавать записи о сессиях, используя параметры, такие как заголовок, список коммитов и краткое описание. Это терминальная утилита упрощает процесс документирования, минимизируя ручной ввод данных и обеспечивая согласованность отчетов.

record-session – это мощный CLI-инструмент для эффективного управления рабочим процессом, предоставляющий удобный интерфейс для создания и архивации задач, а также для документирования выполненных работ. Скрипты автоматически обрабатывают коммиты и метаданные, что позволяет сосредоточиться на основной работе, а не на рутинных операциях. Использование командной строки обеспечивает гибкость и автоматизацию процесса.

$ git log --oneline --stat

⭐ звёзды: 4,345

форки: 221

обновлено: 29 марта 2026 года в 08:10

Проводник файлов

1 файлы

SKILL.md

readonly --- lines

--- name: record-session description: "Records completed work progress to .trellis/workspace/ journal files after human testing and commit. Captures session summaries, commit hashes, and updates developer index files for future session context. Use when a coding session is complete, after the human has committed code, or to persist session knowledge for future AI sessions." --- [!] **Prerequisite**: This command should only be used AFTER the human has tested and committed the code. **Do NOT run `git commit` directly** — the scripts below handle their own commits for `.trellis/` metadata. You only need to read git history (`git log`, `git status`, `git diff`) and run the Python scripts. --- ## Record Work Progress ### Step 1: Get Context & Check Tasks ```bash python3 ./.trellis/scripts/get_context.py --mode record ``` [!] Archive tasks whose work is **actually done** — judge by work status, not the `status` field in task.json: - Code committed? → Archive it (don't wait for PR) - All acceptance criteria met? → Archive it - Don't skip archiving just because `status` still says `planning` or `in_progress` ```bash python3 ./.trellis/scripts/task.py archive <task-name> ``` ### Step 2: One-Click Add Session ```bash # Method 1: Simple parameters python3 ./.trellis/scripts/add_session.py --title "Session Title" --commit "hash1,hash2" --summary "Brief summary of what was done" # Method 2: Pass detailed content via stdin cat << 'EOF' | python3 ./.trellis/scripts/add_session.py --stdin --title "Title" --commit "hash" | Feature | Description | |---------|-------------| | New API | Added user authentication endpoint | | Frontend | Updated login form | **Updated Files**: - `packages/api/modules/auth/router.ts` - `apps/web/modules/auth/components/login-form.tsx` EOF ``` **Auto-completes**: - [OK] Appends session to journal-N.md - [OK] Auto-detects line count, creates new file if >2000 lines - [OK] Auto-detects Branch context (`--branch` override; otherwise Branch = task.json -> current git branch; missing values are omitted gracefully) - [OK] Updates index.md (Total Sessions +1, Last Active, line stats, history) - [OK] Auto-commits .trellis/workspace and .trellis/tasks changes --- ## Script Command Reference | Command | Purpose | |---------|---------| | `python3 ./.trellis/scripts/get_context.py --mode record` | Get context for record-session | | `python3 ./.trellis/scripts/add_session.py --title "..." --commit "..."` | **One-click add session (recommended, branch auto-complete)** | | `python3 ./.trellis/scripts/task.py archive <name>` | Archive completed task (auto-commits) | | `python3 ./.trellis/scripts/task.py list` | List active tasks |

Инициализация мануала...