成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

从 tools 文件夹学习个人脚本

Agent 扫描个人 scripts/tools 目录,归纳用法、参数与可复用片段,写入可检索笔记。

来源:X 原帖 ↗
DeepSeekClaudeChatGPTGrok Bot⚡ 效率办公🛠️ 开发者工具

场景说明

个人工具目录常年堆脚本却少文档。Agent 只读扫描 scripts/tools,解析入口、依赖与典型调用,抽出可复用片段与「何时用」说明,写入笔记或本地知识库。适合把隐性习惯变成可交接资产。不执行未审脚本;密钥与环境变量只记占位名,不抄真实值。

案例叙事

01他们做了什么

X 上 Tomasz Tunguz(@ttunguz)发帖称:让 Claude Cowork 只读自己的 tools 文件夹,约十一步行后归纳出他如何工作。作者自述过去一年在 Claude Code 里搭过个人「操作系统」——发邮件、更新 CRM、调研创业公司、起草回复等几十个小脚本都堆在笔记本本地目录,原先只能从终端调用;Cowork 解析各脚本并写入记忆后,同一套能力可在另一界面复用,工具不再绑死在单一应用。帖中也坦言当前 Cowork 仍粗糙:慢、启动崩溃过两次、还改过 Claude Code 授权设置。公开帖未给出扫描准确率、笔记采纳率或交接节省工时等量化。

国内落地收成「scripts/tools 只读扫描 → 用途/用法/片段卡片 → 人校对归档」:指定只读路径与笔记输出位置(可进飞书知识库或本地库);密钥与环境变量只记占位名,不抄真实值;不执行未审脚本。硬约束:先扫只读清单确认无密钥明文再生成可分享笔记;高频脚本单独标「推荐入口」。

02实际效果

  • 源未披露脚本识别准确率、笔记采纳率、交接工时或误执行事故率等量化;公开帖侧重「读 tools 文件夹 → 解析脚本进记忆 → 跨界面复用」的能力叙事。
  • 作者自述:Cowork 约十一步读完 tools 目录后理解其工作方式,并把发邮件/CRM/调研/起草回复等脚本能力迁到新界面;同时称产品仍慢、启动崩溃过、改过授权(帖文陈述,非我方实测)。
  • 个人或小团队可把隐性脚本习惯收成可检索用法卡片与飞书/本地笔记;是否执行、改写脚本仍由人校对后决定,Agent 默认只读不跑。

03值得知道

  • 公开源未给出可复用的文档质量基线,上线后用自有目录复盘卡片是否可交接,勿把「读过文件夹」当成已安全自动化。
  • 硬约束:只读扫描;禁止擅自执行未审脚本;禁止把真实密钥/Token/环境变量写入笔记或飞书;对外分享前再扫一遍敏感信息。
  • 模型可能误读参数或编造用法;每张卡片须链回源文件路径;改授权类副作用要人立刻核对本地配置。

04可复制提示词

tools 目录用法卡片

你是个人脚本文档助手。在只读前提下,根据给定脚本清单生成中文「用途 / 用法 / 可复用片段」卡片。禁止建议执行未审脚本;禁止输出真实密钥或环境变量值,一律用占位名(如 ${API_KEY})。

输出:
## 脚本名与路径
## 何时用(一句话)
## 入口与典型参数
## 依赖(包/CLI/占位环境变量名)
## 可复用片段(短,脱敏)
## 风险提示(破坏性操作/外发)
## 非目标(不执行脚本、不抄密钥)

脚本清单与摘录:
{{tools_inventory}}

飞书归档校对清单

把用法卡片压成飞书/企微校对清单(≤180 字):新增卡片数、标为「推荐入口」的脚本、仍缺文档的文件、疑似含密钥需人工重扫项。结尾写「只读归档,勿自动执行」。不要粘贴任何疑似密钥字符串。

卡片摘要:
{{cards_digest}}

怎么做

  1. 指定 scripts/tools 只读路径与笔记输出位置
  2. Agent 扫描并生成「用途 / 用法 / 片段」卡片
  3. 人校对后归档,需要时按笔记复用或改写

实用提示

  • 先扫只读清单,确认无密钥明文再生成公开笔记
  • 高频脚本单独标「推荐入口」,减少找错文件
#个人脚本#tools目录#用法归纳#可复用片段#开发笔记