AgentSkillsCN

use-jujutsu

此技能适用于详细指导 Jujutsu（jj）版本控制系统的各项操作，包括提交、推送、历史查询，以及修订/修订集的管理与应用。当用户询问“如何使用 jj？”、“如何将 Git 转换为 jj？”、“如何通过 jj 与版本控制系统交互？”或寻求特定 jj 命令语法时，均可使用该技能。

SKILL.md
--- frontmatter
name: use-jujutsu
description: This skill should be used for detailed guidance on Jujutsu (jj) VCS operations, including committing, pushing, searching history, and working with revisions/revsets. Use it when the user asks "how do I use jj?", "translate git to jj", ask to interact with VCS using jj or for specific jj command syntax.
version: 0.3.0

Using Jujutsu (jj) VCS

This guide provides the definitive instruction set for working with Jujutsu (jj).

Core VCS Commands

CRITICAL: This repository uses Jujutsu (jj), not git. Always use jj commands for version control operations.

  • •Check status: jj st --no-pager
  • •View history: jj log --no-pager
  • •Create commit: jj commit -m "message"
  • •Only commit related changes: jj commit -m "message" <filesets>
    • •Example: jj commit -m "fix auth bug" src/auth.rs tests/auth_test.rs
    • •NEVER restore files to exclude them from a commit.
  • •Push: jj git push
  • •Push main: jj bookmark set main -r @- && jj git push
  • •Undo last jj command: jj undo
  • •Help: jj help -- use this is you need to research how jj works. Or use available MCPs.

Search and History Operations

History Search

  • •Use jj log -r '<revset>' with appropriate revset expressions
  • •For searching by message: jj log -r "description(pattern)"
  • •For searching by author: jj log -r "author(pattern)"
  • •For date-based searches: jj log -r "after(date)" or jj log -r "before(date)"

Code Search

  • •Prefer rg (ripgrep) or grep over any VCS-integrated grep
  • •Do not use git grep in jj repos; use rg instead

Working with Revisions (Revsets)

  • •@ — Current working-copy parent revision
  • •@- — Parent of current revision
  • •<ref> — Specific revision by ref (supports short hashes)
  • •main — Branch by name
  • •ancestors(@) — All ancestors of current revision
  • •descendants(@) — All descendants of current revision

Important Constraints

  • •Never use git commands in .jj/ repositories—translate to jj equivalent.
  • •Do not mix git and jj operations; they have incompatible internal models.
  • •If a jj command fails, provide the error message and suggest alternatives.

Integration with Search and Analysis

  • •Use jj log instead of git log to find recent changes.
  • •Use jj diff to compare revisions.
  • •Never use git log -S or git log -G; translate to jj log with appropriate revsets.