用途:把项目中以可见形式存在的 scrolls 工作记忆文件夹(如通过 /scrolls-setup --unhide 或 /scrolls-unhide 设为可见)改回点号隐藏的默认形式,即 scrolls → .scrolls,并改写能确认的旧路径引用,不猜测改写范围外文件。它是 /scrolls-unhide 的反向操作。
路径基准:除非用 -t/--reporoot,否则所有操作相对当前工作目录,而非技能自身所在位置。
跨平台:附带脚本有 hide.sh(bash,macOS、Linux 或带 Git Bash/WSL 的 Windows)与 hide.ps1(PowerShell 7+)。两者接受完全相同的标志(-p/--path、-t/--reporoot、-l/--local、-r/--recurse)并产生相同输出。可先试 bash --version,可用则用 .sh;否则用 pwsh(推荐,可从 https://aka.ms/powershell 安装),仅在确实没有 pwsh 时用 Windows 自带 powershell.exe(未针对旧版本测试)。
选项:-p 指定基础目录,可重复以一次处理多个位置;-t 使用 git 仓库顶层(git rev-parse --show-toplevel)作为基准,不在 git 仓库内会报错;-l 显式使用当前工作目录(也是无参数时的默认);-r 递归搜索,默认关闭,会剪枝 node_modules、.git、vendor、dist、build、.venv、venv、pycache、target、.next、.cache 等目录,并只匹配含 STARTER.md 的 scrolls 目录。-t 与 -l 各自只能单独使用,不能与 -p 或彼此组合;-r 可与之叠加。无基准目录时默认用 DEFAULT_SCROLLS_RELPATH 环境变量(若已设置),否则用当前目录。
用法:运行 bash <skill-dir>/scripts/hide.sh [-p BASE ...] [-t] [-l] [-r] 或 pwsh <skill-dir>/scripts/hide.ps1 [-p BASE ...] [-t] [-l] [-r]。脚本重命名文件夹(git 跟踪时用 git mv 保留历史,否则普通 mv),改写移动后文件夹内部文件及与 docs 同级的唯一 SCROLLS.md 中的引用;CLAUDE.md 不会被改动。其他仍提及旧路径的文件只报告不编辑,需人工阅读后按判断修改。若某基准目录无匹配文件夹则报错,可检查路径、尝试 -t 或加 -r。
限制:不会触碰 scrolls 文件夹及其自身 SCROLLS.md 之外的文件;可能偶有同级 SCROLLS.md 误报。资料未提供收费、价格与效果信息。