quality-engineering · diff

git:20260903.931a322 to git:20260907.991c766

8 added, 43 removed. Audit A to A.

---

name: quality-engineering

description: 约束软件变更、制品、缺陷与发布候选的风险驱动验证、可复核证据、回归判断，以及通过、失败、证据不足或不适用结论。

---

# 质量工程

## 目标

在明确的验收对象、环境和证据边界内形成可复核的独立质量结论。此 Skill 约束质量工程工作如何启动、执行和收束；具体专业判断全部取自 `references/principles.md`。

## 执行协议

1. 确认本专业范围、任务所指产品与工作边界、授权改动、受影响消费者、验证边界和未知项。

2. 阅读 [专业能力准则](references/principles.md) 的能力索引，并完整读取本次实际命中的能力条目。

- 3. 阅读 [项目记忆](references/memory.md) 中本次命中的核心主题，依“项目记忆”章的定位规则唯一确认当前产品根目录与 `product-id` 后，再读取 `<当前产品根目录>/docs/product-studio/<product-id>/quality-engineering.md` 中与本次工作相关的已有事实；项目记忆只作背景，当前契约、实现与验证证据优先。

+ 3. 依第 2 步判定的命中簇，按“项目记忆”章读取对应的记忆卷与簇事实文件；项目记忆只作背景，当前契约、实现与验证证据优先。

4. 在授权范围内作出、沿用或修复本专业决定前，先区分用户已裁定的目标与政策、当前事实、因果推断和待证假设；用户、编码代理或既有实现给出的具体方案都不以来源自证正确。以受影响完整流程的可确认结果、必要状态与交接、失败恢复、变更扩散和维护成本复核方案；若新证据推翻决定前提，或拟议修复只能依靠新增例外、复制规则或状态、绕过责任边界成立，先重审受影响决定，不在失效决定上叠加局部修补，也不因局部失败推翻无关决定；超出本专业所有权时只报告矛盾、整体影响和待裁决选项。随后依命中准则完成最小充分实现或审查，不规定其他专业能力的选择、先后或数量。

5. 运行与风险相称的验证并检查最终差异，记录证据能证明与不能证明的范围。

- 6. 最终回复前必须依“项目记忆”章检查本轮新确认、改变或失效的核心认知；任务已允许修改当前产品根目录内的目标文件时直接创建、更新或移除本专业事实册，只有没有符合条件的事实差异时才不触碰。

- ## 输出契约

- - 验收对象、基线、环境与适用标准的明确身份。

- - 风险和覆盖说明、创建或修改的质量资产、实际命令与退出码。

- - 逐项证据、失败归因、残余风险和证据不能证明的边界。

- - `PASS`、`FAIL`、`INCONCLUSIVE` 或 `NOT_APPLICABLE` 总体结论及其失效条件。

- - 项目记忆只保留会持续改变后续验证判断的当前核心认知，不记录本轮质量结论、测试清单或一次性证据。

- ## 完成条件

- - 所有适用的高风险标准均有与当前对象匹配的直接证据或明确阻塞说明。

- - 新增或修改的质量资产已按仓库原生入口运行，结果已实际读取。

- - 总体结论不超出已验证的修订、制品、环境、身份、数据和时间边界。

- - 未覆盖项、既有失败和本轮回归已清楚分离，复核入口可重复执行。

- - 已读取相关项目记忆；核心认知发生变化时，事实册已在授权范围内更新，且未写入源码摘要、任务过程、运行快照和单次结果。

- ## 停止条件

- - 验收标准或权威契约存在会改变预期结果的实质冲突。

- - 必需环境、身份、数据、制品或工具不可得，且替代证据不足以支持结论。

- - 继续操作将触及生产写入、真实用户数据、秘密或其他未获授权的外部状态。

- - 验收对象在取证期间漂移且无法重新固定，既有证据不能继续绑定当前对象。

- ## 权限与边界规则

- - 可在授权范围内读取代码、配置、日志和测试结果，并创建或修改测试、夹具与质量配置。

- - 不把测试通过解释为生产健康、发布授权、产品政策成立或未检查环境可用。

- - 不为其他专业补写其权威契约；输入矛盾时标明影响，不以实现现状降低标准。

- - 不隐匿失败、改写既有测试以迎合实现，或用覆盖率、构建成功和快照数量代替行为证据。

- - 不把被验证契约的正文、测试清单、报告摘要或当前运行结果复制为质量事实；只保存稳定且会改变后续验证判断的证据关系。

- ## 参考资料

- - 专业判断与证据标准：`references/principles.md`

- - 本专业应记住的项目核心认知：`references/memory.md`

+ 6. 按“项目记忆”章维护事实册：核心认知形成证据闭环且预计不受本轮剩余工作影响时，即时写入对应簇的事实文件；最终回复前必须收口对账，检查本轮新确认、改变或失效的核心认知并补录、更新或移除，任务已允许修改当前产品根目录内的目标文件时直接落册，没有符合条件的事实差异才不触碰。

## 项目记忆

- 先唯一确认“当前产品根目录”：它是本次任务所指产品的工作边界，不要求存在 Git 仓库或 `.git`。用户明确指定的产品目录优先；否则根据当前打开的工作区中实际承载目标文件的目录、产品入口与元数据、目标代码、配置和调用链共同判定，Git 根只作可选佐证，不得仅因当前进程工作目录、Git 根或 Skill 所在目录而选根。当 Product Studio 仅作为技能提供者时，不得把它的源码目录、技能文件目录、插件安装目录或缓存目录认作当前产品根目录；只有任务明确以 Product Studio 本身为目标产品时才可使用其目录。无法唯一确认时不读取、创建或修改任何候选事实册。

- - 再确认 `product-id`；它必须在当前产品根目录内唯一、稳定，且是非 `.` 或 `..`、不含 `/` 或 `\` 的安全单级目录名。事实册的唯一位置是 `<当前产品根目录>/docs/product-studio/<product-id>/quality-engineering.md`。读取与写入必须使用以已确认根目录为基准的路径，不得把相对的 `docs/product-studio/<product-id>/quality-engineering.md` 按进程当前目录或 Skill 所在目录解析；归属不唯一或名称不安全时不读取、猜测或创建事实册。

- - 工作前读取 `references/memory.md` 中本次命中的核心主题，再读取 `<当前产品根目录>/docs/product-studio/<product-id>/quality-engineering.md` 中的相关事实；事实册不存在时先以当前产品为准继续工作，待收口检查发现首条应入册事实时再创建，不得因缺少文件跳过最终检查。

+ - 再确认 `product-id`；它必须在当前产品根目录内唯一、稳定，且是非 `.` 或 `..`、不含 `/` 或 `\` 的安全单级目录名。事实册按能力簇分文件存放于 `<当前产品根目录>/docs/product-studio/<product-id>/quality-engineering/`，事实文件名与 `references/principles/` 对应簇卷文件名一致。读取与写入必须使用以已确认根目录为基准的路径，不得把相对的 `docs/product-studio/<product-id>/quality-engineering/` 按进程当前目录或 Skill 所在目录解析；归属不唯一或名称不安全时不读取、猜测或创建事实文件。

+ - 工作前读取 `references/memory/` 下与命中簇卷同名的 `.md` 中本专业应记住的核心认知，再读取 `<当前产品根目录>/docs/product-studio/<product-id>/quality-engineering/` 下与命中簇卷同名的 `.md` 中的相关事实，未命中的簇事实文件不读取；对应事实文件不存在时先以当前产品为准继续工作，待发现首条应入册事实时再创建，不得因缺少文件跳过最终检查。

- 项目记忆仅作上下文；与当前契约、实现、配置或验证证据冲突时，以当前权威为准。

- 以本轮实际核验范围为取材边界，只写入已经由当前代码、配置、契约、调用链或验证证据确认，会持续影响后续判断且难从局部代码直接看清，并属于本专业所有权的项目核心认知；本轮未修改但经当前权威新确认、尚未入册的既有事实同样需要写入，事实候选不以 Git 差异为限；不复制源码、配置或可生成清单。

- - 只读分析、审查或状态查询没有事实册写权限，除非用户明确要求维护记忆；凡任务已允许修改当前产品根目录内的目标文件，维护该根目录下的事实册属于同一写权限，除非用户明确排除。最终回复前必须把符合条件但尚未记录、已经改变或已经失效的事实直接创建、更新或移除，不得只在回复中列出候选，也不得因事实册不存在而跳过；不得因本节扩大当前产品根目录之外的写入范围。

- - 事实册不存在且至少有一条应入册事实时，在当前产品根目录下一并创建 `docs/product-studio/<product-id>/` 与 `quality-engineering.md`；没有事实时不创建空目录或空册。首行固定为 `# quality-engineering 当前产品事实`；每项事实以可检索的稳定业务语义为二级标题，用现在时写清当前事实、成立条件与影响边界，并给出相对于当前产品根目录的权威核验入口和失效或重审条件。

- - 同一认知只保留一处，原位更新或移除旧内容，只保留当前仍成立的事实，不追加历史版本；最后一个主题移除后删除事实册，`<product-id>` 目录为空时一并删除。

+ - 写入时机随证据而定：对会持续影响后续判断的核心认知，形成证据闭环且预计不受本轮剩余工作影响时，即时写入命中簇对应的事实文件，不等收口；证据要到收口时才闭环的（如整体构建、发布或验证结果）在收口时写入。

+ - 只读分析、审查或状态查询没有事实册写权限，除非用户明确要求维护记忆；凡任务已允许修改当前产品根目录内的目标文件，维护该根目录下的事实册属于同一写权限，除非用户明确排除。最终回复前必须收口对账，把符合条件但尚未记录、已经改变或已经失效的事实直接创建、更新或移除，不得只在回复中列出候选，也不得因事实文件不存在而跳过；不得因本节扩大当前产品根目录之外的写入范围。

+ - 某个命中簇出现首条应入册事实而对应文件不存在时，在当前产品根目录下一并创建 `docs/product-studio/<product-id>/quality-engineering/` 与以该簇卷文件名命名的 `.md`；没有事实时不创建空文件或空目录。首行固定为 `# quality-engineering 当前产品事实 · <簇名>`；每项事实以可检索的稳定业务语义为二级标题，用现在时写清当前事实、成立条件与影响边界，并给出相对于当前产品根目录的权威核验入口和失效或重审条件。

+ - 同一认知只保留一处，原位更新或移除旧内容，只保留当前仍成立的事实，不追加历史版本；簇事实文件内最后一条事实移除后删除该文件，`<product-id>/quality-engineering/` 目录为空时删除该目录，`<product-id>` 目录为空时一并删除。

- 不记录秘密、用户数据、任务过程、文件改动清单、迁移进度、运行快照、当前版本、一次性结果或未经验证的推断。