vcs-detect

检测当前项目是采用 jj（Jujutsu）还是 git 进行版本控制。在执行任何 VCS 命令之前运行此技能，以确保选用正确的工具。

SKILL.md

--- frontmatter

name: vcs-detect
description: Detect whether the current project uses jj (Jujutsu) or git for version control. Run this BEFORE any VCS command to use the correct tool.

VCS Detection Skill

Detect the version control system in use before running any VCS commands.

Why This Matters

•jj (Jujutsu) and git have different CLIs and workflows
•Running git commands in a jj repo (or vice versa) causes errors
•Some repos use jj with git colocated (both .jj/ and .git/ exist)

Detection Logic

Priority order (check in sequence):

•Check for .jj/ directory - If exists, use jj
•Check for .git/ directory - If exists, use git
•Neither found - Not a VCS-managed directory

code

if .jj/ exists -> use jj
else if .git/ exists -> use git
else -> no VCS detected

Detection Command

Run this single command to detect VCS:

bash

if [ -d ".jj" ]; then echo "jj"; elif [ -d ".git" ]; then echo "git"; else echo "none"; fi

Command Mappings

Operation	git	jj
Status	`git status`	`jj status`
Log	`git log`	`jj log`
Diff	`git diff`	`jj diff`
Commit	`git commit`	`jj commit` / `jj describe`
Branch list	`git branch`	`jj bookmark list`
New branch	`git checkout -b <name>`	`jj bookmark create <name>`
Push	`git push`	`jj git push`
Pull/Fetch	`git pull` / `git fetch`	`jj git fetch`
Rebase	`git rebase`	`jj rebase`

Usage

Before any VCS operation:

•Run detection command
•Use appropriate CLI based on result
•If none, warn user directory is not version controlled

Example Integration

code

User: Show me the git log
Agent: [Runs detection] -> Result: jj
Agent: [Runs `jj log` instead of `git log`]

Colocated Repos

When both .jj/ and .git/ exist, the repo is "colocated":

•jj manages the working copy
•git is available for compatibility (GitHub, etc.)
•Always prefer jj commands in colocated repos