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
- 参考文档agents/openai.yaml101 B
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
writing-great-skills
出色编写和编辑技能的参考资料——让技能具备可预测性的词汇与原则。
teach
在此工作区内向用户教授新的技能或概念。
handoff
将当前对话压缩成交接文档,以便另一个智能体接手。
grilling
围绕计划、决策或想法对用户进行不留情面的深度追问。当用户想对自己的思路进行压力测试,或使用任何“深度追问”触发措辞时使用。
grill-me
通过不留情面的深度追问打磨计划或设计。
obsidian-vault
使用 wikilink 和索引笔记搜索、创建和管理 Obsidian 仓库中的笔记。当用户想要在 Obsidian 中查找、创建或整理笔记时使用。