القائمة
GitCode 平台发行版（Release）自动创建技能。当用户提到"创建发行版"、"发布 Release"、"打 Tag 发布"、"创建 GitCode Release"、"新建发行版"、"发版"时触发。自动分析本地 Git 仓库信息，推断版本号，生成发行版描述，创建 Tag 和 Release。必须提供 GitCode Token。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
GitCode 平台 Pull Request 自动化代码审查技能。当用户提供 GitCode PR URL 或提到"审查 GitCode PR"、"GitCode 代码评审"时触发。支持自动获取 PR 信息、执行安全/质量审查、发布行级评论到 GitCode。必须提供 GitCode Token。
GitCode Pull Request 评论处理技能。当用户提到"处理PR评论"、"修复评论问题"、"回复评论"、"验证评论有效性"、"查看评论内容"、或提供PR URL询问评论问题时触发。自动获取评论、分析有效性、辅助修复并线程式回复。支持仓库缓存、工作区保护、批量修复。
GitCode API 帮助技能。当用户提到 GitCode API、需要查询 GitCode API 用法、参数说明、端点信息，或需要调用 GitCode 平台接口时，自动触发此技能。支持按关键词、API 端点、功能分类检索相关 API 文档，并提供详细的参数说明和代码示例。此技能也可被其他技能调用，用于获取 GitCode API 信息。
| name | gitcode-release |
| description | GitCode 平台发行版（Release）自动创建技能。当用户提到"创建发行版"、"发布 Release"、"打 Tag 发布"、"创建 GitCode Release"、"新建发行版"、"发版"时触发。自动分析本地 Git 仓库信息，推断版本号，生成发行版描述，创建 Tag 和 Release。必须提供 GitCode Token。 |
基于本地 Git 仓库信息，自动在 GitCode 平台创建发行版（Release）。自动推断版本号，根据合入修改生成发行版描述。
| 参数 | 说明 | 必填 | 示例 |
|---|---|---|---|
| GitCode Token | 个人访问令牌 | 是 | your-token |
| 本地仓库路径 | Git 仓库目录 | 否* | /home/user/myproject |
| 指定版本号 | 手动指定 tag 版本号（跳过自动推断） | 否 | v2.1.0 |
| 目标分支 | tag 打在哪个分支/commit 上 | 否 | main |
*注：不提供则使用当前工作目录。
执行中需记录以下变量：
| 变量名 | 说明 | 示例 |
|---|---|---|
REPO_DIR | 本地仓库绝对路径 | /home/user/myproject |
OWNER | 仓库所有者 | xieyutian |
REPO | 仓库名称 | xyt_commander |
ACCESS_TOKEN | GitCode Token | your-token |
LATEST_TAG | 最新的已有 tag | v2.0.0 |
NEW_TAG | 推断/确认的新 tag | v2.1.0 |
TARGET_COMMITISH | 目标分支或 commit | main |
RELEASE_BODY_FILE | 发行版描述临时文件路径 | /tmp/release_body.md |
目的：从本地 Git 仓库自动获取 owner/repo。
执行操作：
确认当前目录是 Git 仓库（或使用用户提供的路径）
git -C "$REPO_DIR" rev-parse --is-inside-work-tree
获取 remote URL 并解析 owner/repo
git -C "$REPO_DIR" remote -v
从 remote URL 解析 owner/repo，支持以下格式：
git@gitcode.com:<owner>/<repo>.git → owner, repohttps://gitcode.com/<owner>/<repo>.git → owner, repohttps://gitcode.com/<owner>/<repo> → owner, repo如果不是 gitcode.com 的仓库，询问用户确认 owner/repo
更新远程引用和 Tags（必须先 fetch，避免本地分支/tag 过期导致误判和 git log 报错）：
git -C "$REPO_DIR" fetch origin --tags
确认分支状态：
git -C "$REPO_DIR" branch --show-current
git -C "$REPO_DIR" status --short
如果有未提交修改，提醒用户（发行版基于 commit 创建，不影响工作区，但建议在干净状态下操作）
检查目标分支与当前分支的同步状态时，必须使用远程跟踪分支（origin/<branch>），而非本地分支名，因为本地分支可能过期：
# 正确：使用远程跟踪分支对比
git -C "$REPO_DIR" log origin/main..origin/dev --oneline --no-merges
# 错误：本地 main 可能长期未更新，导致误判
# git log main..dev ← 不要这样做
目的：收集版本历史信息，用于推断新版本号。
获取已有 Tags：
python3 "<技能目录>/scripts/create_release.py" "$ACCESS_TOKEN" "$OWNER" "$REPO" --get-tags
获取最新 Release：
python3 "<技能目录>/scripts/create_release.py" "$ACCESS_TOKEN" "$OWNER" "$REPO" --get-latest-release
收集自上个 tag 以来的 commit 历史（如果存在上个 tag）：
# 简要 commit 列表
git -C "$REPO_DIR" log "$LATEST_TAG"..HEAD --oneline --no-merges
# 带 PR 信息的 merge commit
git -C "$REPO_DIR" log "$LATEST_TAG"..HEAD --merges --oneline
# 完整 commit 信息（含作者）
git -C "$REPO_DIR" log "$LATEST_TAG"..HEAD --format="%h %s (%an)" --no-merges
# 变更统计
git -C "$REPO_DIR" diff "$LATEST_TAG"..HEAD --stat
首个 tag（无历史 tag）时，收集最近的 commit：
git -C "$REPO_DIR" log --oneline --no-merges -30
git -C "$REPO_DIR" log --format="%h %s (%an)" --no-merges -30
目的：基于 conventional commits 前缀自动推断新版本号。
推断规则：
| 条件 | 版本升级 | 示例 |
|---|---|---|
包含 BREAKING CHANGE 或 !: 前缀 | major | v1.0.0 → v2.0.0 |
包含 feat: 或 feature: 前缀 | minor | v1.0.0 → v1.1.0 |
仅 fix: 及其他 | patch | v1.0.0 → v1.0.1 |
| 无历史 tag | 首个版本 | v1.0.0 |
版本号解析：
(\d+)\.(\d+)\.(\d+)v1.2.3、1.2.3、release-1.2.3 格式latest、stable）v 前缀或不加）展示推断结果：
当前最新 Tag: v2.0.0
推荐新版本号: v2.1.0
推断理由: 检测到新功能添加（feat:），建议 minor 版本升级
Commit 分析:
- feat: 3 个（新功能）
- fix: 5 个（修复）
- refactor: 2 个（重构）
- docs: 1 个（文档）
询问用户：
目的：基于 git log 生成发行版描述，展示完整信息供用户一次性确认，然后创建。
3.1 生成发行版描述
Claude 参考 release-template.md 模板，将收集到的 commit 信息按以下规则分类整理：
feat:, fix:），保留描述内容https://gitcode.com/{owner}/{repo}/compare/{上个tag}...{新tag}3.2 展示确认信息并询问用户
一次性展示完整信息：
发行版创建确认:
Tag 名称: v2.1.0
发行版标题: v2.1.0 - 新增用户认证功能
目标分支: main
发行版描述:
(预览生成的描述内容)
用户可以：
3.3 用户确认后执行
将描述写入临时文件（使用 Write 工具，不用 shell heredoc）
调用创建 API：
python3 "<技能目录>/scripts/create_release.py" "$ACCESS_TOKEN" "$OWNER" "$REPO" \
--create-release \
--tag-name "$NEW_TAG" \
--name "{发行版标题}" \
--body-file "$RELEASE_BODY_FILE" \
--target-commitish "$TARGET_COMMITISH"
创建成功后清理临时文件
目的：确认发行版已成功创建。
python3 "<技能目录>/scripts/create_release.py" "$ACCESS_TOKEN" "$OWNER" "$REPO" \
--get-release --tag "$NEW_TAG"
展示结果：
创建失败处理：
如果创建 API 返回错误，根据错误类型采取不同策略：
git push origin --delete <tag> 删除后重试，或直接基于该 Tag 重新创建 Release从 tag 列表中筛选符合 semver 格式的 tag：
1. 遍历所有 tags
2. 使用正则 r'(\d+)\.(\d+)\.(\d+)' 匹配
3. 找出版本号最大的 tag 作为 latest
4. 保留前缀（v 或无前缀）
优先级: BREAKING CHANGE > feat > fix
遍历所有新 commit:
- 消息含 "BREAKING CHANGE" 或匹配 "^\w+!:" → has_breaking = True
- 前缀为 "feat:" 或 "feature:" → has_feat = True
- 其他前缀 → has_fix = True
if has_breaking: major 升级
elif has_feat: minor 升级
else: patch 升级
v1.0.0v1.0.0--get-tags 检查，提示用户git fetch origin --tags，同步远程分支和 Tags，避免本地过期导致误判或 git log 报错.git 后缀的有无v 前缀的 semver 格式，与历史 tag 保持一致# 获取全部 Tags（自动翻页）
python3 scripts/create_release.py <token> <owner> <repo> --get-tags
# 获取最新 Release
python3 scripts/create_release.py <token> <owner> <repo> --get-latest-release
# 获取指定 Tag 的 Release
python3 scripts/create_release.py <token> <owner> <repo> --get-release --tag v1.0.0
# 获取全部 Releases（自动翻页）
python3 scripts/create_release.py <token> <owner> <repo> --get-releases
# 创建发行版
python3 scripts/create_release.py <token> <owner> <repo> \
--create-release \
--tag-name "v1.0.0" \
--name "v1.0.0 - 首个版本" \
--body-file release_body.md \
--target-commitish "main"
# 使用环境变量
export GITCODE_TOKEN="<token>"
export REPO_OWNER="<owner>"
export REPO_NAME="<repo>"
python3 scripts/create_release.py --get-tags
# JSON 输出
python3 scripts/create_release.py <token> <owner> <repo> --get-tags --json
| 文件 | 用途 |
|---|---|
| release-template.md | 发行版描述模板和分类规则 |
| examples.md | 完整使用示例 |