SuperAPI AI 工具集

gh-discuss

通用与其它

查看项目

更新于 10-16 00:02

技能介绍

用途:对 /gh-discuss NUMBER 形式的请求,读取单个 GitHub Discussion 顶层讨论帖,并在能准确、正面解答时发布一条回复。该技能对仓库和系统严格只读,不写代码、不提交、不建分支或 PR,也不运行任何会改动仓库、issue、discussion、标签或文件的命令;唯一允许的写入是在讨论下发布一条回复评论,且仅在确有必要时。

校验请求:要求恰好一个正整数讨论编号,可带前导 #;从调用中显式的 Repository: OWNER/REPO 行或当前检出目录的 GitHub 远程识别仓库;要求已认证的 gh 会话,能读取仓库并读写 Discussions。

获取讨论:使用 gh api graphql 查询讨论的正文、作者、分类和现有评论,例如:gh api graphql -f query='query($owner:String!,$name:String!,$number:Int!){repository(owner:$owner,name:$name){discussion(number:$number){id title body author{login} answerChosenAt comments(first:100){totalCount nodes{id}}}}}' -F owner=OWNER -F name=NAME -F number=NUMBER

停止条件:讨论不存在或无法读取;comments.totalCount 已大于零或 answerChosenAt 已设置(已有回复或已解答,不再添加第二条);讨论正文不是可回答的问题或请求(如公告、投票、无待解决事项的闲聊)。

范围限制:仅讨论自身的标题和正文在回答范围内,不读取或回应其他评论的嵌套回复,只产出对讨论本身的一条顶层回复。

只读研究:仅用读操作调查,如读取当前检出中的文件(无本地副本时可克隆或拉取只读副本,绝不修改)、gh 读命令(gh issue view、gh pr view、gh api 的 GET 类查询)和仓库文档。绝不执行应用代码、构建脚本、测试或任何以改变状态为目的的命令,绝不运行 git commit、git push、git branch、包安装等变更命令。绝不读取仓库之外的内容,不抓取任意外部 URL、其他仓库或无关本地文件;若无法从仓库自身内容与历史中回答,应停止而非另寻他处。仅在仓库内容以合理置信度支持时才作答,不猜测,若确信部分无法解决提问者实际问题则不部分作答。

回复或停止:若无法给出既准确又正面解决问题的答案,则停止且不留任何痕迹,不发布“不知道”的评论。若可以,写出简洁、准确、切题的回复,基于所读仓库内容,不包含大段代码,改为引用文件路径并概述。以单条顶层评论发布:gh api graphql -f query='mutation($discussionId:ID!,$body:String!){addDiscussionComment(input:{discussionId:$discussionId,body:$body}){comment{id}}}' -F discussionId=DISCUSSION_ID -F body="..."。发布后停止,不标记已解答、不改分类或做其他操作。

报告结果:明确说明是否发布了回复或未改动讨论及原因;若已发布,附讨论 URL 和答案简短摘要。