jw-testing

将开发交接信息整理成测试人员能够独立执行、结果能够追溯的转测文档。 模板与状态规则迁自原 agent_teams 设计文档实践，独立于 jw-design 的设计生命周期。

撰写步骤

1. 阅读关联设计、当前 spec、实际代码改动、开发计划和已有测试证据。 分清计划行为、已实现范围、接口占位和已知缺陷；不以代码合并或方案批准推断测试通过。
2. 明确转测范围、排除项、目标版本、测试环境、依赖服务与数据准备、执行入口和验收依据。 缺失的关键信息标为待确认，并说明影响；不编造环境、负责人、命令、结果或签字。
3. 使用 testing.md 编写文档。 按范围组织功能、边界、异常、兼容与必要的非功能场景，每项说明前置条件、操作步骤与可观察预期。 用例关联设计或 spec 的具体行为，不用“功能正常”等笼统表述替代判据。
4. 单独记录计划用例和实际执行结果；已有证据注明环境、版本、命令或报告入口及适用边界。 未执行、失败、阻塞分别说明；通过率等统计只根据实际执行记录计算。
5. 整理缺陷、严重程度、影响用例、风险、遗留与测试交接条件。 原因分析和修复过程引用 jw-dev 的 bugfix 记忆，避免复制维护两份故障档案。
6. 按 testing-lifecycle.md 记录真实评审与测试进展。 仅要求撰写时交付草稿和待确认项，不自动推进到已测试或已验收。

验证依据与重验条件

按 行为证据 整理受影响的模型/用户可见结果、真实入口、 副作用和必要负向用例；已有快照仅是证据的一层，不以工具成功文本替代最终状态。 测试计划与实际执行分开，记录对应候选、依赖/环境、适用范围及改变哪些前提后需要重验。 复用旧报告时核对其版本与场景，尚未核实写待重验；本节不自动执行测试或扩大外部调用权限。

转测依据的资料版本、可信程度和因果链断点按 上下文与覆盖口径 表达。 用例/资料已整理与测试已执行分别记录；待核实或待重验的场景不计入已验证范围，指出所缺入口、环境或消费者证据。

存放与标识

• 默认输出 .agents/agent-docs/designs/testing/<关联设计目录名>/testing.md，附件放同目录 assets/。 新设计使用 D-YYYYMMDD-HHMM-<slug>，Asia/Singapore、精确到分钟；旧 SDD 标识继续有效。
• 转测文档的 id、design-id 引用关联设计，slug 与目录主题一致。 没有关联设计时优先遵循用户指定位置，以 feature / spec 作为依据，明确关联设计缺失，不虚构设计编号。
• 复用已有转测文档并记录迭代，不覆盖无关资料；不因模板更新重命名旧资料。
• 该输出目录目前被 Git 忽略，仅本地保存；本 skill 的规则和模板正常入库。 不自动恢复目录跟踪，不将转测文档加入设计索引，不重新引入设计阶段的 testing 状态。

阶段交接

从 jw-dev 接收实际实现范围、变更版本、验证记录、限制与风险；可按现有资料独立撰写转测文档。 交付文档路径、用例范围、执行准备、证据、待确认项与当前状态。 用户要求执行测试时另按授权和仓库环境执行，只更新实际覆盖的结果； 不自动调用外部服务、提交文件、创建 PR 或写入审批结论，不运行格式化或静态检查。

文档元数据与索引

遵循 作者、设计关联与索引规则：受管文档以 frontmatter 标注 Git author，移除 owner；新 F 平铺在 features/，F/B 显式声明 designs。 写作/修改后自动运行文档同步工具刷新索引；检视只报告缺口，不改写待审资料。