Synthèse automatique
Cette skill mène une recherche bibliographique, ouvre chaque source réellement trouvée, puis produit une note structurée dans notes/papers/<citekey>.md et ajoute une ligne d'index dans lit/literature-log.md.
Points forts
- Exige un DOI ou un arXiv ID issu de la recherche effective, ce qui bloque les références inventées
- Note normalisée avec sections fixes (problème, méthode, conclusions, lien au projet, points réutilisables, doutes)
- Dédoublonnage préalable via lit/literature-log.md, le dossier notes/papers/ et les MCP Zotero ou paper-search
- Exécution en contexte isolé (fork) : seule la liste des notes et un résumé court reviennent dans le fil principal
Limites
- Suppose une arborescence de projet existante (notes/papers/, lit/literature-log.md) que la skill ne crée pas
- Le rendu dépend fortement des outils disponibles : sans MCP ni accès web, la recherche échoue
- Ne produit pas de BibTeX ni de PDF, et laisse la vérification finale des chiffres cités à l'utilisateur
À utiliser quand il faut chercher des articles sur un sujet, analyser un papier précis via son DOI ou son URL, ou constituer une bibliographie traçable pour un projet.
À éviter pour une simple question factuelle, une reformulation de résumé déjà connu, ou lorsqu'aucun identifiant DOI/arXiv ne peut être obtenu pour les sources.
Analyse de sécurité
PrudenceThis is a legitimate literature-research workflow with clear file targets and no destructive commands, secret exfiltration, obfuscated payloads, or safety-disabling instructions. The use of network retrieval, subagents, and repository writes is powerful but appropriate for the stated task, so it warrants caution rather than a risky rating.
- •Uses WebSearch/WebFetch to retrieve external web content, which may expose the session to untrusted content or prompt injection.
- •Uses Write/Edit to create or append files under notes/papers/ and lit/literature-log.md; scope is intentional but it can modify repository content.
- •May invoke Task subagents and configured MCP literature tools, expanding the tool surface; no destructive or exfiltration instructions are present.
Exemples
/lit diffusion policy for robot manipulation — find the main papers from the last two years and file the relevant ones./lit 10.48550/arXiv.2405.12345 — read it and add a note with how it relates to our project./lit 找一下 sim-to-real transfer 里关于域随机化的代表作,先查我们库里是不是已经有了。name: lit description: "文献调研入库:检索论文、产出 notes/papers/<citekey>.md 结构化笔记并追加 lit/literature-log.md 索引。引用必须来自真实检索结果并附 DOI 或 arXiv ID。查文献、读某篇论文、找相关工作时用。" argument-hint: "[主题,或论文 URL / DOI / arXiv ID]" context: fork background: false allowed-tools: Read, Write, Edit, Glob, Grep, Task, WebSearch, WebFetch
文献调研入库
对象:$ARGUMENTS
本 skill 在隔离子上下文中运行:检索过程产生的大量原文不会污染主 context, 只有最终的笔记路径和几行摘要会回到主线程。
为什么显式写
background: false:Claude Code 2.1.x 起context: fork的 skill 默认后台运行。 本 skill 的产出是给用户当场看的结构化摘要(入没入库、哪几篇、为什么不入), 后台跑会让这份摘要变成一条事后通知,用户当下拿不到判断依据,也就没法接着决定要不要读原文。 隔离 context 要保留,后台不要——所以 fork 保留、background 显式关掉。
第 1 步 检索
按顺序选工具,能用前面的就别用后面的:
- 已配置的 MCP ——
zotero(本地库里可能已经有了,先查重)、paper-search、semantic-scholar。先看当前会话有哪些 MCP 工具可用。 - WebSearch / WebFetch —— 没有 MCP 时用。搜到之后必须实际打开页面确认, 不能只凭搜索结果摘要。
主题较宽(要一次覆盖 5 篇以上)时,派 lit-reviewer subagent 并行检索,
每个 subagent 负责一个子问题,回报「标题 + 年份 + DOI/arXiv ID + 三行摘要」。
传入的是 URL / DOI / arXiv ID 时跳过检索,直接取那一篇。
先在 lit/literature-log.md 和 notes/papers/ 里查一遍,已经入过库的直接说明并停止,
不要重复写一遍笔记。
第 2 步 写笔记
路径 notes/papers/<citekey>.md。citekey 用 作者姓+年份+首个实词,全小写,如 chen2024diffusion。
---
citekey: chen2024diffusion
title: <论文完整标题>
authors: [Chen Wei, Li Ming]
year: 2024
venue: NeurIPS 2024
doi: 10.48550/arXiv.2405.12345
tags: [diffusion-policy, manipulation]
status: read
read_date: 2026-07-22
---
## 核心问题
作者要解决什么。一句话说清,不要抄摘要。
## 方法
怎么做的。够我以后不重读原文也能复述的程度,但不要抄公式堆砌。
## 关键结论
- 论文报告的主要结果(带数字和数据集名)
- 消融里真正有信息量的那一两条
## 与本项目的关系
为什么把它入库。它支持 / 反对 / 补充了我们的哪个判断。
无关就不该入库——直接说不相关然后停。
## 可复用的点
- 具体到「哪个 trick 可以直接拿来用在哪个模块」
- 有官方代码就写仓库地址
## 存疑
- 实验设置里可疑的地方、结论外推得太远的地方
- 我没看懂、需要再确认的部分
status 取 read / skimmed / queued。只扫了摘要就写 skimmed,不要写 read。
第 3 步 更新索引
往 lit/literature-log.md 的表格追加一行。列顺序是固定契约,照抄,不要自己排:
| citekey | 标题 | 年份 | 状态 | 与本项目的关系 | 笔记路径 |
| --- | --- | --- | --- | --- | --- |
| chen2024diffusion | <短标题> | 2024 | 精读 | <半句话,实质关联> | notes/papers/chen2024diffusion.md |
「状态」列用中文取值 待读 / 略读 / 精读 / 已复现 / 已弃,与笔记 frontmatter 的
status 对应:queued→待读,skimmed→略读,read→精读。两边必须一致。
一篇一行,只 append。文件不存在才新建(带表头);已存在就只在表格末尾加行,不要重排既有行。
硬约束
- 引用必须来自本次真实检索结果,并且带 DOI 或 arXiv ID。没有标识符的条目不入库。
- 严禁凭记忆生成 BibTeX、标题、作者、年份或页码。 训练数据里的文献信息足够 似是而非到骗过 review,这是本模板最不能容忍的一类错误。
- 找不到就明说找不到:「检索了 <关键词>,在 <工具> 里没有找到匹配的论文」。 不要给一个「大概是这篇」的猜测,也不要给凑出来的标题。
- 数字(论文报告的指标)必须能指到原文的表/图编号,写进笔记时注明出处,如
(Table 3)。记不清就不写。 - 笔记里区分「论文说的」和「我的判断」。后者写在「存疑」和「与本项目的关系」里,
并标
[AI-DRAFT]。
回到主线程时输出
只回报三样,别把检索原文带回去:
- 新建/更新了哪些
notes/papers/*.md - 每篇一行:citekey + 与本项目的关系
- 明确列出「检索了但没入库」的和原因(不相关 / 找不到全文 / 已存在)
Du fichier au premier essai
Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.
Consulter la source et ses fichiers annexesCe téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.
1. Télécharger le fichier
Télécharger SKILL.mdDepuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/literature-research-and-structured-notes-ms47vqax/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.
Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.
mkdir -p '.skill-downloads/literature-research-and-structured-notes-ms47vqax' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/literature-research-and-structured-notes-ms47vqax/download' --output '.skill-downloads/literature-research-and-structured-notes-ms47vqax/SKILL.md.part' && mv '.skill-downloads/literature-research-and-structured-notes-ms47vqax/SKILL.md.part' '.skill-downloads/literature-research-and-structured-notes-ms47vqax/SKILL.md'2. Vérifier les prérequis
Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.
Outils déclarés par l’auteur (à vérifier dans votre agent) : Read, Write, Edit, Glob, Grep, Task, WebSearch, WebFetch
Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.
Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.
3. Charger la skill
Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.
Claude Code
test -f '.skill-downloads/literature-research-and-structured-notes-ms47vqax/SKILL.md' && test -s '.skill-downloads/literature-research-and-structured-notes-ms47vqax/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/lit' && cp -R '.skill-downloads/literature-research-and-structured-notes-ms47vqax' '.claude/skills/lit'OpenSkills
OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.
Installation officielle d’OpenSkillsopenskills install './.skill-downloads/literature-research-and-structured-notes-ms47vqax'openskills read 'literature-research-and-structured-notes-ms47vqax'La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.
Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.
openskills syncMode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.
4. Faire un premier essai
Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :
Lis .skill-downloads/literature-research-and-structured-notes-ms47vqax/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.
Rédaction de docs Supabase
Documentation
Rédigez, éditez et révisez le contenu de la documentation Supabase : guides, tutoriels, références et partiels. Suivez les guides de style et les règles de validation MDX/TOML.
Créer un enregistrement de décision d'architecture
Documentation
Créer un nouveau ADR avec numérotation séquentielle, l'enregistrer dans le graphe AgentDB et le lier aux ADR associés.
Mise à jour de plan avec recherche approfondie
Documentation
Met à jour un document de plan en lançant des sous-agents en parallèle pour analyser un sujet sur tous les passes du compilateur, puis consolide les résultats.