Agent Skills
返回列表
文件总结

文件总结

知识管理 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_56e2a655/file-summarizer。

技能介绍

要解决什么问题

仓库里常有单文件过长、类型各异的情况:论文 PDF 转文本、几千行的服务代码、config.yaml 或内部 Markdown。你只想知道「核心逻辑是什么」「有哪些关键配置」,而不是自己从头扫一遍。本技能在用户明确提出总结、提炼要点或 TL;DR 某文件时介入,把阅读与归纳收敛成一次对话里的结构化输出。

工作方式

  1. 锁定目标文件 — 若未指定路径,会先向你确认。
  2. 用 read 工具读取 — 体积很大时先读首段,再询问是否继续。
  3. 按文件类型组织摘要,例如:

- 代码:import、类型定义、主流程、导出面
- 配置:值得关注的键值,略去模板化占位
- Markdown / 文档:保留标题层级,必要时指向章节

  1. 直接在对话中输出 — 默认不写磁盘;只有你要求保存时才落文件。

适用边界

  • 超过约 100KB 的大文件会分块总结,需要你配合决定是否继续读后续块。
  • 它做的是单文件理解与摘要,不是跨目录架构审计或批量对比。
  • 触发依赖自然语言意图(如「帮我总结这个文件」「TL;DR 这篇论文」),不会替你在未说明目标时自动扫全项目。

使用场景

  • 接手他人遗留的单体代码文件,需要在改 bug 前先弄清 import 链路与主流程
  • 打开体积超过 100KB 的日志或导出文本,只想先读首段再决定是否继续深挖
  • 新环境里的 config.yaml 键值众多,需要快速标出与当前部署相关的非模板项
  • 论文或长 Markdown 文档已落盘,想按章节结构拿到要点而不逐段通读

适合人员

  • 刚 clone 仓库、需要快速理解某个核心 `.py` 或 `.ts` 文件导出与主逻辑的维护工程师
  • 负责排查线上问题时要把巨大单文件日志先压缩成可讨论要点的 SRE
  • 写技术方案前需要把内部规范 Markdown 的标题与章节要点摘进评审材料的文档作者
  • 读论文或技术报告本地副本、用 TL;DR 确认是否值得精读的研发生态成员