SuperAPI AI 工具集

scaffold-node-tool-quality-gates

编程与开发

查看项目

更新于 10-15 17:24

技能介绍

用途:为 Node.js 命令行工具、本地守护进程、MCP 服务、发布到 npm 的工具包或轻量 JavaScript/TypeScript 工具仓库设计并搭建硬质量门禁。范围不含网页前端框架的浏览器体验门禁,该场景改用 scaffold-typescript-frontend-quality-gates。

主要能力:先检查目标仓库的 AGENTS.md、package.json、锁文件、Node 版本约束、命令行入口、测试配置、lint 或类型配置、GitHub 工作流、hook 脚本和已有门禁编排入口,再按三层结构给出方案。第一层检查工具:包管理脚本中的语法检查、原生测试、lint、类型检查、命令行冒烟、包发布形态检查、配置漂移测试及项目专属边界测试。第二层检查规则:脚本入口稳定性、Node 版本兼容性、命令行参数行为、异步资源释放、敏感环境变量不泄露、包内容和 bin 映射正确性、依赖锁定、配置漂移与网络边界。第三层调用时机:本地 hook 快速反馈、拉取请求工作流作为权威、required status check 阻塞合并、合入后验证包形态或发布烟测、定时工作流覆盖依赖审计和外部集成冒烟。

使用方式:变更前须完整阅读技能目录下 references 的必读材料(three-layer-model.md、landing-safety.md、github-review-and-rulesets.md、invocation-examples.md、gate-levels-and-template.md、platform-quality-gates.md、concrete-rules.md),按 SKILL.md 所在目录的锚点相对路径渐进读取。扩展规则或确认最新规则名时先查 concrete-rules.md 的官方文档入口。用 gate-levels-and-template.md 的分级表给出推荐档位与取舍,不替用户决定档位。

限制:方案须停在 confirmation-before-write 闸门,展示计划创建或修改的精确文件和远端设置并请求明确批准;批准后才落地最窄但有用的脚手架,运行新的本地入口,并报告仍需手工处理的 GitHub 设置。输出为包含文件清单、三层表格、确认提示和验证命令的脚手架方案。其他细节资料暂未提供。