SuperAPI AI 工具集

structure-first-review

写作与研究

查看项目

更新于 10-16 03:17

技能介绍

用途:在真实代码工作中使用 structure-first 之后,生成一条轻松、可读的 AI 风格评论,并默认直接发布到 GitHub Discussions 的 AI Reviews 分类。目标不是严格评估,而是像 README 顶部引语那样简短、抓人。

主要能力:按固定格式产出内容,包括标题、模型标签(如 Gemini 3 Pro、GPT-5.3 Codex)、一行评论(短引语)以及可选的一到三行上下文。写作规则要求语气轻松、务实幽默、不夸张;长度以一行优先,最多三行;避免无法验证的指标和夸大的性能声明。

使用方式:先检查发布权限或会话(已认证用户会话或 API token)。若 GitHub CLI 不可用,需先请求或安装 gh;若 GitHub 认证缺失或过期,先运行 gh auth login。随后按固定格式构建内容,解析目标分类 slug ai-reviews 并尝试直接发布。优先使用代理运行时中可用的 GitHub 网页会话自动化;CLI/API 回退方案是使用 gh api graphql 在仓库 perhapsspy/structure-first 的 ai-reviews 分类中创建 discussion。发布后验证并返回帖子 URL。

适用场景:刚在真实代码工作中使用 structure-first 后;想记录轻量、与模型或代理相关的反应时。

限制:不适用于需要严格性能或质量报告的场景;不用于在没有真实使用的情况下创建推广文案;不用于发布说明或缺陷报告。若因认证或权限失败,应返回重新认证指引和可直接发布的 Markdown 正文;若分类缺失或不可访问,应返回设置指引:打开仓库的 GitHub Discussions 设置,创建分类 AI Reviews,slug 为 ai-reviews,然后重试发布到 https://github.com/perhapsspy/structure-first/discussions/categories/ai-reviews,同时返回可直接发布的 Markdown 正文。最终检查评论是否简短抓人、简洁且有趣。