Agent Skills
返回列表
文件精要摘要

文件精要摘要

知识管理 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在代码审查、排障或接手陌生仓库时,你经常需要先搞清「这个文件到底在干什么」——但直接通读几百行代码、配置或日志既费时间,又容易抓不住主线。用户常说「帮我总结这个文件」「太长不看」;有时你刚打开一个文件,对方还没说具体要改什么,先建立上下文比盲目搜索更合理。

技能如何工作

技能按 Workflow 处理任意文本类输入:用 read 加载内容;超大文件先读头部再分块续读。随后按文件类型切换总结重点:

  • 代码:功能、入口、主要函数/类、依赖与架构
  • Markdown/文档:核心观点、章节结构、关键结论
  • 配置:主要配置项、启用的功能、连接目标
  • 日志:异常/错误、关键事件时间线、频率
  • CSV/JSON 等数据:字段结构、数据量、分布与异常值
  • Shell/Bat:做了什么、依赖什么、输入输出

详细程度可随用户表述调整:默认中等(约 3~7 个要点)、「详细总结」展开、「一句话总结」或「列出要点」则收窄输出。

适用边界

图片、PDF 等二进制无法当作文本直接摘要,需先说明限制并给出替代思路。内容极长(例如 >500 行)时优先头部、结构标记与尾部,避免假装全文精读。总结里出现的密码、token、API key 等敏感字段以 **** 脱敏显示。

使用场景

  • 接手陌生仓库时,需要先弄清某个入口模块文件负责哪些功能,再决定从哪条调用链下手改问题。
  • 线上故障排查时,要从体积很大的应用日志里快速抽出错误栈、重复异常和关键事件时间线。
  • 合并 PR 或上线前,想先概括 `docker-compose`、环境配置类文件的启用项与连接目标,而不是逐行硬读。
  • 拿到未写说明的 CSV/JSON 样本文件,需要先确认字段结构、数据量和明显异常值,再写清洗或分析脚本。

适合人员

  • 刚接手维护期后端项目的工程师,典型诉求是在不误改依赖的前提下快速定位主流程与入口函数。
  • 值班 SRE 或平台运维,告警后需要在海量滚动日志里归纳重复异常类型与首发时间点。
  • 负责内部规范或设计文档的技术写作者,修订前需要把长篇 Markdown 压缩成可对照的章节与结论。
  • 发布前自查的 DevOps,想确认 Shell/Bat 部署脚本会改哪些目录、依赖什么环境变量与输入输出。