测试编写者

文档 社区

技能解读

当前原文的自动摘译,尚未人工审校。

PRD 即故事集

故事是唯一载体:PRD 主体是按逻辑排列的用户故事。 故事自包含:每张卡含业务逻辑、用户可见行为(页面/状态/文案)、边界、验收标准。 叙事逻辑高于一切:先建宏观"用户旅程地图/业务主流程",再把故事串在主线上。 视觉对齐必须:涉及 UI 的故事必须用 ASCII 线框图画静态布局;Mermaid 画动态行为(流程/状态/时序)。两者互补。示例见 references/ui-wireframe-examples.md、references/mermaid-examples.md。

测试用例铁律(本 skill 新增核心,最容易写错,逐条记牢)

测的是"实现/接入正确性",不评模型能力或主观质量(总纲)。一切取舍由此推导。 一条用例 = 一个原子验证点:禁止打包;禁止写成"测什么"的叙述;禁止写成"任务包";禁止造"读配置自动生成用例"的通用框架(已验证是打地鼠)。 必须落地真实代码:写用例前先读死相关代码,每条断言标 代码依据 文件:行;断言里出现的字段必须能在代码里 grep 到,grep 不到=自创字段=禁止写入。 任务类用例必须写"明确的任务",禁止泛化: ❌ 反例:「测一个长任务」「跑个复杂任务看能不能用」——这不是用例。

二、交互模型

一问一答一确认:拿到答案先用自己的话复述确认("我理解您是…对吗?"),无误再下一步。 严禁自作主张:不猜测、不补用户未明确提供的信息。 讨论 vs 生成:最终生成指令前,回复都简短对话式、以澄清确认为目的,不输出大段未确认文档。 显式暴露假设与风险:缺失/冲突/风险主动指出、记录、征求确认。 全程大白话中文:术语当场翻译或不用(术语表见末尾「附录 A」)。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
文档
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@yunshu0909 · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
需要 · Vendor-specific
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
阶段 0 · 需求确认

产出三件并经用户确认:① 一句话目标 ② in-scope / out-of-scope 列表 ③ 验收点。三者齐备才进阶段 1。

02
阶段 1 · 自主读代码(写任何文档前的硬前置)

grep 关键词来源:阶段 0 的每个验收点 / in-scope 功能词(不依赖下游产物,无循环)。 列出 `文件:函数` 入口清单(grep 根目录 = 项目代码仓根,不确定就问用户一次)。 二值判据(自包含):阶段 0 的每个验收点都能在代码里指到承接它的 `文件:行`;指不到 = 没读够,禁止进阶段 2。 无现存代码退路(全新功能/无代码库):显式标 `纯新建-无现存代码`,产出「待建模块清单」(每个验收点 → 计划落点文件名)替代"指到行",并在 PRD/用例的代码依据处标 `待建:<计划文件>` 而非伪造行号;此时仍可进阶段 2。 边界:读死代码是为让 PRD/用例落地真实行为;不评估"代码能不能跑/有没有实现"(实现状态归 PRD 模板「发布门禁/实现状态」节,不进测试用例文档)。

03
阶段 2 · PRD 故事讨论与定稿

引导梳理用户旅程/业务主流程,划分阶段,单点确认阶段地图(话术:"这几个阶段:1…2…3…作为讨论地图,可以吗?")。确认后用 Mermaid 画核心用户操作流,再快速确认。 按阶段顺序逐个故事讨论,系统提问填满 `assets/prd-template.md` 所有模块;故事颗粒度/深度参照 `references/example-us01.md`(这是 PRD 侧的合格样板锚,与测试用例侧 `test-case-example.md` 对称);务必补齐字段业务定义、状态枚举、计算公式、用户可见文案、依赖关系;异常/失败/降级路径必须与 Happy Path 一并梳理。提问 checklist:每个故事至少问到 前置/Happy Path/异常降级/状态枚举/计算公式/可见文案/依赖/容量边界 八组。 UI 故事:业务逻辑确认后、验收标准前,必须走 ASCII 线框图绘制确认(能力参考 `references/ui-wireframe-examples.md`)。

04
阶段 3 · 测试用例讨论与定稿

先对齐颗粒度:先按 `references/test-case-example.md` 给用户一条写到底的样板用例(普通原子 1 条 + 任务类 1 条),确认结构/颗粒度,再批量。 按 `assets/test-cases-template.md` 组织:`§0 全局约定` + `§0.5 阶段编排`(资格地基→连通→能力→复杂长链路,前阶段全过才进下一;安全贯穿)+ 模块分组 + 末尾「别家怎么减」。 逐条原子用例写满 13 字段(见「附录 B」),每条带 `代码依据 文件:行`。 任务类用例严格按理念 #8:写明确任务名、轮数、每一轮发什么内容(原文)、每一轮期望什么结果;长链路任务的 verbatim prompt 写进该用例「测试数据」字段,含轮数规则(一轮的可观测信号、最少/最多轮、超轮归类 client)与独立复跑防作弊。 用原子点枚举法列全本家用例:`{每条链路} × {每个相关行为/能力} × {失败五类适用项}`,逐项落一条 TC,避免漏。

05
阶段 4 · 双 HTML(套模板)

PRD-MD → 套 `assets/prd-review.html.tmpl`;测试用例-MD → 套 `assets/test-cases-review.html.tmpl`。 生成后必须跑 `references/html-fill-spec.md` 的 MD↔HTML 1:1 校验算法;FAIL(任何字段/步骤/整节被删或压缩)不得交付,补齐重校。

06
阶段 5 · 对抗校核

按 `references/adversarial-review-prompts.md`,开 ≥3 个无共享上下文 sub-agent(代码对账 / 覆盖完整性 / 可执行性+证据诚实性),结构化输出。 主 agent 汇总:共识 must-fix(AI 能修的:行号笔误/格式/HTML 压缩 先修);人决策项(代码语义争议/范围/取舍/诚实性 单独暴露,不替用户决)。 校核挑不出设计矛盾、只剩笔误,才算这版稳。

07
阶段 6 · 冻结与版本管理

用户确认后,在两份 MD 头部状态行标 `Frozen + 日期 + commit`。 输出可粘贴到项目 `docs/PRD_REGISTRY.md` 的总集行(见「附录 C」)。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。