技能介绍

技能简介

通过已授权的 GitHub 账号管理仓库协作事务，支持创建或派生仓库、提交合并请求、创建 Issue、评论及版本发布，适合把明确的开发协作需求转化为可核对的操作结果。

适用场景

开源贡献；整理项目问题；提交功能分支；维护发行说明和 Release。

使用方法

提供仓库链接或所有者/仓库名，说明要查询或执行的具体操作。
创建 PR 时给出来源分支与目标分支；发布版本时给出标签、版本说明和发布范围。
核对目标仓库及将写入的内容，完成后通过实际返回的链接查看结果。

参数与输入说明

可直接用自然语言说明这些选项；带代码样式的参数按实际工具定义处理。

参数或输入项	填写说明
仓库	使用 owner/repo 或完整 GitHub 链接，避免同名仓库混淆。
分支	PR 的来源分支与目标分支；不要仅填写一个含糊的“主分支”。
对象与内容	Issue/PR 编号，以及标题、正文或评论文字。
发布信息	Release 标签、标题、说明及是否为预发布。

示例需求

为 example/device-agent 仓库的 feature/report 分支向 main 创建 PR，标题为“新增设备日报”，根据提交内容整理说明并返回链接。

交付内容

查询结果，或已执行操作对应的仓库、Issue、PR、Release 链接。

使用前提与注意事项

需要可用的 GitHub 凭证及对应仓库权限，账号只能操作授权范围内的资源。
推送、评论、合并和发布会影响远端项目，需明确目标与操作内容。

使用说明

以下为技能最新版本的 SKILL.md 正文，智能体按其中的步骤完成任务。

GitHub Operations Skill

通过 GitHub REST API 完成核心 Git/GitHub 操作。

API 文档: https://docs.github.com/en/rest?apiVersion=2022-11-28

通用请求格式

所有 API 调用统一携带以下 Header:

-H "Authorization: Bearer $GITHUB_TOKEN" \
-H "Accept: application/vnd.github+json" \
-H "X-GitHub-Api-Version: 2022-11-28"

以下示例中用 $OWNER 和 $REPO 代替具体的用户名和仓库名。

核心操作

1. 获取当前用户信息

curl -s https://api.github.com/user \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "Accept: application/vnd.github+json" | jq '{login, id, name}'

2. 创建仓库

curl -s -X POST https://api.github.com/user/repos \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  -d '{"name":"$REPO","description":"desc","private":false}'

3. Fork 仓库

curl -s -X POST https://api.github.com/repos/$OWNER/$REPO/forks \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  -d '{"default_branch_only":true}'

4. 推送代码

git remote set-url origin https://${GITHUB_TOKEN}@github.com/$OWNER/$REPO.git
git add . && git commit -m "message" && git push -u origin main

5. 创建 Pull Request

curl -s -X POST https://api.github.com/repos/$OWNER/$REPO/pulls \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  -d '{
    "title":"PR title",
    "head":"feature-branch",
    "base":"main",
    "body":"description"
  }'

跨 Fork 提 PR 时 head 格式为 your-username:branch-name。

6. 评论 Issue / PR

Issue 和 PR 共用评论 API:

curl -s -X POST https://api.github.com/repos/$OWNER/$REPO/issues/$NUMBER/comments \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  -d '{"body":"comment content"}'

7. 创建 Release

curl -s -X POST https://api.github.com/repos/$OWNER/$REPO/releases \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  -d '{
    "tag_name":"v1.0.0",
    "name":"v1.0.0",
    "body":"release notes",
    "generate_release_notes":true
  }'

8. 创建 Issue

curl -s -X POST https://api.github.com/repos/$OWNER/$REPO/issues \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  -d '{"title":"issue title","body":"description","labels":["bug"]}'

GITHUB_TOKEN 获取方式

方式一: Fine-grained Personal Access Token (推荐)

打开 https://github.com/settings/personal-access-tokens/new
填写 Token name、Expiration
选择 Repository access（建议按需选择仓库）
在 Permissions 中勾选所需权限:
- Contents: Read and Write（推送代码）
- Pull requests: Read and Write（创建/管理 PR）
- Issues: Read and Write（创建/评论 Issue）
- Metadata: Read-only（自动授予）
点击 Generate token，复制保存