ai-workflows 是一套可复用的 GitHub Actions 工作流集合，通过 AI Agent 实现 Issue 分类、代码审查、CI 修复、多仓库编排等自动化任务，让开发团队从繁琐的维护工作中解放出来。

ai-workflows：让 AI Agent 24/7 自动管理你的代码仓库\n\n## 开源维护的痛点与自动化解决方案\n\n开源项目的维护工作往往比想象中更加繁琐。Issue 堆积如山、PR 审查耗时、CI 失败需要手动修复、代码质量逐渐退化……这些重复性工作占据了维护者大量时间，却难以找到足够的人手分担。ai-workflows 项目正是为解决这一痛点而生——它提供了一套可复用的 AI Agent 工作流，能够 7×24 小时自动运行，处理从 Issue 分类到代码清理的各类维护任务。\n\n## 项目概览：15+ 自动化工作流\n\nai-workflows 目前包含 15 个精心设计的 GitHub Actions 工作流，覆盖了开源项目维护的方方面面：\n\n### Issue 管理工作流\n\nissue-triage：当新 Issue 创建时自动触发，负责分类、去重和打标签。通过 AI 分析 Issue 内容，自动分配合适的标签，并检测是否与现有 Issue 重复。\n\nissue-resolver：针对简单、范围明确的 Issue，自动创建草稿 PR 尝试解决。这大大加速了小问题从报告到修复的周期。\n\nissue-sweeper：每周一早上 6 点运行，扫描所有开放的 Issue，评论进展更新，并关闭已解决的问题。\n\nissue-hygiene：每周一早上 7 点运行，检测重复 Issue、链接已合并的 PR、标记陈旧的 Issue。\n\n### 代码质量工作流\n\nclaude-review：在 PR 打开或同步时触发，由 AI 审查代码质量、安全性和最佳实践。相当于为每个 PR 配备了一位不知疲倦的代码审查员。\n\ncode-simplifier：每天凌晨 4 点运行，强制执行 DRY 原则（Don't Repeat Yourself），移除死代码，并创建草稿 PR。\n\nbest-practices：每周三凌晨 3 点运行，进行全面的最佳实践审计，生成可执行的建议报告。\n\nfinal-pr-review：在 PR 审查时触发，作为合并前的最终审查关卡。\n\n### CI 与测试工作流\n\nci-fix：当 CI 失败时触发，分析失败的日志并推送修复（每个 PR 最多尝试 2 次）。这解决了"CI 红了但没人有空修"的常见问题。\n\npost-merge-tests：在代码合并后触发，分析合并的代码并创建包含针对性测试的草稿 PR。\n\npost-merge-docs-review：在代码合并后触发，审查文档是否需要更新，并创建修复 PR。\n\n### 项目管理工作流\n\nnext-steps：每天凌晨 5 点运行，分析合并势头，建议下一步逻辑行动。帮助维护者把握项目节奏。\n\nproject-router：在 Issue/PR 事件触发时运行，将项目智能路由到 GitHub Projects 并自动分配字段。\n\nrepo-orchestrator：按需运行，作为多仓库工作流的中心调度器，实现"中心辐射式"的仓库管理。\n\nlabel-sync：按需运行，将规范标签从 .github 仓库同步到所有目标仓库。\n\n## 快速接入：极简的集成方式\n\nai-workflows 的设计理念是"消费者仓库只需编写极简的调用文件"。以 Issue 分类为例，消费者仓库只需创建如下文件：\n\nyaml\n# .github/workflows/issue-triage.yml\nname: Issue Triage\non:\n issues:\n types: [opened]\npermissions:\n contents: read\n id-token: write\n issues: write\njobs:\n triage:\n uses: JacobPEvans/ai-workflows/.github/workflows/issue-triage.yml@v0.3.0\n secrets: inherit\n\n\n仅需 15 行配置，即可为仓库启用 AI 驱动的 Issue 分类能力。对于定时任务，配置同样简洁：\n\nyaml\n# .github/workflows/issue-sweeper.yml\nname: Issue Sweeper\non:\n schedule:\n - cron: \"0 6 * * 1\"\n workflow_dispatch:\npermissions:\n contents: read\n id-token: write\n issues: write\n pull-requests: read\njobs:\n sweep:\n uses: JacobPEvans/ai-workflows/.github/workflows/issue-sweeper.yml@v0.3.0\n secrets: inherit\n\n\n## 认证与成本：零成本起步\n\n所有工作流默认通过 OpenRouter 路由。消费者仓库只需配置两个 Secret：\n\n- OPENROUTER_API_KEY：OpenRouter API 密钥（建议设置每日消费限额）\n- OPENROUTER_BASE_URL：设置为 https://openrouter.ai/api/v1\n\n如果未配置模型变量，工作流会自动回退到 openrouter/free（零成本）。这意味着小型项目可以完全免费使用这些自动化能力。对于需要更高质量模型的项目，也可以通过环境变量配置其他提供商（如 Chutes.ai、Anthropic 直接 API）。\n\n## 架构设计：提示词与脚本的分离\n\nai-workflows 的架构体现了良好的工程实践。项目将提示词文件统一存放在 .github/prompts/ 目录下，每个工作流对应一个提示词文件。脚本则存放在 .github/scripts/ 目录下，按工作流分子目录组织。这种分离使得：\n\n- 提示词可以独立迭代优化，无需修改工作流逻辑\n- 脚本可以复用共享工具（如 render-prompt.sh 提供 envsubst + GITHUB_OUTPUT 功能）\n- 新工作流的开发可以快速基于现有模板进行\n\n## 适用场景与价值\n\nai-workflows 特别适合以下场景：\n\n- 个人开发者：独自维护多个开源项目，没有足够时间处理日常维护工作\n- 小型团队：团队规模有限，希望将人力集中在核心功能开发而非维护工作\n- 大型组织：需要统一管理多个仓库的标签、工作流程和代码质量标准\n\n通过引入 ai-workflows，维护者可以将精力从重复性事务中解放出来，专注于真正有价值的创造性工作。同时，AI 的 7×24 小时不间断工作能力，确保了问题能够被及时响应，不会因为维护者的时区或忙碌而被耽搁。\n\n## 结语：AI 辅助开发的未来\n\nai-workflows 代表了 AI 辅助软件开发的一个重要方向——不是取代开发者，而是承担那些繁琐、重复但必要的维护工作。随着 GitHub Copilot Agentic Workflows 的推出，这类可复用的 AI 工作流将变得越来越重要。ai-workflows 项目已经为此做好了准备，其 Import-ready 的设计让它可以无缝集成到现有的开发流程中。

ai-workflows：让 AI Agent 24/7 自动管理你的代码仓库\n\n开源维护的痛点与自动化解决方案\n\n开源项目的维护工作往往比想象中更加繁琐。Issue 堆积如山、PR 审查耗时、CI 失败需要手动修复、代码质量逐渐退化……这些重复性工作占据了维护者大量时间，却难以找到足够的人手分担。ai-workflows 项目正是为解决这一痛点而生——它提供了一套可复用的 AI Agent 工作流，能够 7×24 小时自动运行，处理从 Issue 分类到代码清理的各类维护任务。\n\n项目概览：15+ 自动化工作流\n\nai-workflows 目前包含 15 个精心设计的 GitHub Actions 工作流，覆盖了开源项目维护的方方面面：\n\nIssue 管理工作流\n\nissue-triage：当新 Issue 创建时自动触发，负责分类、去重和打标签。通过 AI 分析 Issue 内容，自动分配合适的标签，并检测是否与现有 Issue 重复。\n\nissue-resolver：针对简单、范围明确的 Issue，自动创建草稿 PR 尝试解决。这大大加速了小问题从报告到修复的周期。\n\nissue-sweeper：每周一早上 6 点运行，扫描所有开放的 Issue，评论进展更新，并关闭已解决的问题。\n\nissue-hygiene：每周一早上 7 点运行，检测重复 Issue、链接已合并的 PR、标记陈旧的 Issue。\n\n代码质量工作流\n\nclaude-review：在 PR 打开或同步时触发，由 AI 审查代码质量、安全性和最佳实践。相当于为每个 PR 配备了一位不知疲倦的代码审查员。\n\ncode-simplifier：每天凌晨 4 点运行，强制执行 DRY 原则（Don't Repeat Yourself），移除死代码，并创建草稿 PR。\n\nbest-practices：每周三凌晨 3 点运行，进行全面的最佳实践审计，生成可执行的建议报告。\n\nfinal-pr-review：在 PR 审查时触发，作为合并前的最终审查关卡。\n\nCI 与测试工作流\n\nci-fix：当 CI 失败时触发，分析失败的日志并推送修复（每个 PR 最多尝试 2 次）。这解决了"CI 红了但没人有空修"的常见问题。\n\npost-merge-tests：在代码合并后触发，分析合并的代码并创建包含针对性测试的草稿 PR。\n\npost-merge-docs-review：在代码合并后触发，审查文档是否需要更新，并创建修复 PR。\n\n项目管理工作流\n\nnext-steps：每天凌晨 5 点运行，分析合并势头，建议下一步逻辑行动。帮助维护者把握项目节奏。\n\nproject-router：在 Issue/PR 事件触发时运行，将项目智能路由到 GitHub Projects 并自动分配字段。\n\nrepo-orchestrator：按需运行，作为多仓库工作流的中心调度器，实现"中心辐射式"的仓库管理。\n\nlabel-sync：按需运行，将规范标签从 .github 仓库同步到所有目标仓库。\n\n快速接入：极简的集成方式\n\nai-workflows 的设计理念是"消费者仓库只需编写极简的调用文件"。以 Issue 分类为例，消费者仓库只需创建如下文件：\n\nyaml\n.github/workflows/issue-triage.yml\nname: Issue Triage\non:\n issues:\n types: [opened]\npermissions:\n contents: read\n id-token: write\n issues: write\njobs:\n triage:\n uses: JacobPEvans/ai-workflows/.github/workflows/issue-triage.yml@v0.3.0\n secrets: inherit\n\n\n仅需 15 行配置，即可为仓库启用 AI 驱动的 Issue 分类能力。对于定时任务，配置同样简洁：\n\nyaml\n.github/workflows/issue-sweeper.yml\nname: Issue Sweeper\non:\n schedule:\n - cron: \"0 6 * * 1\"\n workflow_dispatch:\npermissions:\n contents: read\n id-token: write\n issues: write\n pull-requests: read\njobs:\n sweep:\n uses: JacobPEvans/ai-workflows/.github/workflows/issue-sweeper.yml@v0.3.0\n secrets: inherit\n\n\n认证与成本：零成本起步\n\n所有工作流默认通过 OpenRouter 路由。消费者仓库只需配置两个 Secret：\n\n- OPENROUTER_API_KEY：OpenRouter API 密钥（建议设置每日消费限额）\n- OPENROUTER_BASE_URL：设置为 https://openrouter.ai/api/v1\n\n如果未配置模型变量，工作流会自动回退到 openrouter/free（零成本）。这意味着小型项目可以完全免费使用这些自动化能力。对于需要更高质量模型的项目，也可以通过环境变量配置其他提供商（如 Chutes.ai、Anthropic 直接 API）。\n\n架构设计：提示词与脚本的分离\n\nai-workflows 的架构体现了良好的工程实践。项目将提示词文件统一存放在 .github/prompts/ 目录下，每个工作流对应一个提示词文件。脚本则存放在 .github/scripts/ 目录下，按工作流分子目录组织。这种分离使得：\n\n- 提示词可以独立迭代优化，无需修改工作流逻辑\n- 脚本可以复用共享工具（如 render-prompt.sh 提供 envsubst + GITHUB_OUTPUT 功能）\n- 新工作流的开发可以快速基于现有模板进行\n\n适用场景与价值\n\nai-workflows 特别适合以下场景：\n\n- 个人开发者：独自维护多个开源项目，没有足够时间处理日常维护工作\n- 小型团队：团队规模有限，希望将人力集中在核心功能开发而非维护工作\n- 大型组织：需要统一管理多个仓库的标签、工作流程和代码质量标准\n\n通过引入 ai-workflows，维护者可以将精力从重复性事务中解放出来，专注于真正有价值的创造性工作。同时，AI 的 7×24 小时不间断工作能力，确保了问题能够被及时响应，不会因为维护者的时区或忙碌而被耽搁。\n\n结语：AI 辅助开发的未来\n\nai-workflows 代表了 AI 辅助软件开发的一个重要方向——不是取代开发者，而是承担那些繁琐、重复但必要的维护工作。随着 GitHub Copilot Agentic Workflows 的推出，这类可复用的 AI 工作流将变得越来越重要。ai-workflows 项目已经为此做好了准备，其 Import-ready 的设计让它可以无缝集成到现有的开发流程中。