---
name: scaffold-typescript-frontend-quality-gates
description: 为 TypeScript 前端仓库搭建质量门禁，按检查工具、检查规则和调用时机三层组织方案，并在写入前确认。
---

# 搭建 TypeScript 前端质量门禁

当用户要为 TypeScript 前端仓库或前端子包设计或搭建硬质量门禁时使用本技能。范围限定在网页前端，不覆盖移动客户端或 Python 后端服务。

## 必读材料

提出变更前，完整阅读这些文件：

- `../references/three-layer-model.md`
- `../references/landing-safety.md`
- `../references/github-review-and-rulesets.md`
- `../references/invocation-examples.md`
- `../references/gate-levels-and-template.md`
- `references/platform-quality-gates.md`
- `references/concrete-rules.md`

这些路径都以本技能的 `SKILL.md` 所在目录为锚点；加载技能后，按相对路径渐进式读取对应材料。

## 流程

1. 检查目标仓库里的 `AGENTS.md`、包管理文件、`package.json` 脚本、TypeScript 配置、lint 和格式化配置、测试配置、浏览器测试设置、GitHub 工作流、hook 脚本和已有门禁编排入口。
2. 按下面三层结构形成方案。
3. 如果需要扩展规则或确认最新规则名，先查 `references/concrete-rules.md` 的官方文档入口，不要只凭记忆补规则。
4. 用 `../references/gate-levels-and-template.md` 的分级表给出推荐档位和取舍，不要替用户决定档位。
5. 停在 confirmation-before-write 闸门。展示计划创建或修改的精确文件和远端设置，然后请求用户明确批准。
6. 批准后，落地最窄但有用的脚手架，运行新的本地入口，并报告仍需手工处理的 GitHub 设置。

## 第一层：检查工具

识别可执行的 TypeScript 前端检查：包管理脚本中的 lint、typecheck、format check、单元测试、组件测试、浏览器测试、构建，以及保护 lint 或打包器配置的自定义测试。

## 第二层：检查规则

把每个工具映射到它执行的规则：格式化、lint 策略、严格类型、配置漂移、共享界面行为测试、环境变量形状、构建正确性或浏览器流程覆盖。

## 第三层：调用时机

决定检查在哪里运行：本地 hook 提供快速反馈，拉取请求工作流作为权威，required status check 阻塞合并，可选浏览器工作流覆盖关键用户流程，GitHub ruleset 约束审查要求。

## 输出形态

返回简洁的脚手架方案，包含：

- 计划创建或修改的文件；
- 第一层工具表；
- 第二层规则表；
- 第三层调用时机表；
- confirmation-before-write 提示；
- 实现后的验证命令。