scriptbook

Scriptbook 是一种让智能体复用脚本而非重复编写的约定，来源为 dyrits/skills。其核心动机是：智能体在任务各环节乃至后续会话中反复重建同类辅助脚本（重命名文件、转换格式、调用接口、提取字段），而带索引的已保存脚本可将重建变成一次查找。\n\n用途与结构：它维护两个脚本库，每个都是含脚本与 INDEX.md 的目录。项目库位于 .agents/scripts/，存放依赖本仓库布局、工具链或约定的脚本；全局库位于 ~/.agents/scripts/，存放适用于任何仓库的脚本。首次保存时创建目录及其 INDEX.md。\n\n使用方式分四步。一、查找：编写脚本或多步 shell 管道前，先读两个 INDEX.md；同时检查项目自带任务运行器（justfile、Makefile、package.json scripts），若其中已有可用命令则直接使用，无需查索引。完成标准是动作匹配到条目或运行器命令，或确认两者均无匹配。二、运行或扩展：用任务所需参数运行匹配条目；当某条目仅差一个输入时，为其增加参数、重跑其用法示例并更新索引行；仅相差一个值的同类脚本属重复。三、仅在无匹配时编写：值得保存的脚本需同时满足四项——单一动作且以“动词+名词”命名；所有可变值（路径、ID、URL、日期）均为参数；凭据来自环境变量；可安全重复运行或头部注明其改动。仅对单一数据集有意义的脚本应内联执行而不保存。四、保存并登记：脚本依赖本仓库则存入项目库，否则存全局库；写成可执行文件，头部注释说明功能、参数及一个用法示例，并在登记前运行该示例一次；在对应 INDEX.md 按字母序添加一行，格式为名称、功能、用法、依赖。\n\n委派情形：子智能体不携带当前对话，需在其简报中写明两个脚本库路径，以便查找已保存内容。\n\n限制：该项目未提供收费、价格、平台或效果等信息，暂未提供。