SuperAPI AI 工具集

github-workflow-standards

办公与效率

查看项目

更新于 10-16 05:03

技能介绍

用途:这是一套供 GitHub 工作流相关智能体共同遵循的核心标准,规定身份认证、仓库发现、智能默认、并行执行、结果呈现与安全规则,目标是让 AI 助手像高效工程队友一样主动工作,减少用户往返确认。

主要能力:

  1. 认证与上下文:调用 github_get_me 识别登录用户并在会话内缓存用户名;从 .git/config 或 package.json 推断工作区默认仓库。认证失败时通过命令面板执行 GitHub: Sign In,或点击 Accounts 图标。
  2. 智能默认与推断:无仓库时跨全部可访问仓库搜索;“此仓库”则按工作区推断;未指定时间范围默认最近 30 天并说明;结果为空自动放宽条件并告知;结果超过 50 条自动按最近收窄并建议过滤条件。
  3. 仓库发现:从 .github/agents/preferences.md 读取 repos.discovery 配置,支持 all(默认)、starred、owned、configured、workspace 五种模式,并应用 include/exclude、repo overrides 与 defaults;可按 track.issues、pull_requests、discussions、releases、security、ci 精细控制跟踪内容。
  4. 跨仓库智能:识别跨仓库引用、关联条目、去重、按仓库分组。
  5. 并行执行:可并行发起 issues、PR、讨论、安全告警、CI 状态、发布检查等查询,全部完成后才计算优先级。
  6. 双格式输出:每份文档同时生成同名 .md 与 .html。HTML 以屏幕阅读器优先,要求跳转链接、地标角色、严格标题层级、描述性链接文本、带 caption 和 scope 的表格、不依赖颜色与表情的状态标注、可交互复选框、aria-live 实时区域、WCAG 2.1 AA 对比度与可见焦点样式,并内置共享样式块与深色模式、减少动效支持。
  7. 输出质量:先给摘要行再列表格;GitHub 问题、PR、文件、评论均须为可点击链接;任务后给出下一步建议;识别热门、停滞、需关注、关联条目并排序;支持 triage、批量回复、sweep 等批处理;分页每批 10 条并先询问,不静默截断。

使用方式:作为社区访问类技能,需在支持该技能的环境中加载,供 GitHub 工作流智能体引用;偏好通过 .github/agents/preferences.md 配置。

限制:发送评论、修改状态等操作必须预览并结构化确认;破坏性操作须明确二次确认;不得泄露令牌;遇到 403/429 应告知重置时间;资料未提供计费、平台支持范围与安装方式等信息。