Skills gitcode-issue-reply

Name: gitcode-issue-reply
Author: openclaw

Generate reply drafts for a single GitCode issue with similar-issue references; maintainer reviews before posting. Use when user asks to reply to or comment on an issue and provides a GitCode issue link; do not use when user only wants to fetch or query issue data. 针对单个 GitCode Issue 生成回复草稿（含相似 Issue 参考），维护者审阅后可发送评论；仅当用户要回复或评论且提供链接时使用，仅获取或查询 issue 信息时勿用。Python 3.7+ standard library only.

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/autoxj/gitcode-issue-reply" ~/.claude/skills/openclaw-skills-gitcode-issue-reply && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/autoxj/gitcode-issue-reply" ~/.openclaw/skills/openclaw-skills-gitcode-issue-reply && rm -rf "$T"

manifest: skills/autoxj/gitcode-issue-reply/SKILL.md

GitCode Issue 回复

对单个 GitCode Issue 生成回复草稿与相似 Issue 参考，供维护者审阅后发送。

何时使用（须同时满足）

用户表达**「回复 issue」**意图（如「回复这个 issue」「帮回复 issue #123」）。
用户提供了唯一的 GitCode Issue 链接或
```
owner/repo#number
```
。

仅提供链接但无回复意图时，不要使用本技能。

认证

Token 获取方式（按优先级）：
1. 用户直接提供：用户可在问题中直接提供 token
2. 环境变量：从
```
GITCODE_TOKEN
```
  读取
请求头：使用
```
PRIVATE-TOKEN: {token}
```
未配置时：提示用户到 GitCode 个人访问令牌创建 Token

依赖

Python 3.7+ 标准库（必需，无外部依赖）。

第一轮：生成草稿

1. 解析并调用脚本

从用户消息中解析 Issue：链接（
```
gitcode.com/.../issues/123
```
）或
```
owner/repo#number
```
。若为后者，拼接为完整 URL：
```
https://gitcode.com/owner/repo/issues/number
```
。
SKILL_ROOT：本 SKILL.md 所在目录。

执行（使用脚本绝对路径）：

python <SKILL_ROOT>/scripts/prepare_issue_reply.py --issue-url "<完整 Issue URL>"

脚本执行时间约 30秒–2分钟（DeepWiki 查询与 API 调用并行执行）。
若退出码非 0 或 JSON 中
```
status == "error"
```
，提示用户错误信息并结束。

2. 读取脚本输出

脚本将 JSON 输出保存到文件

<SKILL_ROOT>/output_{owner}_{repo}_{number}.json

（例如

output_Ascend_RecSDK_1079.json

），同时向 stderr 输出执行进度和提醒信息。使用 Read 工具读取该 JSON 文件并解析。

3. 若已有人回复

若

status == "already_replied"

：提示「该 Issue 已有其他人回复，已跳过」，流程结束。

4. 发送 Label（可选）

若 JSON 中

label_needed == true

：

python <SKILL_ROOT>/scripts/post_comment.py --issue-url "<Issue URL>" --body "/label add triage-review"

若失败可忽略，不影响后续流程。

5. 生成回复草稿

JSON 中

prompt_draft_partial

为生成草稿的 prompt，

similar_issues

为 BM25 检索到的相似 Issue 编号列表。

执行顺序（必须按以下步骤执行）：

检查关键字段
- status: 必须为 "ok"，否则提示错误并结束
- image_urls: 检查是否非空
- deepwiki_status: 记录状态
- security_warnings: 检查是否存在
处理图片内容（如 image_urls 非空，此步骤为强制）
- 使用 Read 工具查看每张图片（优先使用 image_local_paths）
- 记录图片关键信息（报错、配置、日志等）
- 将图片分析结果纳入回复生成
- ⚠️ 警告：此步骤不可跳过！图片信息对理解 Issue 至关重要！
生成草稿

详细步骤说明：

检查关键字段
- ```
status
```
  : 必须为
```
"ok"
```
  ，否则提示错误并结束
- ```
image_urls
```
  : 检查是否非空，非空时必须在生成草稿前查看图片
- ```
deepwiki_status
```
  : 若不为
```
"ok"
```
  ，告知用户知识库查询未成功
- ```
security_warnings
```
  : 若非空，提示检测到敏感信息
处理图片内容（如
```
image_urls
```
非空）
- 必须使用多模态能力查看每张图片（URL 在
```
image_urls
```
  中，本地路径在
```
image_local_paths
```
  或 base64 在
```
image_base64_list
```
  ）
- 记录图片中的关键信息（如报错截图、配置界面、日志等）
- 图片信息对于理解 Issue 问题往往至关重要，不要忽略
- 将图片分析结果纳入回复草稿的生成过程
生成草稿
- 将
```
prompt_draft_partial
```
  作为 prompt
- 结合：Issue 内容 + DeepWiki 内容 + 图片分析结果（如有图片）
- 去除首尾空白及「回复：」前缀，即为 draft_reply
展示给维护者
- 拟回复内容（草稿）：展示 draft_reply（仅供审阅与修改，尚未发送；可在会话中维护，用户修改后更新）
- 相似 Issue：从 JSON 的
```
similarity_details
```
  字段获取详细信息（包含
```
number
```
  、
```
score
```
  、
```
title
```
  ），按「#N - 标题（相似度: X.XX）」格式列出可点击链接（owner、repo 从 JSON 的
```
owner
```
  、
```
repo
```
  取），注明「仅供参考，不会加入回复内容」
- 图片分析摘要（如
```
image_urls
```
  非空）：简要说明图片内容，确认已纳入回复考虑
- DeepWiki 状态：若
```
deepwiki_status
```
  不为
```
"ok"
```
  ，告知用户知识库查询未成功，草稿可能缺少项目背景信息
- 安全警告：若
```
security_warnings
```
  非空，提示用户检测到敏感信息（如密钥泄露）
- 必须展示提醒语：「审阅后请说「发送」或「回复」以发布评论，说「取消」则结束本次操作。」
- 会话状态：第一轮结束后视为未确认发送（send_confirmed=false）；仅当用户后续消息中明确说「发送」「回复」「发出去」等时，才可调用 post_comment 发送回复正文
- 第一轮必须在此结束：不得在本轮调用 post_comment 发送回复正文；本轮不发送回复评论

第二轮：确认发送

仅当用户在同一会话的后续消息中明确表达「发送」「回复」「发出去」「就按这个回复」等发送意图时，才可调用 post_comment.py 发送回复正文。未收到上述任一表述前，禁止发送回复评论。

用户说「取消」

若用户在第一轮展示草稿后的后续消息中说「取消」「不发了」「算了」等：提示「已取消本次 Issue 回复操作」，流程结束，不调用 post_comment 发送任何回复内容。

确定发送内容

若用户本条消息包含明确的回复正文（代码块、长段文本），用该内容。
若用户之前在对话中修改过草稿，用最后一次修改后的版本。
否则用第一轮生成的 draft_reply。

发送

确定 Issue URL 与 body 后：

短文本（无换行、无引号）：

python <SKILL_ROOT>/scripts/post_comment.py --issue-url "<URL>" --body "<正文>"

长文本或含特殊字符：先将正文用 Write 工具写入临时文件（写入系统临时目录或工作区目录，不要写入 SKILL_ROOT），再：
```
python <SKILL_ROOT>/scripts/post_comment.py --issue-url "<URL>" --body-file "<临时文件路径>"
```

流程示例

完整正常流程

用户：回复这个 issue https://gitcode.com/owner/repo/issues/42
  → 解析 Issue URL → 执行 prepare_issue_reply.py
  → 读取 JSON → status=ok, label_needed=true, similar_issues=[38, 25]
  → 执行 post_comment.py 打 triage-review 标签
  → 生成 draft_reply → 会话状态 send_confirmed=false
  → 展示草稿 + 相似 Issue + 提醒语「审阅后请说「发送」或「回复」以发布评论，说「取消」则结束本次操作。」（第一轮结束）

用户：把第二段改温和一点
  → 修改 draft_reply → 更新会话中的草稿
  → 展示修改后的草稿 + 提醒语（仍为未确认发送状态）

用户：发送
  → 触发第二轮 → 视为 send_confirmed=true
  → 取修改后的 draft_reply 写入临时文件
  → 执行 post_comment.py --body-file "<临时文件>" 发送回复正文
  → 反馈发送成功结果

取消流程

用户：回复这个 issue https://gitcode.com/owner/repo/issues/42
  → 生成草稿并展示 + 提醒语

用户：取消
  → 提示「已取消本次 Issue 回复操作」，流程结束，不发送回复评论

禁止与约定

禁止在用户未明确表达发送意图前发送回复正文：仅当用户后续消息中出现「发送」「回复」「发出去」「就按这个回复」等明确发送意图时，才可调用 post_comment.py 发送回复内容；第一轮生成草稿后不得在同一轮或未经用户确认即发送回复评论；用户说「取消」时不得发送。
除 prepare_issue_reply.py、post_comment.py 外，不生成、不执行其他脚本。
发评论统一用 post_comment.py。
临时文件不得写入 SKILL_ROOT 目录。

参考

Prompt 模板：
```
references/prompts/draft_reply.txt
```
。
GitCode API：官方文档。

历史版本

v1.2.0 (2026-03-15)

🚀 修复 DeepWiki 返回未空的问题

v1.1.0 (2026-03-15)

🔄 重构为通过 MCP 客户端访问 DeepWiki，移除 requests 依赖，改用标准库 urllib

v1.0.0 (2026-03-11)

🎉 初始版本发布
💬 支持生成回复草稿与相似 Issue 参考