quality-gates

Quality Gates & Audit Master Guide 是 Black-Tortoise 项目中的质量门禁与审计主指南技能，主要用于文档化合并（pre-merge）前的检查清单，明确哪些门禁必须通过、需要更新哪些审计产物，以及仓库期望运行哪些测试。

用途 该技能面向需要执行审计、测试和架构治理的开发流程，帮助开发者在提交代码或合并前遵循统一的检查标准。其内容依据 .github/instructions/64-quality-testing-copilot-instructions.md。

主要能力与门禁要求

1. 架构门禁：在任何结构性变更（新增依赖、跨层导入、新增模块）之后，运行 pnpm run architecture:gate，以强制执行 .github/instructions/61-architectural-governance-copilot-instructions.md 中描述的 dependency cruiser 规则。
2. 合并前检查：在 PR 之前，执行 pnpm run lint、pnpm run build -- --noEmit，以及相应能力说明中描述的相关单元测试套件。
3. 提交钩子：确保由 git commit 触发的 Husky/lint-staged 钩子通过（依据 package.json 中的 eslint 与 tsc --noEmit）。

文档与审计跟踪

1. 当更改能力、事件或关键工作流时，更新 docs/AUDIT-<module>.md，记录不变量、边界与审计发现，具体要求见 .github/instructions/64-quality-testing-copilot-instructions.md。
2. 在完成前，将需求与状态记录到 requirements.md 和 tasks.md 中，状态值包括：not-started、in-progress、completed、blocked。
3. 捕获 architecture:gate 失败日志并写入笔记，以便审查者了解自上次通过门禁以来的变更。

测试期望

1. 针对变更涉及的每一条关键路径和领域不变量编写测试；单元测试使用 Jasmine + Karma（用于 store/domain），端到端测试使用 Playwright 覆盖 happy-path 流程。
2. 使用 Playwright 时采用弹性选择器（data-testid、roles）和模拟器重置，以保证测试确定性（相关模式已在 .github/skills/e2e-playwright 中描述）。
3. 引入异步或信号转换时，执行完整的 Arrange-Act-Assert 周期，并使用 takeUntilDestroyed() 或 rxMethod 释放来清理订阅。

适用场景

1. 任何时候添加或修改测试、指令，或涉及 GA/QA 任务且必须提及门禁命令、审计人员或文档时。
2. 任何时候改动文档或流水线脚本，以使审计资产与 docs/AUDIT-* 的期望保持同步。

限制与说明 官方文本暂未提供；除上述资料外，该技能是否包含其他功能、收费方式、价格、平台支持或具体效果，暂未提供。