gitlink-cli/skills/gitlink-user/SKILL.md

name	version	description	metadata
gitlink-user	2.0.0	用户信息查询：查看当前登录用户、查询用户详情、获取用户项目统计。当用户需要查看 GitLink 用户信息、验证认证状态或查询其他用户时触发。	requires cliHelp bins gitlink-cli gitlink-cli user --help

gitlink-user（用户信息查询）

CRITICAL — 开始前必须先阅读 ../gitlink-shared/SKILL.md，其中包含认证、权限处理和 API 注意事项。 CRITICAL — GitLink 操作只能用 gitlink-cli。禁止用 gh（GitHub CLI）操作 GitLink 资源。gh 仅适用于 GitHub 平台。

前置条件： 先阅读 ../gitlink-shared/SKILL.md 了解认证和全局参数。

概述

本 Skill 提供用户信息查询能力，主要用于：

1. 认证验证：通过 user +me 确认当前登录状态和用户身份
2. 用户画像：查询任意公开用户的详情（项目数、身份、注册时间等）
3. 用户 ID 解析：在批量操作中需要 user_id 时，通过 login 查询获取

数据采集命令

查看当前登录用户

# 获取当前认证用户信息（需要登录）
gitlink-cli user +me --format json

查看指定用户详情

# 通过 login 查询用户详情
gitlink-cli user +info --login chroe --format json

Raw API 补充

# 搜索用户（按用户名模糊匹配，返回含 user_id）
gitlink-cli api GET /users/list --query 'search=chroe'

# 获取用户项目列表
gitlink-cli api GET /users/:user_id/projects --query 'page=1&limit=10'

Shortcuts

Shortcut	说明	需要认证
user +me	当前登录用户	是
user +info	查看用户详情	否（公开用户）

使用示例

# 查看当前登录用户
gitlink-cli user +me

# 查看 chroe 用户详情
gitlink-cli user +info --login chroe

# 搜索用户（获取 user_id 用于批量操作）
gitlink-cli api GET /users/list --query 'search=chroe'

注意事项

• user +me 需要先 auth login，否则返回未认证错误
• user +info --login 传入的是用户 login（URL 中的路径），不是 user_id
• 部分用户信息字段（如 email）仅对本人可见
• 详见 REFERENCE.md 了解完整的字段映射