Issue AI Agent 是一款 AI 驱动的 GitHub Issue 分诊 Action，用于自动完成 Issue 的分类、打标签与回复。
用途
当有人在你的仓库中打开一个 Issue 时，Issue AI Agent 会自动执行以下处理流程：
- 将 Issue 分类为某一类别（bug、feature、question、docs、duplicate、invalid、security）
- 为其打上匹配的标签，并确定优先级（critical、high、medium、low）
- 通过搜索已有 Issue 来检测重复项，并链接潜在匹配的 Issue
- 发送一条带上下文的评论——例如 bug 会被询问复现步骤，feature 会收到确认等
- 处理后续评论，针对用户评论回复相关信息
以上整个流程约在 8 秒内完成，由你所选择的 LLM 驱动。
使用方式
第 1 步：添加 workflow 文件
在仓库中创建 .github/workflows/issue-ai.yml。
第 2 步：添加 API 密钥
进入 Settings > Secrets and variables > Actions > New repository secret：
- Name：
ANTHROPIC_API_KEY - Value：你的 Anthropic API key（可在 console.anthropic.com 获取）
第 3 步：打开一个 Issue
完成上述步骤后，机器人会自动对新 Issue 进行分类、打标签并回复。
支持的 API
机器人支持任意 Anthropic 或 OpenAI API。使用三个输入项——<provider>-api-key、llm-provider 和 llm-base-url——来匹配你的配置。
自定义 API 端点
如果你的服务商提供 Anthropic 或 OpenAI 兼容 API，可将 llm-base-url 指向其地址。
自定义模型
如果使用自定义模型，可在仓库中创建 .github/issue-ai.yml 来指定。该文件也用于自定义行为。机器人开箱即用，具备合理默认值，无需配置文件。
配置参考
提供 Action Inputs 与 Outputs 配置项。至少需要设置一个 API key。如果两者都未设置，机器人将以开发模式运行并使用模拟响应。
关键设计决策
- 无状态——不使用数据库；从各仓库的
.github/issue-ai.yml读取配置 - 错误可恢复——每个流程步骤各自捕获错误，因此分类失败不会阻塞回复
- 安全优先——输入净化（零宽字符、控制字符、长度限制）+ 在提示词中显式标记不可信数据
适用场景
适用于希望自动管理 GitHub Issue 的仓库维护者，可减少人工分类、打标签、去重和初步回复的工作量。用户只需添加 workflow 文件并配置 API key，即可在新 Issue 创建时自动触发处理。
