用途
该技能面向需要在 GitHub 仓库中创建、维护、审查或调试 GitHub Agentic Workflows（GH-AW）的场景。它覆盖仓库初始化、新工作流编写、工作流修订、从其他仓库安装工作流、安全审查以及失败调试等任务类型。
主要能力
- 识别仓库状态：检查 .github/workflows/、.github/agents/、现有 .lock.yml 文件以及 gh aw 使用情况；可运行 node skills/github-agentic-workflows/scripts/find-gh-aw-targets.mjs . 辅助定位目标。
- 工作流编写与修订：以 .github/workflows/<workflow-name>.md 为唯一源文件，使用 assets/workflow.template.md 作为基础模板，选择最小可行的触发面和仓库角色范围。
- 安全与权限控制：默认 permissions: read-only；优先使用 safe-outputs: 处理评论、issue、标签、PR、代理分配和编排；在安全输出工作流中，无操作时指示代理调用 noop。
- 引擎与网络配置：默认 engine: copilot；实验性多提供商路由可用 engine: pi；Copilot SDK 模式用 copilot-sdk: true；第三方引擎（cursor、kiro、aider、crush、opencode）可通过 gh aw add 导入。网络配置遵循最小权限，优先使用 node、python、github 等生态标识符。
- 验证、编译与执行：使用 gh aw fix --write、gh aw validate --strict、gh aw compile --verbose、gh aw run <workflow> --dry-run、gh aw trial ./.github/workflows/<workflow>.md 等命令。
- 运维与改进：使用 gh aw status、gh aw logs、gh aw audit、gh aw health 审查状态、失败、成本、工具使用和成功趋势。
使用方式
- 识别仓库状态，运行 gh aw version 确认 CLI 行为。
- 选择工作模式：仓库设置、新工作流编写、工作流修订、从其他仓库安装、安全审查或失败调试。
- 编写或修订工作流源文件，保持源文件为 .github/workflows/<workflow-name>.md。
- 配置仓库前置条件与认证：运行 gh aw init；用 gh aw secrets bootstrap 或 gh aw secrets set 配置引擎密钥；Copilot 引擎使用 COPILOT_GITHUB_TOKEN 或 copilot-requests Actions 权限。
- 验证、编译并执行：先 gh aw validate --strict，再 gh aw compile，提交 .md 源文件和生成的 .lock.yml 文件。
- 运维与改进：审查工作流是否可简化、拆分或转为共享组件。
适用场景
- 在仓库中创建或维护代理式工作流。
- 对工作流进行安全审查，配置安全输出、网络策略、认证、锁定和威胁检测。
- 调试工作流编译、安装、认证、安全输出执行或工具访问失败。
- 为定时报告、issue 或 PR 分诊、编排、代理交接等任务寻找起始模式。
限制
- 若任务仅涉及标准确定性 GitHub Actions YAML 而不含代理式 Markdown 工作流，该技能不适用。
- 不要依赖 ${{ steps.<id>.outputs.* }} 占位符到达代理可见的 Markdown 正文；如需运行时值，应在确定性设置步骤中写入本地文件并让代理读取。
- 在矩阵中调用可复用 GH-AW worker 时，不要保留默认共享工作流级并发组，应设置显式并发组键。
- 若严格模式和已安装 CLI 拒绝工作流仍需的自定义域名，应预取外部源并传入本地文件，而非放宽防火墙。
- 若编译器行为与文档不符，应以已安装的 gh aw 版本为准。
- 具体收费、价格、平台支持范围等事实暂未提供。