qa

用途

qa 是一个面向 Web 应用的系统化 QA 测试技能，核心目标是在浏览器中测试 Web 应用，并对发现的缺陷进行修复。它同时提供健康评分，覆盖 8 个类别。资料中未提供该技能具体由哪些文件、工具或运行环境实现，暂未提供更多实现细节。

主要能力

• 四种测试模式：diff-aware（在功能分支上自动触发）、full（系统性探索）、quick（30 秒冒烟测试）、regression（与基线对比）。
• 原子化（atomic）缺陷修复工作流，并配套回归测试。
• 跨 8 个类别的健康评分。资料未列出这 8 个类别的具体名称，暂未提供。

使用方式

技能文档要求在开始前先运行一段初始化脚本（preamble），用于：检查更新、创建并清理会话目录、读取贡献者与主动建议配置、输出当前分支、读取 telemetry 配置与提示状态、写入技能使用记录。资料中给出的是完整命令代码，应原样保留。

其中关键环境行为：若 PROACTIVE 为 "false"，不主动建议 gstack 技能，仅当用户明确要求时调用。

文档还要求：若输出 UPGRADE_AVAILABLE，则读取升级说明并按内联升级流程处理；若输出 JUST_UPGRADED，则告知用户版本并继续。首次使用时会介绍 Completeness Principle，并可选在浏览器中打开说明文章；随后会询问遥测（telemetry）设置，可选 community、anonymous 或 off 三档，该询问仅发生一次。

技能还定义了 AskUserQuestion 的固定格式（重新交代上下文、用通俗语言简化说明、给出推荐与 Completeness 评分、列出选项），以及完成状态协议（DONE、DONE_WITH_CONCERNS、BLOCKED、NEEDS_CONTEXT）与升级（Escalation）流程。

工作流约定

• 搜索优先（Search Before Building）：在构建基础设施或不确定的模式前先搜索；WebSearch 不可用时跳过并注明。
• 完整性原则（Boil the Lake）：AI 使完整性的边际成本接近零，因此优先选择完整实现；区分“湖”（可煮沸，如完整测试覆盖、全边界处理）与“海”（超出范围，如重写整个系统）。
• 仓库所有权模式（Repo Ownership Mode）：根据 REPO_MODE 值（solo / collaborative / unknown）决定对分支外问题默认直接修复还是先询问。
• 贡献者模式（Contributor Mode）：当 _CONTRIB 为 true 时，在使用中评估体验并撰写字段报告，会话最多 3 份。
• 遥测（Telemetry）：工作流结束后记录事件，包含技能名、耗时、结果与会话 ID。
• 计划状态页脚（Plan Status Footer）：在计划模式下调用 ExitPlanMode 前写入或跳过 GSTACK REVIEW REPORT 段。

适用场景

适用于需要对 Web 应用进行系统化 QA、在功能分支上自动验证、快速冒烟检查、与基线做回归对比，并希望在发现缺陷时就地修复并验证的场景。

限制与约束

• 技能运行依赖 gstack 工具链及相关路径（如 ~/.claude/skills/gstack/bin/ 下的可执行文件）与配置文件目录。
• 资料未说明支持的操作系统、浏览器种类、安装步骤或收费模式，暂未提供。
• 资料未列出健康评分的 8 个类别明细、评分算法或阈值，暂未提供。
• 资料未提供缺陷修复与回归测试的具体执行步骤描述，暂未提供。

引用文档

以下为作者声明的引用来源，保留指定版本、署名和许可。

作者的来源声明

• garrytan/gstack/qa/SKILL.md — 署名：Garry Tan；许可：MIT；版本：f4bbfaa5bdfd2d6ce59541c2145432febde57fed。