用途:当用户要求创建 issue、报告 bug、提出功能需求或跟踪工作时使用,用于为 mckinsey/agents-at-scale-ark 生成经过调研、以问题为中心的 GitHub Issue。采用调研优先流程,禁止跳过步骤。
主要能力与流程:第一步先澄清问题,通过 AskUserQuestion 收集问题细节、受影响人群与严重程度、复现方式(bug)、动机或触发点(功能)、紧急程度或截止时间、已知约束;在用户回答前不进入下一步。第二步调研代码库,用 Grep、Glob、Read 和 Explore agent 找到相关文件、模块与组件,理解当前行为与架构,界定影响范围,记录文件路径与代码引用,调研结论用于 Context 段而非规定实现方案。第三 步查重与依赖检查,用 gh search issues 和 gh issue list 在主仓库检索;若涉及 marketplace(可观测性、社区服务、Phoenix、Langfuse、可选服务集成等),也要检索并在必要时调研 mckinsey/agents-at-scale-marketplace 代码库;存在重复则告知用户并给出链接而不新建。第四步按模板起草:Problem、Context、Impact、Related Issues、Testing Approach。第五步将完整草稿(标题加正文)展示给用户并询问是否修改,获得批准后才创建。第六步创建,命令为 gh issue create --repo mckinsey/agents-at-scale-ark --title "<type>: <concise problem description>" --body ... --label "needs grooming",标题须使用 feat、fix、docs、chore、refactor 等约定式前缀。
规则与限制:始终先提问澄清;聚焦问题而非解决方案,除非用户明确要求,不提出设计、实现方式或具体代码改动;调研只用于界定范围,不得变成规定性实施步骤;避免无依据的具体化;每个 issue 必须包含代码库调研结果与测试思路;必须查重;统一添加 needs grooming 标签;有关系 issue 应作为依赖或引用标注。具体支持的命令参数与仓库权限等细节,资料未提供。