Add gitea-repo-sync skill

gitea-repo-sync/references/gitea-api-notes.md

@@ -0,0 +1,49 @@
+# Gitea API Notes
+
+本技能默认对接 Gitea v1.25.x，核心只依赖少量稳定接口：
+
+- `GET /api/v1/user`
+- `GET /api/v1/repos/{owner}/{repo}`
+- `POST /api/v1/user/repos`
+- `POST /api/v1/orgs/{org}/repos`
+
+## 创建仓库的 owner 选择
+
+1. 先调用 `GET /api/v1/user` 获取当前 token 对应登录名。
+2. 如果目标 `owner` 与当前登录名一致，走 `POST /api/v1/user/repos`。
+3. 如果目标 `owner` 不同，按组织仓库处理，走 `POST /api/v1/orgs/{org}/repos`。
+
+## 推荐请求头
+
+```text
+Authorization: token <token>
+Content-Type: application/json
+Accept: application/json
+```
+
+## Git Push 认证建议
+
+不要把 token 写入 `git remote -v`。
+
+优先使用一次性的 HTTP header：
+
+- 用户名：Gitea 登录名
+- 密码：token
+- Header：`Authorization: Basic <base64(username:token)>`
+
+这样可以在 push 时认证，但不会把 token 持久化到仓库配置里。
+
+## 建议的环境变量
+
+```bash
+export GITEA_URL='https://git.hk.hao.work'
+export GITEA_TOKEN='<your_token>'
+```
+
+## 失败时优先检查
+
+- token 是否有 repo 创建/写入权限
+- `owner` 是用户还是组织
+- 本地目录是否已经是 Git 仓库
+- 当前分支是否存在提交
+- 远程 URL 是否已指向别的仓库