用途:从已有的 Agent Skill 目录生成 GitHub Agent 文件,产出 Copilot Chat 可调用的 IDE 智能体,或可自动运行的 CI/CD 工作流智能体。
主要能力与两种类型:IDE/UI Agent 由人在 Copilot Chat 中触发,生成 .agent.md 与 .prompt.md,可用 /slug 斜杠命令调用;CI/CD Smart Failure 由 GitHub Actions 事件触发,生成 .agent.md 与 .yml runner,通过 Kill Switch 短语加 grep 使构建失败,当前可用;CI/CD Official 使用官方 Agentic Workflow 格式,生成 .md 与编译后的 .lock.yml,需 gh aw compile,属 2026 年 2 月技术预览。
使用方式:需先收集目标 Skill 路径、所需 Agent 类型,以及(CI/CD 或两者时)触发事件:pull_request、push、schedule、issues、release,workflow_dispatch 始终包含。随后运行 scaffold_agentic_workflow.py,按模式选择: --mode ide 生成 .github/skills/name.agent.md 与 .github/prompts/name.prompt.md; --mode cicd 生成 .agent.md 与 .github/workflows/name-agent.yml,官方格式则为 .md 与 .lock.yml; --mode both 生成全部文件。 可选参数:--format smart-failure(默认)或 official;--triggers 指定附加事件;--kill-switch "PHRASE" 自定义失败短语(默认 CRITICAL FAILURE: SKILL_NAME)。脚本会解析 Skill 的 YAML frontmatter,提取名称与描述,并在仓库根 .github/ 下生成文件。
限制与注意:IDE 的 .agent.md 仅为起始骨架,复杂工作流需手工移植完整指令并添加 handoffs。Smart Failure 需在仓库设置中配置 COPILOT_GITHUB_TOKEN 密钥,Kill Switch 短语必须逐字出现在 .agent.md 指令中,且需明确定义升级触发分类。官方格式需安装 gh extension install github/gh-aw 并运行 gh aw compile,提交 .md 与 .lock.yml,可能需预览权限。使用后可运行 create-github-action 添加 CI/CD 钩子,或运行 audit-plugin 校验 YAML。