如何向 gh-aw 提 Issue 与贡献代码社区支持渠道与协作规范全指南【免费下载链接】gh-awGitHub Agentic Workflows项目地址: https://gitcode.com/GitHub_Trending/gha/gh-awGitHub Agentic Workflows简称gh-aw是 GitHub 官方开源的 CLI 扩展可将自然语言 Markdown 工作流编译为可运行的 GitHub Actions让你在 CI 中安全地运行 AI Agent。想向它报告 Bug、提交功能建议或参与贡献别急——这个项目采用了一套独特的Agentic Plan智能体计划协作模式社区成员不直接提交 Pull Request而是在 Issue 中撰写详细的实施计划由核心团队的编码智能体代为实现。本指南将带你快速掌握这条协作路径与全部支持渠道。一、gh-aw 是什么30 秒了解项目在贡献之前先确认你了解这个项目的定位特性说明形态GitHub CLI 扩展gh extension install github/gh-aw核心功能将 Markdown 工作流YAML frontmatter 自然语言正文编译为.lock.ymlActions 工作流定位为需要推理、调查、内容生成的任务提供 AI Agent 自动化与确定性 Actions 互补许可MIT 开源协议项目由 GitHub Next 团队开发维护官方资料可参考 CONTRIBUTING.md、DEVGUIDE.md 和 SUPPORT.md。二、社区支持渠道4 个官方入口遇到问题时按以下优先级选择求助渠道GitHub Issues— 报告 Bug、提交功能请求的首选渠道。提 Issue 前请先搜索现有 Issue避免重复。GitHub Discussions— 用于提问、交流想法和获取公告。GitHub Next Discord— 加入#continuous-ai频道实时交流适合使用类问题。安全漏洞— ⚠️切勿在公开 Issue、Discussion 或 PR 中报告安全漏洞请通过协调披露渠道发送邮件至opensource-securitygithub.com规范详见 SECURITY.md。三、核心协作模式Agentic Plan 流程重点这是 gh-aw 最独特的贡献机制与传统开源项目完全不同非核心团队成员不能直接创建 Pull Request。你的角色是计划作者核心团队成员是执行者。整个流程分 4 步第 1 步用智能体做深度分析提 Bug 时必做提交 Bug 报告前先用你的编码智能体扫描源码、定位根因、研究类似案例并提出修复方案。没有分析或调研支撑的 Bug 报告很可能被忽略。第 2 步在 Issue 中提交详细的 Agentic Plan一份高质量的计划应包含想贡献什么Bug 根因分析 / 功能使用场景与预期行为智能体的分析结论完整的分步实施计划具体到文件路径、函数名、校验规则、测试用例明确的验收标准什么状态算完成按 标签规范 添加标签类型、优先级、组件第 3 步与团队讨论并打磨计划核心团队会评审你的计划可能追问细节、建议调整达成一致后成员会标记接手。第 4 步核心团队用智能体实现并提交 PR核心成员将你的计划交给 Copilot 等编码智能体执行——它会遵循 代码组织规范、校验架构 等既有模式运行make agent-finish全套质量检查构建、测试、Lint、格式化后提交 PR。✍️ 提高计划被采纳率的 4 个技巧官方统计数据发现成功合并的 PR 对应任务描述平均约 151 词而被关闭的 PR 平均约 229 词——简洁且具体是关键做法说明✅ 保持简洁控制在 200 词左右聚焦单一目标✅ 点名具体文件/子系统如pkg/workflow、cmd/gh-aw而非抽象描述✅ 写明验收标准如为 X 添加覆盖测试、CLI 标志可被解析和校验❌ 避免纯探索式描述去调查一下这个问题这类无具体目标的措辞降低合并率四、调试工作流失败先自查再报告如果你的 Agent 工作流运行失败官方建议先用智能体做调试再带着报告提 Issue。可参考仓库内的调试技能 .github/aw/debug-agentic-workflow.md让智能体自动完成失败原因分析、缺失工具定位和配置修复建议。下图展示了项目自身 CI 故障的智能体调查 Issue 示例——根因分析、失败详情、修复建议一应俱全这正是高质量 Bug 报告的样子五、代码质量规范速览写计划前值得了解即使你不写代码了解这些规范也能让计划更精准错误信息三要素[出了什么问题]. [期望是什么]. [示例]所有校验错误均遵循此模板文件组织偏好多个小文件而非大文件按功能而非类型分组CLI 破坏性变更删除/重命名命令或标志、改变 JSON 输出结构需走major变更集规则见 scratchpad/breaking-cli-rules.md依赖许可仅接受 MIT、Apache-2.0、BSD、ISC 等宽松许可GPL/AGPL/SSPL 均不允许测试完整测试指南见 scratchpad/testing.md常用命令make test-unit快速单测、make test全量、make agent-finish提交前完整校验六、常见问题 FAQQ我可以 fork 仓库并提 PR 吗A非核心成员请直接提 Issue不要创建 PR。你的计划会被核心团队拾取并由智能体实现。Q需要本地搭建 Go/Node 开发环境吗A社区贡献者无需本地开发环境——项目本身要求核心开发在 Dev Container 或 GitHub Codespaces 中进行而你只需产出高质量计划。QIssue 应该打哪些标签A至少一个类型标签bug/enhancement/documentation/question/testing紧急问题加priority-high并可选组件标签cli/workflow/mcp/actions/engine。注意ai-generated、plan等自动化标签请勿手动添加。完整规范见 scratchpad/labels.md。Q提了 Issue 后没人理怎么办A计划质量直接影响处理速度。补充更具体的实施细节、验收标准和复现步骤通常能显著提升优先级。七、快速行动清单 搜索现有 Issue确认问题未被重复提交用智能体完成源码分析与根因定位撰写 200 词左右的 Agentic Plan点名具体文件写明验收标准按标签规范打标签提交 Issue关注团队反馈持续打磨计划等待核心成员用智能体实现并合并 gh-aw 的协作哲学是描述你想要什么而不是怎么构建它——这份高质量的计划文化保证了每一条社区贡献都能经过同样的自动化质量关卡。祝你第一次贡献顺利【免费下载链接】gh-awGitHub Agentic Workflows项目地址: https://gitcode.com/GitHub_Trending/gha/gh-aw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
