SuperAPI AI 工具集

scrolls-setup

通用与其它

查看项目

更新于 10-15 23:57

技能介绍

用途:该技能为一个尚无工作记忆系统的项目生成 docs/.scrolls/ 目录(可通过 -u 改为未隐藏的 scrolls),其中存放一组跨会话记忆文件,记录项目做什么、当前状态、已知缺失及原因、下一步计划和需避开的陷阱;同时安装 SCROLLS.md 引导每次会话先读 STARTER.md,并用 CLAUDE.md、AGENTS.md 做指针转发,使 Codex CLI 等遵循 agents.md 约定的工具也能接入。

主要能力:从 assets/templates/ 复制并替换占位符,生成七个文件——STARTER.md(阅读顺序与更新时机表)、SPEC.md(功能清单)、HANDOFF.md(当前状态快照,每会话覆盖)、GAP_ANALYSIS.md(已知缺失)、GAP_CONTEXT.md(缺失原因)、PLAN.md(带优先级的待办)、WISDOM.md(约束/陷阱/沟壑/经验)。模板初始接近空白,不预填猜测内容。

使用方式:通过 /scrolls-setup 调用,可在其后以纯文本传参,顺序不限。选项包括 -p/--path=<path> 指定自定义 docs 文件夹;-t/--reporoot 固定到 git 仓库顶层(依赖 git rev-parse --show-toplevel,非 git 仓库时失败并提示改用 --path);-l/--local 固定到当前工作目录;-r/--recurse 创建前扫描附近已存在的 scrolls 文件夹避免重复;-u/--unhide 使用 scrolls 而非 .scrolls。默认为当前目录,p、t、l 三者最多用一个,r 可自由组合。文件通过读写工具创建;会检查并补齐 SCROLLS.md、CLAUDE.md、AGENTS.md 指针,且不覆盖已有内容,可重复安全执行。

适用场景与限制:适合没有该系统的项目初始化工作记忆,也适合已有项目补齐指针链;跨平台,macOS、Linux、Windows 行为一致。SCROLLS_PATH 已存在或指针文件已引用时不会静默覆盖,而是询问或保持不变;-p 情况下 SCROLLS.md 等位置需依项目约定判断,不明确时会询问;不会预先编造额外记忆文件,子系统的扩展文件由后续实际工作按模式自行添加。维护者布局说明不属于执行该请求的范围。