SuperAPI AI 工具集

scratch-pad

办公与效率

查看项目

更新于 10-24 16:20

技能介绍

用途

Scratch Pad 是一个基于 Markdown 的工作记忆(working memory)工具,用于在复杂任务执行过程中跟踪进度、保存中间结果并组织信息。它把内容直接写入一个 .md 文件,可以立即读取使用。

主要能力

命令行脚本提供以下操作:

  • 初始化:python scripts/scratch_pad.py init "Task Name",创建指定任务名的记录文件,也可用 --file 指定路径。
  • 追加内容:python scripts/scratch_pad.py append "Content to add..."。
  • 添加章节标题:python scripts/scratch_pad.py section "Research Findings"。
  • 读取全部内容:python scripts/scratch_pad.py read。
  • 记录工具调用:python scripts/scratch_pad.py log-tool "tool_name" '{"param": "value"}' "result text",保存工具名、参数与结果。
  • 添加发现:python scripts/scratch_pad.py finding "Important discovery" --category "Analysis"。
  • 添加检查点:python scripts/scratch_pad.py checkpoint "Phase 1 Complete"。
  • 管理待办:python scripts/scratch_pad.py todo "Follow up on this",用 --done 标记已完成。
  • 标记任务完成:python scripts/scratch_pad.py complete。

同时提供 Python 模块接口,可导入 ScratchPadManager,使用 init、add_section、append、log_tool、add_finding、read、complete 等方法。

使用方式

资料给出的集成模式为:任务开始时初始化文件;每次工具调用前后记录参数与结果;随时添加发现;需要时读取内容作为参考;任务结束后删除临时文件。文件建议放在 FILESYSTEM_BASE_DIR/files/{channel_id}/tmp/ 下,命名为 scratch_{timestamp}.md 或 scratch_{task_id}.md,并保持体积在 1MB 以内。

适用场景

资料建议在以下情况使用:需要 5 次以上工具调用的任务、多来源调研(如“조사해줘”)、对比分析(“비교해줘”)、信息综合整理(“정리해줘”)以及分步骤处理。

限制与注意事项

  • 资料强调 scratch pad 仅供自身参考,不应把原始 Markdown 直接复制粘贴到回复中,而应据此组织并撰写正式答复。
  • 使用后必须删除临时文件。
  • 输出文件为易读的 Markdown 结构,含任务名、创建时间、状态、任务概览、发现、工具记录与检查点等。
  • 关于许可、价格或外部平台集成的更多信息,资料暂未提供。