AGENT SKILL

qa

开展交互式 QA 会话,用户通过对话报告缺陷或事项,智能体则创建 GitHub 事项。后台探索代码库以获取上下文和领域语言。当用户想报告缺陷、执行 QA、通过对话创建事项,或提到“QA 会话”时使用。

License 许可
MIT
最近更新
2026-07-23
Stars
★ 1
Forks
0

01 前言 Front Matter

name
qa
description
开展交互式 QA 会话,用户通过对话报告缺陷或事项,智能体则创建 GitHub 事项。后台探索代码库以获取上下文和领域语言。当用户想报告缺陷、执行 QA、通过对话创建事项,或提到“QA 会话”时使用。

02 资源文件 1

03 SKILL.md 正文

QA 会话

开展交互式 QA 会话。用户描述自己遇到的问题。你负责澄清,通过探索代码库获取上下文,并创建经得起时间考验、以用户为中心且使用项目领域语言的 GitHub 事项。

针对用户提出的每个事项

1. 倾听并进行少量澄清

让用户用自己的话描述问题。提出至多 2–3 个简短的澄清问题,重点关注:

  • 预期情况与实际发生的情况
  • 复现步骤(如果并不明显)
  • 问题是稳定发生还是间歇发生

不得过度访谈。如果描述已经足够清晰,可以创建事项,就继续下一步。

2. 在后台探索代码库

与用户交谈时,在后台启动一个 Agent(subagent_type=Explore)以了解相关区域。目标不是寻找修复方案,而是:

  • 了解该区域使用的领域语言(检查 UBIQUITOUS_LANGUAGE.md)
  • 理解功能应当执行什么操作
  • 识别面向用户的行为边界

这些上下文有助于编写更好的事项——但事项本身不得引用具体文件、行号或内部实现细节。

3. 评估范围:单个事项还是拆分?

创建前,判断这是一个单独事项,还是需要拆分为多个事项。

以下情况需要拆分:

  • 修复跨越多个独立区域(例如“表单验证错误,而且缺少成功消息,并且重定向也发生故障”)
  • 存在可以明确分离、由不同人员并行处理的关注点
  • 用户描述的内容包含多个不同的失败模式或症状

以下情况保留为单个事项:

  • 只有一个位置的一项行为出错
  • 所有症状都由同一根本行为引起

4. 创建 GitHub 事项

使用 gh issue create 创建事项。不得先让用户审阅——直接创建并分享 URL。

事项必须经得起时间考验——即使经过重大重构,也应当仍然有意义。请从用户视角编写。

对于单个事项

使用以下模板:

## 发生了什么

[使用通俗语言描述用户遇到的实际行为]

## 我的预期

[描述预期行为]

## 复现步骤

1. [开发者可以遵循的具体编号步骤]
2. [使用代码库中的领域术语,而不是内部模块名]
3. [包含相关输入、标志或配置]

## 补充上下文

[来自用户或代码库探索、能够帮助说明事项的任何其他观察结果——例如“只有使用 Docker 层时才会发生,文件系统层不会”——使用领域语言,但不要引用文件]

对于拆分(多个事项)

按依赖顺序创建事项(阻塞项优先),以便引用真实事项编号。

每个子事项使用以下模板:

## 父事项

#<parent-issue-number>(如果创建了跟踪事项),否则写“在 QA 会话期间报告”

## 问题所在

[描述这项具体的行为问题——只描述此切片,而不是整份报告]

## 我的预期

[此具体切片的预期行为]

## 复现步骤

1. [仅适用于此事项的步骤]

## 阻塞项

- #<issue-number>(如果必须先解决另一个事项,才能修复此事项)

如果没有阻塞项,则写“无——可以立即开始”。

## 补充上下文

[与此切片相关的任何其他观察结果]

创建拆分时:

  • 宁可创建多个薄事项,也不要创建少量厚事项——每个事项都应当可以独立修复和验证
  • 如实标记阻塞关系——如果事项 B 确实必须在事项 A 修复后才能测试,请明确说明。如果二者相互独立,请都标记为“无——可以立即开始”
  • 按依赖顺序创建事项,以便在“阻塞项”中引用真实事项编号
  • 最大限度提高并行度——目标是让多个人(或智能体)可以同时领取不同事项

所有事项正文的规则

  • 不得包含文件路径或行号——这些信息会过时
  • 使用项目的领域语言(如果 UBIQUITOUS_LANGUAGE.md 存在,请检查)
  • 描述行为,而不是代码——写“同步服务无法应用补丁”,不要写“applyPatch() 在第 42 行抛出异常”
  • 必须提供复现步骤——如果无法确定,请询问用户
  • 保持简洁——开发者应当能在 30 秒内读完事项

创建后,输出所有事项 URL(并概述阻塞关系),然后询问:“继续下一个事项,还是已经完成?”

5. 继续会话

持续进行,直到用户表示完成。每个事项都相互独立——不要批量处理。

04 同仓库更多 Skills