SuperAPI AI 工具集

dev-workflow

部署与运维

查看项目

更新于 10-15 20:28

技能介绍

用途:本技能面向 Contentstack kickstart-next-ssg 仓库,帮助开发者完成本地环境搭建、复现运行、增改 npm 脚本,并了解拉取请求(PR)阶段会执行哪些自动化检查(区别于本地构建)。

前置条件:需使用与 Next.js 16 兼容的 Node.js(建议当前 LTS),包管理器为 npm,锁文件为 package-lock.json。

首次搭建:克隆仓库后运行 npm install;参照根目录 README.md 中记录的变量(AGENTS.md 中有摘要)复制或创建 .env(或 .env.local);若尚无匹配的内容类型与条目,按 README.md 中的 CLI 流程(contentstack/kickstart-stack-seed)为 Contentstack stack 播种数据。

脚本(来自 package.json):npm run dev 启动 Next.js 开发服务器(默认端口 3000);npm run build 执行生产构建;npm run start 在构建后提供生产版本服务;npm run lint 对 .ts 和 .tsx 运行 ESLint(eslint . --ext .ts,.tsx)。

PR 自动化:.github/workflows/sca-scan.yml 对 Node 与 contentstack/sca-policy 运行 Snyk,不替代本地 npm run lint 或 npm run build;.github/workflows/policy-scan.yml 检查公开仓库的 SECURITY.md 与许可证文件;.github/workflows/issues-jira.yml 根据新 GitHub issue 创建 Jira 工单。本仓库不强制分支命名,遵循团队 Git 约定即可。

限制:资料未提供具体环境变量清单、Snyk 配置细节及分支策略要求,需查阅仓库内 README.md、AGENTS.md 与工作流文件确认。