reference-module

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Use when the user asks to inspect, compare, or research another Git repository.

当用户要求检查、比较或研究其他Git仓库时使用。

Get the repo URL, plus any requested branch, tag, commit, or alias.
Resolve storage from the active
```
SKILL.md
```
: find the nearest parent named
```
skills
```
; its parent is
```
<scope-root>
```
. If unavailable, ask for a storage path.
Store references in
```
<scope-root>/reference-modules/<name>
```
, where
```
<name>
```
is the alias,
```
<owner>/<repo-name>
```
when the URL has an owner or group, or the repo basename when it does not. Strip trailing
```
.git
```
.
If the target exists, ask unless the user already chose:
- use as-is: do not fetch or check out; report current ref/SHA
- update: fetch, then check out the requested ref or remote
```
HEAD
```
- copy: clone into a separate directory; ask for a name unless alias was provided Never modify an unsafe or wrong-repo target without asking.
If the target is missing, clone it. Use remote
```
HEAD
```
unless a ref was requested.

Fetch only for update/copy:

bash

git -C <reference-path> fetch --all --tags --prune

After clone/update/copy, check out the requested ref or remote
```
HEAD
```
, preferably detached. If the user chose use as-is, leave it untouched.
Treat contents as read-only. Do not create submodules, symlinks, or pointer files unless explicitly asked.
Report path, source URL, action taken, checked-out ref, and commit SHA.

仅在更新/复制时执行拉取：

bash

git -C <reference-path> fetch --all --tags --prune