用途
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+ 标准库,无外部依赖。
第一轮:生成草稿
- 解析并调用脚本:从用户消息中解析 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",提示用户错误信息并结束。
-
读取脚本输出:脚本将 JSON 输出保存到文件 <SKILL_ROOT>/output_{owner}{repo}{number}.json,同时向 stderr 输出执行进度和提醒信息。使用 Read 工具读取该 JSON 文件并解析。
-
若已有人回复:若 status == "already_replied",提示「该 Issue 已有其他人回复,已跳过」,流程结束。
-
发送 Label(可选):若 JSON 中 label_needed == true:
python <SKILL_ROOT>/scripts/post_comment.py --issue-url "<Issue URL>" --body "/label add triage-review"
若失败可忽略,不影响后续流程。
- 生成回复草稿: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。
- 展示给维护者:展示 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 "<临时文件路径>"
流程示例
完整正常流程:
- 用户:回复这个 issue https://gitcode.com/owner/repo/issues/42
- 解析 Issue URL → 执行 prepare_issue_reply.py
- 读取 JSON → status=ok, label_needed=true
- 执行 post_comment.py 打 triage-review 标签
- 生成 draft_reply → 会话状态 send_confirmed=false
- 展示草稿 + 提醒语「审阅后请说「发送」或「回复」以发布评论,说「取消」则结束本次操作。」(第一轮结束)
- 用户:把第二段改温和一点
- 修改 draft_reply → 更新会话中的草稿 → 展示修改后的草稿 + 提醒语(仍为未确认发送状态)
- 用户:发送
- 触发第二轮 → 视为 send_confirmed=true
- 取修改后的 draft_reply 写入临时文件
- 执行 post_comment.py --body-file "<临时文件>" 发送回复正文
- 反馈发送成功结果
取消流程:
- 用户:回复这个 issue https://gitcode.com/owner/repo/issues/42
- 生成草稿并展示 + 提醒语
- 用户:取消
- 提示「已取消本次 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 官方文档。