搭建 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.mdreferences/platform-quality-gates.mdreferences/concrete-rules.md
这些路径都以本技能的 SKILL.md 所在目录为锚点;加载技能后,按相对路径渐进式读取对应材料。
流程
- 检查目标仓库里的
AGENTS.md、包管理文件、package.json脚本、TypeScript 配置、lint 和格式化配置、测试配置、浏览器测试设置、GitHub 工作流、hook 脚本和已有门禁编排入口。 - 按下面三层结构形成方案。
- 如果需要扩展规则或确认最新规则名,先查
references/concrete-rules.md的官方文档入口,不要只凭记忆补规则。 - 用
../references/gate-levels-and-template.md的分级表给出推荐档位和取舍,不要替用户决定档位。 - 停在 confirmation-before-write 闸门。展示计划创建或修改的精确文件和远端设置,然后请求用户明确批准。
- 批准后,落地最窄但有用的脚手架,运行新的本地入口,并报告仍需手工处理的 GitHub 设置。
第一层:检查工具
识别可执行的 TypeScript 前端检查:包管理脚本中的 lint、typecheck、format check、单元测试、组件测试、浏览器测试、构建,以及保护 lint 或打包器配置的自定义测试。
第二层:检查规则
把每个工具映射到它执行的规则:格式化、lint 策略、严格类型、配置漂移、共享界面行为测试、环境变量形状、构建正确性或浏览器流程覆盖。
第三层:调用时机
决定检查在哪里运行:本地 hook 提供快速反馈,拉取请求工作流作为权威,required status check 阻塞合并,可选浏览器工作流覆盖关键用户流程,GitHub ruleset 约束审查要求。
输出形态
返回简洁的脚手架方案,包含:
- 计划创建或修改的文件;
- 第一层工具表;
- 第二层规则表;
- 第三层调用时机表;
- confirmation-before-write 提示;
- 实现后的验证命令。