SuperAPI AI 工具集

gitcode-issue-reply

编程与开发

查看项目

更新于 10-15 17:50

技能介绍

用途

GitCode Issue 回复技能用于对单个 GitCode Issue 生成回复草稿,草稿由维护者审阅后再决定是否发送。它适用于用户明确表达「回复 issue」意图,并提供了唯一 GitCode Issue 链接或 owner/repo#number 的场景。若用户仅提供链接但没有回复意图,则不应使用本技能。

主要能力

  • 解析用户消息中的 GitCode Issue 链接(gitcode.com/.../issues/123)或 owner/repo#number 形式,并拼接为完整 URL。
  • 调用脚本拉取 Issue 内容,并并行执行 DeepWiki 查询与 API 调用。
  • 将脚本输出保存为 JSON 文件,供后续读取与解析。
  • 识别 Issue 是否已有其他人回复,若已有则跳过。
  • 在需要时通过 post_comment.py 为 Issue 添加 triage-review 标签。
  • 依据 prompt_draft_partial 生成回复草稿,并在存在图片时结合图片分析结果。

使用方式

触发条件

须同时满足:用户表达「回复 issue」意图(如「回复这个 issue」「帮回复 issue #123」),且提供唯一的 GitCode Issue 链接或 owner/repo#number。

认证

Token 获取方式按优先级:用户直接提供、从环境变量 GITCODE_TOKEN 读取、使用请求头 PRIVATE-TOKEN: {token}。未配置时,提示用户到 GitCode 个人访问令牌页面创建 Token。

依赖

需要 Python 3.7+ 标准库,无外部依赖。

第一轮:生成草稿

  1. 解析并调用脚本:从用户消息中解析 Issue,若为 owner/repo#number 则拼接为 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",提示用户错误信息并结束。

  1. 读取脚本输出:脚本将 JSON 输出保存到文件 <SKILL_ROOT>/output_{owner}{repo}{number}.json,同时向 stderr 输出执行进度和提醒信息。使用 Read 工具读取该 JSON 文件并解析。

  2. 若已有人回复:若 status == "already_replied",提示「该 Issue 已有其他人回复,已跳过」,流程结束。

  3. 发送 Label(可选):若 JSON 中 label_needed == true:

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

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

  1. 生成回复草稿:JSON 中 prompt_draft_partial 为生成草稿的 prompt。执行顺序(必须按以下步骤执行):
  • 检查关键字段:status 必须为 "ok",否则提示错误并结束;检查 image_urls 是否非空;记录 deepwiki_status;检查 security_warnings 是否存在。
  • 处理图片内容(如 image_urls 非空,此步骤为强制):使用 Read 工具查看每张图片(优先使用 image_local_paths),记录图片关键信息(报错、配置、日志等),将图片分析结果纳入回复生成。
  • 生成草稿:将 prompt_draft_partial 作为 prompt,结合 Issue 内容、DeepWiki 内容与图片分析结果(如有图片),去除首尾空白及「回复:」前缀,即为 draft_reply。
  1. 展示给维护者:展示 draft_reply(仅供审阅与修改,尚未发送;可在会话中维护,用户修改后更新);如 image_urls 非空,简要说明图片内容;若 deepwiki_status 不为 "ok",告知用户知识库查询未成功;若 security_warnings 非空,提示用户检测到敏感信息。必须展示提醒语:「审阅后请说「发送」或「回复」以发布评论,说「取消」则结束本次操作。」第一轮结束后视为未确认发送(send_confirmed=false);第一轮必须在此结束,不得在本轮调用 post_comment 发送回复正文。

第二轮:确认发送

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

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

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

发送:短文本(无换行、无引号)执行:

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 "<临时文件路径>"

流程示例

完整正常流程:

  1. 用户:回复这个 issue https://gitcode.com/owner/repo/issues/42
  2. 解析 Issue URL → 执行 prepare_issue_reply.py
  3. 读取 JSON → status=ok, label_needed=true
  4. 执行 post_comment.py 打 triage-review 标签
  5. 生成 draft_reply → 会话状态 send_confirmed=false
  6. 展示草稿 + 提醒语「审阅后请说「发送」或「回复」以发布评论,说「取消」则结束本次操作。」(第一轮结束)
  7. 用户:把第二段改温和一点
  8. 修改 draft_reply → 更新会话中的草稿 → 展示修改后的草稿 + 提醒语(仍为未确认发送状态)
  9. 用户:发送
  10. 触发第二轮 → 视为 send_confirmed=true
  11. 取修改后的 draft_reply 写入临时文件
  12. 执行 post_comment.py --body-file "<临时文件>" 发送回复正文
  13. 反馈发送成功结果

取消流程:

  1. 用户:回复这个 issue https://gitcode.com/owner/repo/issues/42
  2. 生成草稿并展示 + 提醒语
  3. 用户:取消
  4. 提示「已取消本次 Issue 回复操作」,流程结束,不发送回复评论

适用场景

  • 维护者需要针对单个 GitCode Issue 起草回复,并希望在发布前人工审阅与修改。
  • Issue 中包含报错截图、配置界面、日志等图片信息,需要结合图片内容理解问题。
  • 需要结合项目背景信息(通过 DeepWiki 查询)辅助生成回复。
  • 需要为 Issue 添加 triage-review 标签以便分流。

限制与约定

  • 禁止在用户未明确表达发送意图前发送回复正文。仅当用户后续消息中出现「发送」「回复」「发出去」「就按这个回复」等明确发送意图时,才可调用 post_comment.py 发送回复内容;第一轮生成草稿后不得在同一轮或未经用户确认即发送回复评论;用户说「取消」时不得发送。
  • 除 prepare_issue_reply.py、post_comment.py 外,不生成、不执行其他脚本。
  • 发评论统一用 post_comment.py。
  • 临时文件不得写入 SKILL_ROOT 目录。
  • 参考:Prompt 模板 references/prompts/draft_reply.txt;GitCode API 官方文档。