Gitlink
/
gitlink-cli
0
0
Fork 49
Code Issues Pull Requests 11 Packages Projects Releases 10 Wiki Activity

fix: Skills 文件 api 命令替换为 Shortcut 命令 (~107 处) 

将 skills/ 目录下 21 个文件中的 gitlink-cli api <METHOD> <PATH> 命令
替换为对应的 Shortcut 命令，修复因 Token 注入不完整导致的 HTML 响应问题。

主要替换:
- api GET /:owner/:repo/languages → repo +languages
- api GET /:owner/:repo/sub_entries → repo +files
- api GET /:owner/:repo/raw/... → repo +raw
- api POST /:owner/:repo/create_file → repo +create-file
- api POST /:owner/:repo/pulls/:id/reviews → pr +review
- api GET /:owner/:repo/pulls/:id → pr +view
- 等共 107 处替换

注: 6 处 pm 域命令暂留（pm 模块尚未构建）

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
林迪文 2026-06-03 09:39:48 +08:00
parent b748a95511
commit d50b3c7364
20 changed files with 107 additions and 107 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
skills/gitlink-ci/SKILL.md
View File

@ -45,11 +45,11 @@ gitlink-cli ci +stop --build 42
```bash
# 激活 CI
gitlink-cli api POST /:owner/:repo/activate
gitlink-cli ci +activate
# 停用 CI
gitlink-cli api DELETE /:owner/:repo/deactivate
gitlink-cli ci +deactivate
# CI 授权状态
gitlink-cli api GET /:owner/:repo/ci_authorize
gitlink-cli ci +authorize
```

8
skills/gitlink-code-review/REFERENCE.md
View File

@ -160,7 +160,7 @@ gitlink-cli repo +info --owner <owner> --repo <repo> --format json
### 获取仓库文件列表
```bash
gitlink-cli api GET /:owner/:repo/sub_entries --query 'filepath=<path>&ref=<branch>' --format json
gitlink-cli repo +files --query 'filepath=<path>&ref=<branch>' --format json
```
**返回字段说明：**
@ -177,7 +177,7 @@ gitlink-cli api GET /:owner/:repo/sub_entries --query 'filepath=<path>&ref=<bran
### 获取仓库语言统计
```bash
gitlink-cli api GET /:owner/:repo/languages --format json
gitlink-cli repo +languages --format json
```
**返回示例：**
@ -188,7 +188,7 @@ gitlink-cli api GET /:owner/:repo/languages --format json
### 获取仓库原始文件
```bash
gitlink-cli api GET /:owner/:repo/raw/<branch>/<filepath>
gitlink-cli repo +raw --ref=<branch>/<filepath>
```
---
@ -213,7 +213,7 @@ gitlink-cli user +me --format json
### 获取用户信息
```bash
gitlink-cli api GET /users/:user_id --format json
gitlink-cli user +info --login --format json
```
| 字段 | 类型 | 说明 |

38
skills/gitlink-code-review/SKILL.md
View File

@ -109,13 +109,13 @@ gitlink-cli pr +diff --id <pr_id> --format json
```bash
# 方式 1：提交整体 Review
gitlink-cli api POST /:owner/:repo/pulls/:id/reviews --body '{
gitlink-cli pr +review --body '{
"body": "## 审查结果\n\n### 🔴 Critical\n...\n\n### 🟡 Warning\n...\n\n总体评价：...",
"event": "COMMENT"
}'
# 方式 2：在特定行添加内联评论（逐条提交）
gitlink-cli api POST /:owner/:repo/pulls/:id/reviews --body '{
gitlink-cli pr +review --body '{
"body": "这里存在安全风险：用户输入未经转义直接拼接到 SQL 查询中，存在注入风险。建议使用参数化查询。",
"event": "COMMENT",
"commit_id": "<commit_sha>",
@ -164,18 +164,18 @@ gitlink-cli api POST /:owner/:repo/pulls/:id/reviews --body '{
gitlink-cli repo +info --owner <owner> --repo <repo> --format json
# 2. 获取仓库文件列表（遍历关键目录）
gitlink-cli api GET /:owner/:repo/sub_entries --query 'filepath=src&ref=master'
gitlink-cli api GET /:owner/:repo/sub_entries --query 'filepath=tests&ref=master'
gitlink-cli repo +files --query 'filepath=src&ref=master'
gitlink-cli repo +files --query 'filepath=tests&ref=master'
# 3. 获取关键文件内容
gitlink-cli api GET /:owner/:repo/raw/master/README.md
gitlink-cli api GET /:owner/:repo/raw/master/.gitignore
gitlink-cli api GET /:owner/:repo/raw/master/.eslintrc.js # 或类似配置
gitlink-cli api GET /:owner/:repo/raw/master/package.json # 或 go.mod, Cargo.toml
gitlink-cli repo +raw --ref=master/README.md
gitlink-cli repo +raw --ref=master/.gitignore
gitlink-cli repo +raw --ref=master/.eslintrc.js # 或类似配置
gitlink-cli repo +raw --ref=master/package.json # 或 go.mod, Cargo.toml
# 4. 获取语言统计和贡献者
gitlink-cli api GET /:owner/:repo/languages
gitlink-cli api GET /:owner/:repo/contributors
gitlink-cli repo +languages
gitlink-cli repo +contributors
```
**健康度检查清单：**
@ -233,7 +233,7 @@ gitlink-cli issue +view --id <issue_id> --format json
# 3. 根据内容智能分类
# 分析标题和描述后，通过 Raw API 打标签
gitlink-cli api POST /:owner/:repo/issues/:id --body '{
gitlink-cli issue +update --number '{
"issue_tag_ids": [<tag_id>],
"done_ratio": 0,
"subject": "<原始标题>",
@ -261,28 +261,28 @@ gitlink-cli api POST /:owner/:repo/issues/:id --body '{
```bash
# 获取 PR 详情
gitlink-cli api GET /:owner/:repo/pulls/:id --format json
gitlink-cli pr +view --id --format json
# 获取 PR 变更文件列表
gitlink-cli api GET /:owner/:repo/pulls/:id/files --format json
gitlink-cli pr +files --format json
# 获取 PR Diff
gitlink-cli api GET /:owner/:repo/pulls/:id/diff --format json
gitlink-cli pr +diff --format json
# 提交 PR Review
gitlink-cli api POST /:owner/:repo/pulls/:id/reviews --body '{"body":"...","event":"COMMENT"}'
gitlink-cli pr +review --body '{"body":"...","event":"COMMENT"}'
# 获取仓库文件列表
gitlink-cli api GET /:owner/:repo/sub_entries --query 'filepath=<path>&ref=<branch>'
gitlink-cli repo +files --query 'filepath=<path>&ref=<branch>'
# 获取仓库语言统计
gitlink-cli api GET /:owner/:repo/languages --format json
gitlink-cli repo +languages --format json
# 获取贡献者列表
gitlink-cli api GET /:owner/:repo/contributors --format json
gitlink-cli repo +contributors --format json
# 获取仓库动态
gitlink-cli api GET /:owner/:repo/activity --format json
gitlink-cli repo +activity --format json
```
## 代码审查最佳实践

4
skills/gitlink-code-review/examples/pr-review-workflow.md
View File

@ -117,7 +117,7 @@ gitlink-cli pr +diff --id 42 --format json
```bash
# 提交整体 Review 评论
gitlink-cli api POST /Gitlink/forgeplus/pulls/42/reviews --body '{
gitlink-cli pr +review --id 42 --owner Gitlink --repo forgeplus --body '{
"body": "## PR #42 代码审查报告\n\n### 🔴 Critical\n\n1. **JWT Secret 硬编码** — `src/config.py:15`\n JWT_SECRET 硬编码在源码中。建议使用 `os.getenv(\"JWT_SECRET\")`。\n\n2. **SQL 注入风险** — `src/auth/login.py:42`\n 直接拼接用户输入到 SQL 查询。建议使用参数化查询。\n\n### 🟡 Warning\n\n1. **密码明文存储** — 建议使用 bcrypt 哈希处理。\n\n### 总体评价\n\n代码整体结构清晰，测试覆盖良好。建议修复 Critical 问题后合并。",
"event": "COMMENT"
}'
@ -160,5 +160,5 @@ gitlink-cli pr +files --id <id> --format json
gitlink-cli pr +diff --id <id> --format json
# 提交 Review
gitlink-cli api POST /:owner/:repo/pulls/:id/reviews --body '{"body":"...","event":"COMMENT"}'
gitlink-cli pr +review --body '{"body":"...","event":"COMMENT"}'
```

2
skills/gitlink-commit-quality/SKILL.md
View File

@ -62,7 +62,7 @@ metadata:
gitlink-cli pr +diff --id <pr_id> --owner <owner> --repo <repo> --format json
# 或通过 Raw API 获取提交详情
gitlink-cli api GET /:owner/:repo/pulls/:pr_id/commits --format json
gitlink-cli pr +commits --format json
```
### Commit Message 质量检查清单

6
skills/gitlink-compliance/REFERENCE.md
View File

@ -7,7 +7,7 @@
### 读取文件内容
```bash
gitlink-cli api GET /:owner/:repo/raw/<branch>/<filepath>
gitlink-cli repo +raw --ref=<branch>/<filepath>
```
**说明：** 直接返回文件原始内容，用于检查 LICENSE、README、CONTRIBUTING 等文件。
@ -15,7 +15,7 @@ gitlink-cli api GET /:owner/:repo/raw/<branch>/<filepath>
### 获取文件列表
```bash
gitlink-cli api GET /:owner/:repo/sub_entries --query 'filepath=<path>&ref=<branch>' --format json
gitlink-cli repo +files --query 'filepath=<path>&ref=<branch>' --format json
```
| 字段 | 类型 | 说明 |
@ -45,7 +45,7 @@ gitlink-cli repo +info --owner <owner> --repo <repo> --format json
### 获取贡献者列表
```bash
gitlink-cli api GET /:owner/:repo/contributors --format json
gitlink-cli repo +contributors --format json
```
用于检查贡献者是否签署了 CLA/DCO。

30
skills/gitlink-compliance/SKILL.md
View File

@ -39,10 +39,10 @@ metadata:
```bash
# 1. 获取仓库文件结构
gitlink-cli api GET /:owner/:repo/sub_entries --query 'filepath=&ref=master'
gitlink-cli repo +files --query 'filepath=&ref=master'
# 2. 读取 LICENSE 文件
gitlink-cli api GET /:owner/:repo/raw/master/LICENSE
gitlink-cli repo +raw --ref=master/LICENSE
# 3. 检查关键文档是否存在
# 检查以下文件是否存在：
@ -54,14 +54,14 @@ gitlink-cli api GET /:owner/:repo/raw/master/LICENSE
# - README.md
# 4. 获取依赖配置
gitlink-cli api GET /:owner/:repo/raw/master/package.json # Node.js
gitlink-cli api GET /:owner/:repo/raw/master/go.mod # Go
gitlink-cli api GET /:owner/:repo/raw/master/requirements.txt # Python
gitlink-cli api GET /:owner/:repo/raw/master/Cargo.toml # Rust
gitlink-cli api GET /:owner/:repo/raw/master/pom.xml # Java/Maven
gitlink-cli repo +raw --ref=master/package.json # Node.js
gitlink-cli repo +raw --ref=master/go.mod # Go
gitlink-cli repo +raw --ref=master/requirements.txt # Python
gitlink-cli repo +raw --ref=master/Cargo.toml # Rust
gitlink-cli repo +raw --ref=master/pom.xml # Java/Maven
# 5. 获取源文件检查（按语言采样）
gitlink-cli api GET /:owner/:repo/sub_entries --query 'filepath=src&ref=master'
gitlink-cli repo +files --query 'filepath=src&ref=master'
# 6. 获取仓库基本信息
gitlink-cli repo +info --owner <owner> --repo <repo> --format json
@ -146,7 +146,7 @@ gitlink-cli repo +info --owner <owner> --repo <repo> --format json
```bash
# 1. 获取依赖配置文件
gitlink-cli api GET /:owner/:repo/raw/master/package.json
gitlink-cli repo +raw --ref=master/package.json
```
### 许可证兼容性参考
@ -181,10 +181,10 @@ gitlink-cli api GET /:owner/:repo/raw/master/package.json
```bash
# 1. 遍历源文件目录
gitlink-cli api GET /:owner/:repo/sub_entries --query 'filepath=src&ref=master'
gitlink-cli repo +files --query 'filepath=src&ref=master'
# 2. 采样检查源文件头部（取前 5-10 行）
gitlink-cli api GET /:owner/:repo/raw/master/src/main.py
gitlink-cli repo +raw --ref=master/src/main.py
```
### 标准版权声明模板
@ -210,16 +210,16 @@ gitlink-cli api GET /:owner/:repo/raw/master/src/main.py
```bash
# 获取文件内容
gitlink-cli api GET /:owner/:repo/raw/<branch>/<path>
gitlink-cli repo +raw --ref=<branch>/<path>
# 获取文件列表（遍历目录）
gitlink-cli api GET /:owner/:repo/sub_entries --query 'filepath=<path>&ref=<branch>'
gitlink-cli repo +files --query 'filepath=<path>&ref=<branch>'
# 获取仓库信息
gitlink-cli api GET /:owner/:repo --format json
gitlink-cli repo +info --format json
# 获取贡献者列表
gitlink-cli api GET /:owner/:repo/contributors --format json
gitlink-cli repo +contributors --format json
```
## 注意事项

10
skills/gitlink-insight/REFERENCE.md
View File

@ -87,7 +87,7 @@ gitlink-cli release +list --format json
### 仓库文件列表
```bash
gitlink-cli api GET /:owner/:repo/sub_entries --query 'filepath=&ref=<branch>' --format json
gitlink-cli repo +files --query 'filepath=&ref=<branch>' --format json
```
| 字段 | 类型 | 说明 |
@ -100,7 +100,7 @@ gitlink-cli api GET /:owner/:repo/sub_entries --query 'filepath=&ref=<branch>' -
### 仓库语言统计
```bash
gitlink-cli api GET /:owner/:repo/languages --format json
gitlink-cli repo +languages --format json
```
**返回示例：** `{ "Ruby": "90.2%", "JavaScript": "6.1%", "CSS": "3.7%" }`
@ -108,7 +108,7 @@ gitlink-cli api GET /:owner/:repo/languages --format json
### 贡献者列表
```bash
gitlink-cli api GET /:owner/:repo/contributors --format json
gitlink-cli repo +contributors --format json
```
| 字段 | 类型 | 说明 |
@ -121,13 +121,13 @@ gitlink-cli api GET /:owner/:repo/contributors --format json
### 仓库动态
```bash
gitlink-cli api GET /:owner/:repo/activity --format json
gitlink-cli repo +activity --format json
```
### 获取用户详情
```bash
gitlink-cli api GET /users/:user_id --format json
gitlink-cli user +info --login --format json
```
| 字段 | 类型 | 说明 |

24
skills/gitlink-insight/SKILL.md
View File

@ -49,13 +49,13 @@ gitlink-cli pr +list --state open --format json
gitlink-cli pr +list --state merged --format json
# 4. 获取仓库文件结构（检查文档、CI 配置）
gitlink-cli api GET /:owner/:repo/sub_entries --query 'filepath=&ref=master'
gitlink-cli repo +files --query 'filepath=&ref=master'
# 5. 获取语言统计
gitlink-cli api GET /:owner/:repo/languages --format json
gitlink-cli repo +languages --format json
# 6. 获取贡献者列表
gitlink-cli api GET /:owner/:repo/contributors --format json
gitlink-cli repo +contributors --format json
```
### 分析指标
@ -131,7 +131,7 @@ gitlink-cli release +list --format json
gitlink-cli issue +list --state open --format json
# 5. 获取项目动态
gitlink-cli api GET /:owner/:repo/activity --format json
gitlink-cli repo +activity --format json
```
### 输出格式
@ -172,7 +172,7 @@ gitlink-cli api GET /:owner/:repo/activity --format json
```bash
# 1. 获取贡献者列表
gitlink-cli api GET /:owner/:repo/contributors --format json
gitlink-cli repo +contributors --format json
# 2. 获取每个贡献者的 PR
# 通过 PR 列表按 author 过滤
@ -253,25 +253,25 @@ gitlink-cli issue +list --state open --format json
```bash
# 仓库信息
gitlink-cli api GET /:owner/:repo --format json
gitlink-cli repo +info --format json
# 仓库语言统计
gitlink-cli api GET /:owner/:repo/languages --format json
gitlink-cli repo +languages --format json
# 贡献者列表
gitlink-cli api GET /:owner/:repo/contributors --format json
gitlink-cli repo +contributors --format json
# 仓库动态
gitlink-cli api GET /:owner/:repo/activity --format json
gitlink-cli repo +activity --format json
# 文件列表（检查文档/配置完整性）
gitlink-cli api GET /:owner/:repo/sub_entries --query 'filepath=&ref=master'
gitlink-cli repo +files --query 'filepath=&ref=master'
# 获取用户信息
gitlink-cli api GET /users/:user_id --format json
gitlink-cli user +info --login --format json
# 用户贡献热力图
gitlink-cli api GET /users/:user_id/headmaps --format json
gitlink-cli user +heatmap --format json
```
## 注意事项

2
skills/gitlink-insight/examples/sprint-report-workflow.md
View File

@ -28,7 +28,7 @@ gitlink-cli pr +list --state open --format json
## Step 3：获取项目动态
```bash
gitlink-cli api GET /:owner/:repo/activity --format json
gitlink-cli repo +activity --format json
```
## Step 4：生成周报

4
skills/gitlink-issue/SKILL.md
View File

@ -71,10 +71,10 @@ gitlink-cli issue +authors --owner Gitlink --repo forgeplus --keyword bob
```bash
# 获取 Issue 评论列表（使用 v1 API，按 issue number 查询）
gitlink-cli api GET /v1/:owner/:repo/issues/:number/journals
gitlink-cli issue +journals
# 批量更新 Issue（仍使用旧版 API，需传数据库 ID）
gitlink-cli api POST /:owner/:repo/issues/series_update --body '{"ids":[1,2,3],"status_id":"closed"}'
gitlink-cli issue +series-update --body '{"ids":[1,2,3],"status_id":"closed"}'
```
## GitLink Issue 字段映射

6
skills/gitlink-org/SKILL.md
View File

@ -38,9 +38,9 @@ gitlink-cli org +create --name my-org --description "我的组织"
```bash
# 组织团队管理
gitlink-cli api GET /organizations/:id/teams
gitlink-cli api POST /organizations/:id/teams --body '{"name":"dev-team"}'
gitlink-cli org +teams
gitlink-cli org +create-team --body '{"name":"dev-team"}'
# 移除成员
gitlink-cli api DELETE /organizations/:id/organization_users/:uid
gitlink-cli org +remove-user
```

22
skills/gitlink-pr/SKILL.md
View File

@ -113,7 +113,7 @@ gitlink-cli pr +create --owner TargetOrg --repo target-repo \
gitlink-cli branch +create --name feature-branch --from master
# 2. 在分支上创建/修改文件（content 必须 base64 编码）
gitlink-cli api POST /:owner/:repo/create_file --body '{
gitlink-cli repo +create-file --body '{
"filepath": "new-file.md",
"content": "<base64编码的内容>",
"branch": "feature-branch",
@ -128,31 +128,31 @@ gitlink-cli pr +create --title "feat: 新功能" --head feature-branch --base ma
```bash
# 创建文件（content 必须 base64 编码）
gitlink-cli api POST /:owner/:repo/create_file --body '{"filepath":"file.md","content":"<base64>","branch":"dev","message":"add file"}'
gitlink-cli repo +create-file --body '{"filepath":"file.md","content":"<base64>","branch":"dev","message":"add file"}'
# 更新文件（需要先通过 sub_entries 获取文件 SHA）
gitlink-cli api GET /:owner/:repo/sub_entries --query 'filepath=file.md&ref=dev'
gitlink-cli repo +files --query 'filepath=file.md&ref=dev'
# 从 entries.sha 获取 SHA，然后：
gitlink-cli api PUT /:owner/:repo/update_file --body '{"filepath":"file.md","content":"<base64>","sha":"<sha>","branch":"dev","message":"update file"}'
gitlink-cli repo +update-file --body '{"filepath":"file.md","content":"<base64>","sha":"<sha>","branch":"dev","message":"update file"}'
# 检查是否可合并
gitlink-cli api POST /:owner/:repo/pulls/check_can_merge --body '{"head":"dev","base":"main"}'
gitlink-cli pr +check-merge --body '{"head":"dev","base":"main"}'
# 创建 Review
gitlink-cli api POST /v1/:owner/:repo/pulls/:id/reviews --body '{"content":"LGTM","status":"approved"}'
gitlink-cli pr +review --body '{"content":"LGTM","status":"approved"}'
# 查看 Review 列表（支持 status 过滤）
gitlink-cli api GET /v1/:owner/:repo/pulls/:id/reviews
gitlink-cli api GET /v1/:owner/:repo/pulls/:id/reviews?status=approved
gitlink-cli pr +reviews
gitlink-cli pr +reviews?status=approved
# 获取可用分支
gitlink-cli api GET /:owner/:repo/pulls/get_branches
gitlink-cli pr +branches
# 查看 PR patchset/version 列表（v1 API）
gitlink-cli api GET /v1/:owner/:repo/pulls/:id/versions
gitlink-cli pr +versions
# 查看指定 patchset/version diff（可通过 filepath 过滤文件）
gitlink-cli api GET /v1/:owner/:repo/pulls/:id/versions/:version_id/diff
gitlink-cli pr +versions/:version_id/diff
```
## 注意事项

6
skills/gitlink-pr/references/gitlink-pr-create.md
View File

@ -53,7 +53,7 @@ gitlink-cli branch +create --name feature-branch --from master
CONTENT=$(echo -n "文件内容" | base64)
# 通过 Raw API 创建文件
gitlink-cli api POST /:owner/:repo/create_file --body '{
gitlink-cli repo +create-file --body '{
"filepath": "path/to/new-file.md",
"content": "'$CONTENT'",
"branch": "feature-branch",
@ -73,12 +73,12 @@ gitlink-cli pr +create --title "feat: 新功能" --head feature-branch --base ma
```bash
# Step 2a: 获取文件 SHA
gitlink-cli api GET /:owner/:repo/sub_entries --query 'filepath=path/to/file.md&ref=feature-branch'
gitlink-cli repo +files --query 'filepath=path/to/file.md&ref=feature-branch'
# 从返回的 entries.sha 获取 SHA 值
# Step 2b: 更新文件（content 必须 base64 编码）
CONTENT=$(echo -n "更新后的内容" | base64)
gitlink-cli api PUT /:owner/:repo/update_file --body '{
gitlink-cli repo +update-file --body '{
"filepath": "path/to/file.md",
"content": "'$CONTENT'",
"sha": "<从 sub_entries 获取的 sha>",

4
skills/gitlink-release-auto/SKILL.md
View File

@ -49,7 +49,7 @@ gitlink-cli release +list --owner <owner> --repo <repo> --format json
# 取 data.releases[0].tag_name 作为当前版本
# 获取标签列表
gitlink-cli api GET /:owner/:repo/tags --format json
gitlink-cli repo +tags --format json
```
### 步骤 2：获取自上次发版以来的提交
@ -154,7 +154,7 @@ gitlink-cli pr +list --state merged --owner <owner> --repo <repo> --format json
gitlink-cli release +list --owner <owner> --repo <repo> --format json
# Step 2：获取变更内容（提交历史）
gitlink-cli api GET /:owner/:repo/commits --query 'page=1&limit=30&ref=master' --format json
gitlink-cli repo +commits --query 'page=1&limit=30&ref=master' --format json
# Step 3：生成 Release Notes（AI 分析提交后组织内容）

12
skills/gitlink-repo/SKILL.md
View File

@ -55,22 +55,22 @@ Shortcuts 未覆盖的仓库操作可用 Raw API：
```bash
# 获取 README
gitlink-cli api GET /:owner/:repo/readme
gitlink-cli repo +readme
# 获取贡献者列表
gitlink-cli api GET /:owner/:repo/contributors
gitlink-cli repo +contributors
# 获取语言统计
gitlink-cli api GET /:owner/:repo/languages
gitlink-cli repo +languages
# 获取提交列表
gitlink-cli api GET /:owner/:repo/commits --query 'page=1&limit=20'
gitlink-cli repo +commits --query 'page=1&limit=20'
# 获取标签列表
gitlink-cli api GET /:owner/:repo/tags
gitlink-cli repo +tags
# 获取文件内容
gitlink-cli api GET /:owner/:repo/raw/main/README.md
gitlink-cli repo +raw --ref=main/README.md
```
## 注意事项

10
skills/gitlink-shared/SKILL.md
View File

@ -90,7 +90,7 @@ gitlink-cli auth login
| 层级 | 格式 | 示例 | 适用场景 |
|------|------|------|----------|
| Shortcuts | `gitlink-cli <domain> +<verb>` | `gitlink-cli repo +info` | 高频操作，推荐优先使用 |
| Raw API | `gitlink-cli api <METHOD> <PATH>` | `gitlink-cli api GET /users/me` | Shortcuts 未覆盖的接口 |
| Raw API | `gitlink-cli api <METHOD> <PATH>` | `gitlink-cli user +me` | Shortcuts 未覆盖的接口 |
## GitLink API 注意事项
@ -119,7 +119,7 @@ gitlink-cli auth login
```bash
# content 必须 base64 编码
CONTENT=$(echo -n "文件内容" | base64)
gitlink-cli api POST /:owner/:repo/create_file --body '{
gitlink-cli repo +create-file --body '{
"filepath": "path/to/file.md",
"content": "<base64编码>",
"branch": "feature-branch",
@ -131,11 +131,11 @@ gitlink-cli api POST /:owner/:repo/create_file --body '{
```bash
# Step 1: 获取文件 SHA
gitlink-cli api GET /:owner/:repo/sub_entries --query 'filepath=path/to/file.md&ref=branch-name'
gitlink-cli repo +files --query 'filepath=path/to/file.md&ref=branch-name'
# 从返回的 entries.sha 获取 SHA 值
# Step 2: 更新文件（content 必须 base64 编码）
gitlink-cli api PUT /:owner/:repo/update_file --body '{
gitlink-cli repo +update-file --body '{
"filepath": "path/to/file.md",
"content": "<base64编码>",
"sha": "<从sub_entries获取的sha>",
@ -148,7 +148,7 @@ gitlink-cli api PUT /:owner/:repo/update_file --body '{
```bash
# 需要文件 SHA
gitlink-cli api DELETE /:owner/:repo/delete_file --body '{
gitlink-cli repo +delete-file --body '{
"filepath": "path/to/file.md",
"sha": "<sha>",
"branch": "master",

6
skills/gitlink-shared/references/troubleshooting.md
View File

@ -58,7 +58,7 @@ gitlink-cli repo +info --owner xxx --repo yyy
gitlink-cli issue +create -t "标题" -b "描述"
# 或使用 Raw API 时添加 done_ratio
gitlink-cli api POST /:owner/:repo/issues --body '{
gitlink-cli issue +create '{
"subject": "标题",
"description": "描述",
"done_ratio": 0
@ -75,7 +75,7 @@ gitlink-cli api POST /:owner/:repo/issues --body '{
gitlink-cli issue +close -i 123
# 或使用 Raw API 时先 GET 当前 Issue，再添加 subject 和 description
gitlink-cli api PUT /:owner/:repo/issues/123 --body '{
gitlink-cli issue +update --number 123 '{
"subject": "当前标题",
"description": "当前描述",
"status_id": 5
@ -152,7 +152,7 @@ gitlink-cli <command> --debug
### 查看完整 API 请求
```bash
gitlink-cli api GET /users/me --debug
gitlink-cli user +me --debug
```
### 检查认证状态

6
skills/gitlink-user/SKILL.md
View File

@ -37,11 +37,11 @@ gitlink-cli user +info --login zhangsan
```bash
# 用户贡献热力图
gitlink-cli api GET /users/:user_id/headmaps
gitlink-cli user +heatmap
# 用户统计
gitlink-cli api GET /users/:user_id/statistics
gitlink-cli user +stats
# 用户项目动态
gitlink-cli api GET /users/:user_id/project_trends
gitlink-cli user +trends
```

8
skills/gitlink-workflow/SKILL.md
View File

@ -28,7 +28,7 @@ gitlink-cli issue +list --state open --format json
gitlink-cli issue +view --id <issue_id> --format json
# 3. 根据内容分析，通过 Raw API 添加标签
gitlink-cli api POST /:owner/:repo/issues/:id --body '{"issue_tag_ids":[<tag_id>]}'
gitlink-cli issue +update --number '{"issue_tag_ids":[<tag_id>]}'
```
**分类规则建议**：
@ -51,7 +51,7 @@ gitlink-cli pr +files --id <pr_id> --format json
gitlink-cli pr +diff --id <pr_id> --format json
# 4. 添加 Review 评论
gitlink-cli api POST /:owner/:repo/pulls/:id/reviews --body '{"body":"代码审查意见...","event":"COMMENT"}'
gitlink-cli pr +review --body '{"body":"代码审查意见...","event":"COMMENT"}'
```
## 工作流 3：Release Notes 生成
@ -60,7 +60,7 @@ gitlink-cli api POST /:owner/:repo/pulls/:id/reviews --body '{"body":"代码审
```bash
# 1. 获取两个版本之间的提交
gitlink-cli api GET /:owner/:repo/compare/:base...:head --format json
gitlink-cli repo +compare --format json
# 2. 获取已关闭的 Issue
gitlink-cli issue +list --state closed --format json
@ -98,7 +98,7 @@ gitlink-cli pr +list --state open --format json
gitlink-cli pr +list --state merged --format json
# 3. 获取项目动态
gitlink-cli api GET /:owner/:repo/activity --format json
gitlink-cli repo +activity --format json
```
## Workflow: PR Summary (Read-only)