写一个整理资料的 Skill

先想清楚要它做什么

整理资料时，真正要留下的通常就三样：结论、依据、还没弄明白的地方。这些要求如果每次都得重新跟 AI 交代一遍，不如写成一个 Skill。

先只做摘要这一件事，联网搜索、翻译、发布都不加。范围小一点，哪里出了问题也好查。

Agent Skills 概述里的说法是：Skill 就是一个文件夹，里面放任务说明，需要的话再放些脚本和参考资料。

创建 source-brief/SKILL.md

新建一个 source-brief 文件夹，里面放 SKILL.md。按格式规范，文件开头是一段 YAML，后面是 Markdown 正文。name 和 description 必填。name 要和文件夹同名，只能用小写字母、数字和连字符，连字符不能打头、不能结尾，也不能两个连着写。

---
name: source-brief
description: "把用户提供的单份材料整理成阅读卡片。用于资料摘要；不用于无原文的选题创作。"
---
# 资料摘要

1. 只使用用户提供的材料；没有原文时，请用户补充。
2. 记录标题、作者和日期；原文未提供的字段标为“未提供”。
3. 提炼不超过三条结论，每条附原文小节或段落位置。
4. 把事实、作者观点和待核实信息分开，不补写数据。
5. 输出以下结构，疑问不超过三项。

## 材料信息
## 核心结论与依据
## 还不能确定什么

交付前检查：每条结论都能在输入中找到支持；
没有依据的内容移入疑问，不用常识填空。

拿到输出后，挑几条结论回原文找找依据。找不到的，应该出现在“还不能确定什么”里，而不是混在结论中。

文件放在哪里

每个产品读取 Skill 的目录都不一样，先查清楚自己用的工具从哪里加载，再把整个文件夹放进去。光把正文复制到随便哪个笔记目录，工具是找不到的。别人写的 Skill，装之前也翻一下里面写了哪些操作。

这个摘要 Skill 用不上脚本。以后要批量处理或者导出固定格式，可以加一个 scripts/；参考资料太长，就放进 references/，再在正文里写清楚什么时候去读。这两个都是规范里的可选目录，用不到就别建。

试几条请求

找一段短材料，最好是自己很快就能核对的，然后在支持 Skill 的工具里试这三条：

1. 直接点名用 source-brief：看输出是不是那三段，结论能不能在原文里找到。
2. 不提名字，只说“把这份材料整理成阅读卡片”：看它会不会自己选中这个 Skill。没选中的话，多半是 description 没写到这类说法。
3. 说“没有材料，帮我编一篇人物专访”：这不是摘要任务。就算 Skill 被加载了，它也应该先让你提供原文。

每次记下用的原话、有没有触发、哪里不对。一次只改一处，再用同一份材料重试，这样才知道是哪处改动起了作用。

没生效时查哪里

完全找不到 Skill 的话，按顺序查：文件名是不是 SKILL.md，YAML 前后的分隔线有没有写全，文件夹名和 name 是否一致，工具实际扫描的是哪个目录。能加载、但结论没标依据，就回去改正文里的输出要求。

另外拿一份没写作者和日期的材料试试，看它会不会老老实实写“未提供”。正常材料能跑通，缺信息的材料也得单独试一次。