gitea-cli/SKILL.md

name, description

name	description
gitea-cli	對自架 Gitea 做常見操作：建 repo 並推送、列出 repo、clone、改名、切換公開私有、archive、刪除、設定 description/topics、建 release 並上傳附件、打 tag。當使用者提到 Gitea 相關的 push / clone / list / rename / release / archive / delete / tag 等需求時使用。需先在 config.env 設定 Gitea URL、使用者名稱、access token。

gitea-cli

把自架 Gitea 常見操作封裝成 bash 腳本。Token 絕不落地到 .git/config。

使用前準備（只需做一次）

1. 到自己的 Gitea 產生 access token（權限至少 write:repository）
2. 在本 skill 目錄下：

   cp config.example.env config.env
   # 編輯 config.env 填入 GITEA_URL / GITEA_USER / GITEA_TOKEN
   

3. config.env 已被 .gitignore 排除。

常見情境 → 對應腳本

<skill-path> 代表本 skill 所在路徑（clone 下來的位置或 ~/.claude/skills/gitea-cli symlink）。

要做什麼	指令
建 repo 並把目前專案推上去	bash <skill-path>/scripts/publish.sh [repo] [public|private] [-m "msg"]
列出自己所有 repo	bash <skill-path>/scripts/list.sh [--private|--public] [--format table|tsv|name]
clone 某個 repo 到本地	bash <skill-path>/scripts/clone.sh <repo> [target-dir]
改 repo 名稱	bash <skill-path>/scripts/rename.sh <old> <new>
切換 public/private	bash <skill-path>/scripts/visibility.sh <repo> <public|private>
設定 description / topics	bash <skill-path>/scripts/meta.sh <repo> [--desc "..."] [--topics "a,b,c"]
archive / unarchive	bash <skill-path>/scripts/archive.sh <repo> [--unarchive] [-y]
刪除 repo	bash <skill-path>/scripts/delete.sh <repo> [-y]
打 tag 並推上去	bash <skill-path>/scripts/tag.sh <tag> [-m "msg"]
建 release（含 asset 上傳）	bash <skill-path>/scripts/release.sh <tag> [--name ...] [--notes ...] [--asset PATH]... [--repo NAME]

注意

• config.env 絕對不要 commit
• origin remote 永遠是乾淨 URL；token 只在 push/clone 當下透過一次性 credential helper 注入
• 破壞性操作（archive.sh / delete.sh）預設需要互動確認；自動化場景請帶 -y / --yes 或設 GITEA_YES=1
• 401/403 → 檢查 config.env 的 token

回覆原則

• 執行前先確認 cwd 就是要操作的目標
• 執行後簡述結果（URL / branch / 刪除/建立的項目）