关于 agentic-workflows
用于设计、创建、更新、调试或升级 GitHub Agentic Workflows 的分发技能,会选择对应指南,也可加载仓库专属说明。
主要功能
- 01将任务分派至专门工作流指南
- 02支持工作流设计与维护
- 03加载可选的仓库说明
- 04选择特定的调试参考
适用场景
- 01创建 GitHub Agentic Workflow
- 02调试工作流运行或故障
- 03更新或升级现有工作流
MCP 相关
该技能列出 GitHub MCP 指南,并包含创建共享 MCP 封装的路线;它本身并非 MCP 服务或客户端。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ github/ gh-aw --skill agentic-workflows安装后在 Claude Code 中输入/agentic-workflows确认已加载。
附带文件tests/fixtures.jsontests/test_guidance.py
详细介绍
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文件也使用相同的回退方式;绝不要向 raw 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/documentation-workflows.md.github/aw/drive-memory.md.github/aw/enclaves.md.github/aw/evals.md.github/aw/experiments.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/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/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 错误、静默的跨系列子 Agent 故障、
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 - 渲染精简的 Markdown 图表:
.github/aw/asciicharts.md - 将 CLI 命令映射为 MCP 用法:
.github/aw/cli-commands.md - 选择工作流架构和模式:
.github/aw/patterns.md - 设计、部署、检查或恢复基于 Git 的工作队列:
.github/aw/work-queue.md - 优化令牌用量和成本:
.github/aw/token-optimization.md - 在没有原生设置的情况下进行高级成本控制(按服务规模自定义 AIC 限额,或设置组织共享预算策略):阅读
docs/src/content/docs/reference/cost-management.md#configure-advanced-cost-controls-with-admission(已发布指南)。说明外部授权方要求和协作式限制;不要臆造 frontmatter 字段,也不要承诺硬性上限、预留额度或运行中取消。 - 设计长时间运行的多 Agent 研究工作流:
.github/aw/multi-agent-research.md - 按用户要求添加技能或 Agent 插件(frontmatter 中的
skills:/plugins:,绝不临时安装):.github/aw/skills.md
如果任务涉及 OTEL、OTLP、追踪、可观测性后端或遥测驱动的分析,在加载匹配的工作流提示词或技能后,还要阅读并遵循 skills/otel-queries/SKILL.md。
创建、更新、诊断或升级使用 tools.work-queue 的工作流时,还要在主提示词之后加载 .github/aw/work-queue.md。仅在任务需要时加载部署文档、操作员参考或规范。