mcpField
A
agentic-workflows

agentic-workflows

github.com/githubAgent 工作流5.5k67 次安装今天更新
代码仓库

关于 agentic-workflows

用于设计、创建、更新、调试或升级 GitHub Agentic Workflows 的分发技能,会选择对应指南,也可加载仓库专属说明。

主要功能

  1. 01将任务分派至专门工作流指南
  2. 02支持工作流设计与维护
  3. 03加载可选的仓库说明
  4. 04选择特定的调试参考

适用场景

  1. 01创建 GitHub Agentic Workflow
  2. 02调试工作流运行或故障
  3. 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。仅在任务需要时加载部署文档、操作员参考或规范。

评论

支持 Markdown