一个帮助AI编码代理与咒术（jj）版本控制系统协作的特工技能。

概述

该仓库为Claude Code及其他兼容的AI代理提供Agent技能，以有效使用Jujutsu VCS。该技能教授代理创建原子级、文档详尽提交的正确工作流程和命令。

兼容性

测试对象： jj v0.37.0

该技能专为 jj v0.37.0 设计，可能兼容其他版本，但兼容性不保证。

什么是咒术？

咒术（jj）是一款兼容Git的版本控制系统，具有多项优势：

• 作为提交工作副本：工作目录始终是提交，自动快照更改
• 无预备区：更改通过squash和[[T1]在提交之间直接移动]
• 自动重基：当父提交发生变化时，后代提交会自动重新基准
• 可变提交：提交可以自由编辑、拆分和压缩
• 变更ID：在提交重写中持续存在的稳定标识符
• 冲突处理：冲突可以被提交并后续解决

安装

如果你使用just，可以运行：

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