用途:指导在 seed-skills/<slug>/SKILL.md 中新增或修改 QA 目录技能,并通过校验、写入生产库、发布到 qaskills.sh 线上目录。注意这些是产品目录技能(Zod 校验,含 testingTypes/languages),不是 Claude Code 工作流技能。
格式契约:seed.ts 用正则而非 YAML 解析 frontmatter,所有值须写在一行;数组只能内联如 tags: [a, b, c],块列表会解析为空。Zod 限制:name 1-100 字符,description 10-500 字符,version 为 semver,testingTypes 与 languages 各至少 1 个;允许取值来自 packages/shared/src/constants/。正文写入 fullDescription,应至少 100+ 行有实质内容。
步骤:先去重 slug,用 curl 检查 https://qaskills.sh/api/skills/<slug> 返回 404;随后写文件、用 skill-validator 校验,并人工确认数组内联、描述单行。写入生产库前须用 vercel env pull .env.vercel-prod --environment=production 获取生产 DATABASE_URL,不要用 .env.local,否则线上无变化。记录基线总数后执行 pnpm --filter @qaskills/web db:seed(upsert 可安全重跑)。
验证:确认 API 总数等于基线加 N,内容接口非空,技能页返回 200;若总数未变或 404,说明写错库,应停止并核对。最后 git add/commit/push,目录改动无需重新部署网页。限制:不得替换自定义 SQL,未经用户批准不得对生产库执行 UPDATE/DELETE。