About manual-testing
manual-testing is a skill for planning and documenting manual and exploratory testing in real projects. It emphasizes risk-focused execution, traceable evidence, and safe recovery of test data and accounts.
Key features
- 01Time-boxed test charters
- 02Step-by-step execution records
- 03Evidence and status tracking
- 04Data and account recovery checks
- 05Risk-based prioritization
Use cases
- 01Preparing an exploratory test session
- 02Recording test outcomes and evidence
- 03Managing unfinished tests when time is limited
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ naodeng/ awesome-qa-skills --skill manual-testingAfter installing, type/manual-testingin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
output-formats.mdquick-start.mdREADME.mdagents/openai.yamlevals/eval.yamlevals/cases/basic-success.yamldomain-method-regression.yamledge-domain-boundary.yamledge-incomplete-input.yamlevals/fixtures/check_domain_decisions.pycheck-domain-decisions.shdomain-oracle.jsonexamples/README.mdoutput-templates/template-csv.csvtemplate-excel.tsvtemplate-json.jsontemplate-markdown.mdtemplate-word.mdtemplate-xmind.mdprompts/manual-testing.mdreferences/domain-decision-example.mdreferences/local/FAQ.mdscripts/batch_convert_templates.pyconvert_formats.pyconvert_output_formats.pyconvert_to_csv.pyconvert_to_excel.pyconvert_to_json.pyconvert_to_markdown.pyconvert_to_word.pyDetails
From the project README手动/探索性测试(中文版)
英文版: 见对应英文技能。
何时使用
- 需要在真实项目里处理 manual testing 相关任务。
- 需要一份可以直接用于执行、评审或跟进的结果。
执行流程
- 阅读并遵循「按需加载」中的主提示词(覆盖清单、输出结构、质量要求)。
- 只补充真正影响结果的项目上下文:范围、环境、限制、风险、依赖、期望产出。
- 信息不全时先给可用初版,并显式标出假设与信息缺口。
- 默认 Markdown;用户指定其他格式时再切换。
领域执行要点
- 为每个时间盒建立 charter:任务/风险、环境/构建、数据、探索范围、截止和证据;执行既定路径与探索新问题分别记账,不自行扩展授权。
- 步骤记录 前置状态→动作→预期→实际→证据 ID→状态;未启动为 NOT_RUN,中断为 INCOMPLETE,环境阻断为 BLOCKED,不把清单当完成记录。
- 先准备可恢复数据与检查点,结束按项目规则恢复账户、订单和配置并核对残留;未授权删除不能当清理捷径。
- 时间不足先完成关键风险闭环并保存未完成项、负责人和恢复入口;报告只覆盖真实观察,未知预期仍待确认。
核心约束
- 按风险/业务影响排优先级,不要平均摊铺。
- 把「已确认事实」和「当前假设」分开写。
- 不要编造用户未提供的接口、字段、环境或根因细节。
- 结果必须可执行:场景具体、有优先级、能指导下一步。
按需加载
-
校准领域结果、正确对照或证据缺口时,读取 references/domain-decision-example.md 的脱敏输入、逐项预期与复算依据。
-
产出前必须阅读并遵循
prompts/manual-testing.md(最低覆盖清单、输出结构、质量要求)。 -
需要 Excel/CSV/JSON/Word 等格式时:读
output-formats.md,并按用户格式要求输出。 -
需要套用现成模板时:读
output-templates/中匹配的模板,不要自创冲突结构。 -
用户要示例或对标现有资产时:读
examples/中相关样例。 -
需要框架规范、排障、报告 schema 等深资料时:只读
references/里与当前问题相关的文件,不要整目录通读。 -
需要格式转换或辅助校验时:优先使用
scripts/中已有脚本,而不是重写一遍。 -
需要评测/回归本 skill 时:使用
evals/,并用 skill-up 校验与运行。 -
用户只要最短上手路径时:读
quick-start.md。
交付前自检
- 已遵循主提示词的输出结构
- 最低覆盖关注:范围、核心路径、环境和账号准备、正向检查、异常检查、边界检查、探索性重点、需要收集的证据…(细节以主提示词为准)
- 已覆盖最低清单,或标明为何省略
- 高风险项有明确优先级
- 未编造用户未提供的细节
- 假设与信息缺口已标明
常见误区
- 范围和上下文都不清楚时,不要假装已经完整可用。
- 不要把所有项写成同等重要。
- 不要跳过假设与信息缺口。
- 不要输出大段与当前工具链无关的空泛理论。