SuperAPI AI 工具集

scrolls-update

通用与其它

查看项目

更新于 10-16 01:06

技能介绍

用途:更新已有 docs/.scrolls/ 项目记忆系统,按 STARTER.md 已定义的更新规则逐文件处理,而非每次触碰所有文件。

主要能力:更新 HANDOFF.md(覆盖式快照)、SPEC.md(仅为已交付功能追加)、GAP_ANALYSIS.md 与 GAP_CONTEXT.md(保持同步,关闭即删除对应条目)、PLAN.md(勾选、重排、新增条目)、WISDOM.md(仅在确有新收获时追加);同时幂等回填 SCROLLS.md、CLAUDE.md、AGENTS.md,适用于早于这些文件存在时搭建的项目。

使用方式:支持 -p/--path、-t/--reporoot、-l/--local、-r/--recurse 选项,无真正 argv 解析,需从调用文本中自行提取。先用 BASE_DIR 定位 docs,再找到 .scrolls 或 scrolls 目录(先 .scrolls 后 scrolls);两者并存时须询问用户。确认本次会话实际发生的变更时,可运行脚本:bash <skill-dir>/scripts/session_diff.sh SCROLLS_PATH 或 pwsh <skill-dir>/scripts/session_diff.ps1 -ScrollsDir SCROLLS_PATH。

适用场景:日常会话结束时同步项目记忆、补齐旧项目缺失的指针文件。

限制:找不到 scrolls 目录时不自动创建,应改用 /scrolls-setup;-p、-t、-l 最多选一个,-r 可独立组合;递归搜索需剪枝 node_modules、.git、vendor、dist 等重目录;不确定是否交付时不虚报,宁可记录为未交付;不读取 meta/MAINTAINERS.md 或 tests/ 来执行用户请求。