25 lines (17 loc) · 1 KB

Workspace Guidelines (`scripts/*`)

适用范围

本文件适用于 scripts/*。
该目录包含仓库自动化与维护脚本（模板同步、README 生成、demo 批处理、监控等）。

通用原则

脚本应可重复执行（幂等）并尽量避免隐式副作用。
涉及批量改写文件时，优先先 dry-run 或最小范围验证，再全量执行。
新脚本优先参数化输入，避免写死路径或依赖本机环境变量。
对外网络请求或 registry 交互需要明确失败处理与日志提示。

变更要求

修改脚本行为时，至少提供一次实际运行验证（可附关键输出摘要）。
若脚本会改写模板/文档，需在提交说明中标注影响目录与回滚方式。

常用入口

scripts/demo/*：demo 安装与构建批处理。
scripts/readme/*：README 生成与拼接。
scripts/watcher/*：本地 watch 自动化。
其他顶层脚本：模板同步、showcase 更新、依赖更新、e2e 快照维护。