SuperAPI AI 工具集

ln-912-community-announcer

通用与其它

查看项目

更新于 10-16 06:23

技能介绍

用途:把发布、破坏性变更、新功能、架构调整或社区动态整理成结构化公告,发布到目标GitHub仓库的Discussions(Announcements分类)。

主要能力:通过community_github_discovery协议获取{owner}/{repo}、repo.id与Announcements分类ID;读取项目策略文档(缺失时用模板)提取公告触发条件与语气指南;读取CHANGELOG.md、README.md,运行git log --oneline -20与git diff --name-only,并阅读最多5个关键变更文件以理解变更原因。随后按类型(Release、Breaking Change、New Features、Architecture、Community)分类并选择公告风格,若最近3条公告风格相同则更换。

写作要素:使用所选风格模板与GitHub Markdown格式,包含What's Next后的Contributors致谢、指向CHANGELOG.md的页脚、破坏性变更的迁移步骤(> [!IMPORTANT]提示)以及结尾互动问题。

事实核查:对草稿中的命令、代码块、文件路径、链接、数量、功能描述和名称逐项核对,不虚构安装或更新命令;并运行humanizer_checklist进行检查,若发现3处以上AI写作模式则重写。

发布方式:先向用户展示标题和正文,等待显式批准后,用GraphQL createDiscussion变更发布,例如gh api graphql -f query='mutation($title: String!, $body: String!, $repoId: ID!, $catId: ID!) { createDiscussion(input: {repositoryId: $repoId, categoryId: $catId, title: $title, body: $body}) { discussion { url } } }' -f title="TITLE_HERE" -f body="BODY_HERE" -f repoId="{repo.id}" -f catId="{categories.Announcements}",随后报告讨论URL。可选交叉发布:如存在版本标签,可gh release create vX.Y.Z --notes "See discussion: URL",或在项目范围变化时更新仓库描述。

限制:需要具备相应权限的GitHub环境与gh CLI;发布前必须获得用户批准;置顶无法通过API完成,需在GitHub界面手动置顶;技能正文未提供收费、价格或平台可用性信息。