Agentic Workflows 路由器 是做什么的?
当用户要求在此仓库中设计、创建、更新、调试或升级 GitHub Agentic Workflows 时,请使用此技能。
此技能是一个调度器:识别任务类型,加载匹配的工作流提示/技能文件,并直接遵循它。保持回复简洁,如果正确的提示不明确,请提出一个澄清性问题。
对于需要进行 CLI 设置或运行 URL 作用域限定的调试会话,请首先加载
https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/debug-bootstrap.md;它引导了调试路径使用的相同共享策略。
调试、事件、健康和与失败相关的优化请求,即使在安装 CLI 的情况下,也应使用引导程序的意图路由,然后再使用通用更新、升级或优化路由。保留提供的引导仓库/引用,用于所有调试链接和公共原始回退;以下显示 main 的 URL 仅在未提供引导修订时作为默认值。重复使用已加载的指南。意图索引是 .github/aw/debug-scenarios.md;仅加载选定的专门路由,而不是每个调试参考资料。
仓库覆盖(可选):
- 如果存在,在匹配的提示/技能之后加载目标仓库的
.github/aw/instructions.md。仅在匹配的检出中使用@.github/aw/instructions.md;不要替换引导仓库覆盖。 - 优先级:当发生冲突时,仓库覆盖指令将覆盖上游默认值。
只读取你需要的文件:
仅在本地引导检出的仓库/引用与请求的引导匹配时使用它;否则使用已解析的引导仓库/引用(默认 github/gh-aw)。
如果 GitHub API、gh api 或 GitHub MCP 下载返回 HTTP 403(包括令牌 SAML 授权给了不同组织的情况),请不要使用同一令牌重试。改从 https://raw.githubusercontent.com/github/gh-aw/main/<path> 无需认证地获取公共文件,同时保留其相对于仓库的路径(包括 .github/)。例如:curl --fail --silent --show-error --location 'https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/create-agentic-workflow.md'。对引用的指令和 SKILL.md 文件也使用相同的回退;切勿向原始 URL 发送 Authorization 标头或令牌。如果公共下载失败,报告该错误,而不是在缺少必需指令的情况下继续执行。此回退仅适用于公共的 github/gh-aw 内容,不适用于私有或企业仓库。
.github/aw/action-container-substitutions.md.github/aw/agent-runtime-instructions.md.github/aw/agentic-chat.md.github/aw/agentic-workflows-mcp.md.github/aw/analyzing-runs.md.github/aw/asciicharts.md.github/aw/campaign.md.github/aw/charts-trending.md.github/aw/charts.md.github/aw/cli-commands.md.github/aw/compat.md.github/aw/configure-agentic-engine.md.github/aw/context.md.github/aw/create-agentic-workflow-trigger-details.md.github/aw/create-agentic-workflow.md.github/aw/create-shared-agentic-workflow.md.github/aw/debug-agentic-workflow.md.github/aw/debug-bootstrap.md.github/aw/debug-compilation.md.github/aw/debug-live-testing.md.github/aw/debug-model-engine-misconfiguration.md.github/aw/debug-playbook.md.github/aw/debug-scenarios.md.github/aw/debug-security-review.md.github/aw/debug-workflow-evidence.md.github/aw/debug-workflow-health.md.github/aw/dependabot.md.github/aw/deployment-status.md.github/aw/designer-mappings.md.github/aw/designer.md.github/aw/doctor.md.github/aw/documentation-workflows.md.github/aw/dreaming.md.github/aw/drive-memory.md.github/aw/enclaves.md.github/aw/evals.md.github/aw/experiments.md.github/aw/formal-methods.md.github/aw/github-agentic-workflows.md.github/aw/github-mcp-server-pagination.md.github/aw/github-mcp-server-tools.md.github/aw/github-mcp-server.md.github/aw/harbor.md.github/aw/index-search.md.github/aw/instructions.md.github/aw/intent.md.github/aw/jobs.md.github/aw/ledger.md.github/aw/linter-workflows.md.github/aw/llms.md.github/aw/loop.md.github/aw/lsp.md.github/aw/maintainer.md.github/aw/mcp-clis.md.github/aw/memory-stateful-patterns.md.github/aw/memory.md.github/aw/messages.md.github/aw/multi-agent-research.md.github/aw/network.md.github/aw/optimize-agentic-workflow.md.github/aw/otel.md.github/aw/patterns.md.github/aw/playwright.md.github/aw/pr-reviewer.md.github/aw/release-workflow.md.github/aw/report.md.github/aw/reuse.md.github/aw/safe-outputs-automation.md.github/aw/safe-outputs-content.md.github/aw/safe-outputs-management.md.github/aw/safe-outputs-runtime.md.github/aw/safe-outputs.md.github/aw/serena-tool.md.github/aw/shared-safe-jobs.md.github/aw/skills.md.github/aw/subagents.md.github/aw/syntax-agentic.md.github/aw/syntax-checkout.md.github/aw/syntax-core.md.github/aw/syntax-engine.md.github/aw/syntax-tools-imports.md.github/aw/syntax.md.github/aw/test-coverage.md.github/aw/test-expression.md.github/aw/token-optimization-caching-budgets.md.github/aw/token-optimization-observability.md.github/aw/token-optimization.md.github/aw/triggers.md.github/aw/update-agentic-workflow.md.github/aw/upgrade-agentic-workflows.md.github/aw/visual-regression.md.github/aw/work-queue.md.github/aw/workflow-constraints.md.github/aw/workflow-editing.md.github/aw/workflow-patterns.md
加载匹配的工作流提示或技能后,直接遵循它:
- 从头开始通过访谈设计工作流:
.github/aw/designer.md - 创建新的工作流:
.github/aw/create-agentic-workflow.md - 配置或添加声明式引擎:
.github/aw/configure-agentic-engine.md - 更新现有工作流:
.github/aw/update-agentic-workflow.md - 诊断、修补、审计或主动调试工作流:
.github/aw/debug-agentic-workflow.md(本地优先策略,证据分类和实时门控) - 分析现有运行、日志或重复故障:
.github/aw/analyzing-runs.md。整个仓库范围的调试或优化请求从此处开始,先进行故障聚类,再选择工作流。 - AWF 模型/端点 400 错误、静默跨家族子代理故障、
model: auto故障、版本锁定后安装步骤 404 错误,或关于版本字段的问题:在建议更改模型之前,直接转到.github/aw/debug-agentic-workflow.md#model-and-engine-misconfiguration。 - 升级工作流并修复弃用:
.github/aw/upgrade-agentic-workflows.md - 创建共享组件或 MCP 封装器:
.github/aw/create-shared-agentic-workflow.md - 创建生成报告的工作流:
.github/aw/report.md - 修复 Dependabot 清单 PR:
.github/aw/dependabot.md - 分析覆盖率工作流:
.github/aw/test-coverage.md - 渲染紧凑的标记图表:
.github/aw/asciicharts.md - 将 CLI 命令映射到 MCP 用法:
.github/aw/cli-commands.md - 选择工作流架构和模式:
.github/aw/patterns.md - 设计、部署、检查或恢复基于 Git 的工作队列:
.github/aw/work-queue.md - 优化 token 使用和成本:
.github/aw/token-optimization.md - 高级成本控制(没有本地设置时,按服务器大小或共享组织预算策略自定义 AIC 限额):阅读
docs/src/content/docs/reference/cost-management.md#configure-advanced-cost-controls-with-admission(已发布指南)。解释外部权限要求和协作限制;不要虚构 frontmatter 字段或承诺硬上限、预留或运行中取消。 - 设计长时间运行的多代理研究工作流:
.github/aw/multi-agent-research.md - 添加用户请求的技能或代理插件(
skills:/plugins:frontmatter,绝不进行即时安装):.github/aw/skills.md
当任务涉及 OTEL、OTLP、跟踪、可观测性后端或遥测驱动的分析时,在加载匹配的工作流提示或技能之后,还要读取并遵循 skills/otel-queries/SKILL.md。
当创建、更新、诊断或升级使用 tools.work-queue 的工作流时,在主提示之后还要加载 .github/aw/work-queue.md。仅当该任务需要时才加载部署文档、操作员参考或规范。