SuperAPI AI 工具集

scratchpad

编程与开发

查看项目

更新于 10-15 23:46

技能介绍

用途:根据用户当前源码光标或选区,找到最近的 JSDoc Example,并生成一个 scratchpad TypeScript 文件。

主要能力:确定源文件路径与行号;优先使用 IDE 当前文件与选区/光标行,也可由用户显式提供文件与行号;若没有行号或选区则询问用户。执行命令:node .agents/skills/scratchpad/scripts/extract-example.mjs <source-path> <line>。脚本选择包含该行的 Example 段;否则选其后第一个示例;再否则选最近的前一个示例。文件名由源文件与示例标题派生,例如 scratchpad/Schedule-retrying-and-repeating-effects.ts。已存在文件不会被覆盖,脚本会追加数字后缀。自动模式下,若存在顶层 program 绑定,脚本会追加 Effect.runPromise(program).then(console.log, console.error);若示例已含 Effect runner 则保留。

使用方式:若脚本因没有明显 runner 而以退出码 2 结束,询问用户是原样保留示例、指定要运行的 Effect 值,还是取消。原样保留时用 --mode preserve 重跑;运行特定 Effect 值时用 --runner <identifier> 重跑。将创建路径以可点击文件链接形式报告,这是在代码面板中打开它的确定性方式。

限制:除非用户明确要求,否则不要运行 scratchpad 文件。其他细节暂未提供。