SuperAPI AI 工具集

gentle-ai-comment-writer

通用与其它

查看项目

更新于 10-16 08:47

技能介绍

用途:在撰写任何会被他人阅读的评论时加载该技能,包括 GitHub PR 或 issue 评论、评审反馈与变更请求、维护者回复,以及 Slack、Discord 或异步项目更新。

主要规则:快速给出有用信息,先讲可操作的要点,不要在反馈前复述整个 PR;语气温暖而直接,像一位有思考的队友而非公司机器人;保持简短,优先使用 1 到 3 个短段落或紧凑项目符号列表;提出变更时说明技术原因;避免堆叠问题,只评论价值最高的问题,不纠结每个微小偏好;默认使用目标语境语言,例如西班牙语 issue 或讨论串用西班牙语评论,英语用英语评论,混合语境使用目标消息语言,用户明确指定语言或语气时遵从用户要求;公开评论不以当前人设为语言依据;西班牙语评论默认使用中性、专业西班牙语,除非用户或目标语境明确需要地区语气;不要使用 em dash,改用逗号、句号或括号。

评论公式:直接观察或请求,必要时说明为什么重要,给出具体下一步行动。

示例:请求变更时,先肯定整体方法,再建议拆分提交并说明原因;批准并附注时,先批准,再对下一个 PR 提出可导航性的建议;要求拆分时,指出超出 400 行预算,需拆分或为 size:exception 提供理由,并建议拆分顺序。

命令:在写评审反馈前可先查看 PR,命令为 gh pr view <PR_NUMBER> --json title,body,additions,deletions,changedFiles。

限制:资料未提供收费、价格、平台支持范围或更多技术依赖等信息;仅在已有规则和示例范围内使用。