docs(uninstall): describe the git status block in help and tracked repo docs

uninstall has failed a tracked repo whose git status cannot be read
since 8e5a09c4, but --help still listed only the uncommitted-changes
check. The tracked repositories page also said a dirty repo only warns
and that the directory is removed, while uninstall stops unless --force
and moves the repo to trash.
This commit is contained in:
Willie
2026-09-30 02:54:49 +08:00
parent d741baf333
commit 82b4033684
6 changed files with 11 additions and 10 deletions
+1
View File
@@ -603,6 +603,7 @@ If the skill was installed from a remote source, a reinstall command is shown.
For tracked repositories (_repo-name):
- Checks for uncommitted changes (requires --force to override)
- Fails if git status cannot be read (requires --force to override)
- Automatically removes the entry from .gitignore
- The _ prefix is optional (automatically detected)
@@ -167,8 +167,8 @@ skillshare uninstall _team-skills
```
**What happens:**
1. Checks for uncommitted changes (warns if found)
2. Removes the directory
1. Checks for uncommitted changes and stops if it finds any, or if it cannot read the git status (`--force` overrides)
2. Moves the directory to trash (kept 7 days)
3. Next `sync` removes the symlinks from targets
---
@@ -167,8 +167,8 @@ skillshare uninstall _team-skills
```
**何が起こるか:**
1. 未コミットの変更がないか確認します(見つかった場合は警告します)
2. ディレクトリを削除します
1. 未コミットの変更がないか確認し、変更がある場合や git status を読み取れない場合は中止します(`--force` で上書き)
2. ディレクトリをゴミ箱に移動します(7 日間保持)
3. 次の `sync` で Target からシンボリックリンクが削除されます
---
@@ -167,8 +167,8 @@ skillshare uninstall _team-skills
```
**일어나는 일:**
1. 커밋되지 않은 변경 사항이 있는지 확인 (있으면 경고)
2. 디렉터리 제거
1. 커밋되지 않은 변경 사항이 있는지 확인하고, 변경 사항이 있거나 git status를 읽을 수 없으면 중단 (`--force`로 무시)
2. 디렉터리를 휴지통으로 이동 (7일 보관)
3. 다음 `sync`에서 target의 symlink 제거
---
@@ -167,8 +167,8 @@ skillshare uninstall _team-skills
```
**发生了什么:**
1. 检查是否存在未提交的变更(若存在则警告)
2. 删除目录
1. 检查是否存在未提交的变更;若存在变更或无法读取 git status,则停止(可用 `--force` 覆盖)
2. 将目录移到回收站(保留 7 天)
3. 下一次 `sync` 会从 Target 中移除对应的符号链接
---
@@ -167,8 +167,8 @@ skillshare uninstall _team-skills
```
**會發生什麼事:**
1. 檢查是否有未 commit 的變更(若有會提出警告)
2. 移除該目錄
1. 檢查是否有未 commit 的變更;若有變更或無法讀取 git status,就會停止(可用 `--force` 覆寫)
2. 將該目錄移到垃圾桶(保留 7 天)
3. 下次 `sync` 時,會從 targets 移除對應的 symlink
---