SuperAPI AI 工具集

scrolls-unhide

通用与其它

查看项目

更新于 10-15 23:57

技能介绍

用途:把已用 /scrolls-setup 建好的 docs/.scrolls 工作记忆文件夹,从隐藏点文件形式转为可见目录 scrolls。它是 /scrolls-hide 的镜像操作,只处理已存在的设置,不做初始创建。

主要能力:重命名 .scrolls → scrolls;对能确信的旧路径引用做改写,包括被移动文件夹自身文件中的引用,以及该文件夹 docs 的同级 SCROLLS.md(仅限这一个精确同级文件,不做更大范围搜索)。CLAUDE.md 不会被改动,因为它只是指向 SCROLLS.md 的固定指针。在有 git 跟踪时用 git mv 保留历史,否则退回普通 mv。附近其他仍提到旧路径的文件会被列出但不自动编辑,留待人工核对,避免误改 README、CI 配置等无关内容。

使用方式:脚本有 bash 版 unhide.sh(macOS、Linux 或带 Git Bash/WSL 的 Windows)与 PowerShell 7+ 版 unhide.ps1(Windows,或装有 pwsh 的 macOS/Linux),两者标志与输出一致。调用形式:bash <skill-dir>/scripts/unhide.sh [-p BASE ...] [-t] [-l] [-r] 或 pwsh <skill-dir>/scripts/unhide.ps1 [-p BASE ...] [-t] [-l] [-r]。-p/--path 指定基准目录,可重复;-t/--reporoot 用 git 仓库顶层为基准;-l/--local 显式使用当前目录(默认行为);-r/--recurse 在基准目录下递归查找。默认不递归时只检查基准目录本身(若已是含 STARTER.md 的 scrolls 文件夹)或其下的 docs/.scrolls;递归时只认名称恰为 .scrolls 且含 STARTER.md 的目录,并跳过 node_modules、.git、vendor、dist、build 等常见目录。未给基准目录时,脚本使用 DEFAULT_SCROLLS_RELPATH 环境变量(若已设置),否则用当前目录。

执行后需处理脚本列出的剩余引用:逐一阅读,确认确属陈旧路径再手动更新,无关的巧合匹配应跳过;最后报告被取消隐藏的目录、自动修复内容、被跳过的项及原因、以及手动修复内容。

限制:所有操作相对当前工作目录或指定基准目录,而非此技能自身位置;某一基准目录找不到匹配文件夹时报错并提示改用 -t、-r 或先运行 /scrolls-setup。脚本刻意不修改 scrolls 文件夹与其自身 SCROLLS.md 之外的文件。PowerShell 版建议用 pwsh;内置 Windows PowerShell powershell.exe 未在该旧版本上测试。多个位置的 scrolls 文件夹可能合法共享同一短路径字符串,因此更广搜索 SCROLLS.md 有风险。