Агентский навык, который помогает агентам кодирования ИИ работать с системой контроля версий Jujutsu (jj).

Обзор

Этот репозиторий предоставляет агентский навык для кода Клода и других совместимых агентов ИИ для эффективного использования VCS Jujutsu. Навык учит агентов правильному рабочему процессу и командам для создания атомных, хорошо документированных обязательств с использованием jj.

##Совместимость

** Проверено: ** jj v0.37.0

Этот навык предназначен для jj v0.37.0 и может работать с другими версиями, хотя совместимость не гарантируется.

##Что такое джиу-джитсу?

Jujutsu (jj) - это Git-совместимая система управления версиями, которая предлагает несколько преимуществ:

Рабочая копия как обязательство: Рабочий каталог всегда является фиксированным, автоматически снимающим изменения. ** Нет области постановки **: изменения перемещаются непосредственно между обязательствами с использованием squash и split -Автоматическое восстановление: Обязательства потомка автоматически переосновываются, когда родитель совершает изменения.

• ** Заменяемые обязательства**: Обязательства могут быть свободно отредактированы, разделены и раздавлены Изменить документы: Стабильные идентификаторы, которые сохраняются при переписывании -Урегулирование конфликтов: Конфликты могут быть совершены и разрешены позже.

##Установка

Если вы используете только, вы можете запустить:

jj VCS Agent Skill

An Agent Skill that helps AI coding agents work with the Jujutsu (jj) version control system.

Overview

This repository provides an Agent Skill for Claude Code and other compatible AI agents to effectively use the Jujutsu VCS. The skill teaches agents the proper workflow and commands for creating atomic, well-documented commits using jj.

Compatibility

Tested with: jj v0.37.0

This skill is designed for jj v0.37.0 and may work with other versions, though compatibility is not guaranteed.

What is Jujutsu?

Jujutsu (jj) is a Git-compatible version control system that offers several advantages:

• Working copy as a commit: The working directory is always a commit, automatically snapshotting changes
• No staging area: Changes are moved directly between commits using squash and split
• Automatic rebasing: Descendant commits are automatically rebased when parent commits change
• Mutable commits: Commits can be freely edited, split, and squashed
• Change IDs: Stable identifiers that persist across commit rewrites
• Conflict handling: Conflicts can be committed and resolved later

Installation

If you use just, you can run:

just install

Copy the skill/ directory into your project’s .claude/skills/ directory:

cp -r skill/ /path/to/your/project/.claude/skills/jj-vcs/

Or install it as a global skill:

cp -r skill/ ~/.claude/skills/jj-vcs/

Skill Contents

skill/
└── SKILL.md    # Main skill file with jj workflow instructions

Key Workflow Philosophy

The skill emphasizes:

1. Describe-first commits: Use jj desc -m "message" before making changes
2. Atomic commits: Each commit should represent one logical change
3. Commit quality preservation: Leverage jj’s mutability to refine commits
4. Clean history: Use squash, split, and absorb to maintain a readable history

Contributing

Contributions are welcome. Please ensure any changes are compatible with jj v0.37.0.

License

MIT