用途:当需要把一个 dean-stack(含 TurboRepo 生成器)的改动完整传播到整个仓库时使用,按 P1–P5 五个阶段执行;若参数以 --baseline 开头,则只跑 P5,把已知历史改动当作既成事实,审计技能生态是否同步。参数为空或有歧义时先询问。
主要阶段:P1 在 apps/web 用 .agents/skills 中对应专门技能做源码改动;P2 把源码级改动镜像到 turbo/generators/templates/app,除 {{name}} 替换外差异必须逐字一致;P3 从模板重生成 apps/test-project(该目录被 gitignore,禁止提交),过 bun run check 前先执行 kill-servers 技能:pkill -f "storybook dev" || true; pkill -f "vite preview" || true; pkill -f "vite dev" || true,等待 2 秒并检查 3000/5173/6006 端口;门禁必须全绿才能进入 P4,基础设施性抖动可重试一次,真实失败必须停下,不得静默 .skip。
补充校验:P3.4 仅针对改动 dev 编排的场景,冒烟 bun run dev 并确认 vite、storybook、biome:watch(chokidar 包裹)、stylelint:watch 四个协程存活;P3.4.1(任何 P1 改动)用 Playwright 脚本检查 pageerror、error/warning 控制台消息、4xx/5xx 响应,并要求 body 可见文本长度 ≥5,因为门禁跑的是 bun run preview 生产构建,看不到 dev 专属运行时错误;P3.5(触及 .tsx)用 Storybook 中 react-scan 检查多余重渲染;P3.6(触及 .tsx)运行 npx -y react-doctor@latest . --verbose --diff --fail-on error,该项不在 bun run check 内。
P4:更新 AGENTS.md、README.md 及所属 SKILL.md,并把新增的“不再使用/改名/排除”规则追加到 <sweep-tokens> 表。P5:P5.0 机械扫描用 grep -rn -E 在技能与文档中查表内每个 token(排除 potential_skills/、node_modules、.turbo、dist/),逐条判定 stale 或 deliberate,不交给智能体做;P5.1 按主题族并行派 Explore 子代理做叙事性检查(概念漂移、自相矛盾、包名错误、失效链接等);P5.2 合并去重,单次改动中的简单替换可立即应用并上报,叙事性或关键发现进入待审清单等用户确认,--baseline 全部只列清单、不自动修改。
限制:表格列出的多数 token(如 tsc --noEmit、jotai-family、@pixi/、.tool-versions、"pipeline"、@tanstack/start、vitest、jest、lodash、JSON.parse(JSON.stringify 等)只在特定允许上下文中保留,否则视为过时;不要手动添加 useMemo/useCallback/React.memo。资料未提供该技能的安装方式、许可或收费信息。