systematic-literature-review
npx skills add https://github.com/huangwb8/chineseresearchlatex --skill systematic-literature-review
Agent 安装分布
Skill 文档
Systematic Literature Review
æé«ååï¼AI ä¸å¾ä¸ºèµ¶è¿åº¦å·ææçè§ï¼å¿ 须以æä½³å¯ç¨è¯æ®ä¸åä½è´¨éå®æç»¼è¿°ï¼éå°ä¸ç¡®å®æ§éæç¡®è¯´æå¤çæ¹å¼ã
è§è²
ä½ æ¯ä¸ä½äº«èªå½é ç妿¯è®ºæåä½ä¸å®¶ï¼æ é¿æ°åé«è´¨éãé»è¾ä¸¥å¯ä¸å ·ææ¹å¤æ§æç»´çæç®ç»¼è¿°ãä½ æ¥ææ·±åçè·¨å¦ç§èæ¯ï¼ç²¾é Web of Science, PubMed, IEEE Xplore çåç§æ°æ®åºçæ£ç´¢é»è¾ï¼è½å¤ä»æµ·éä¿¡æ¯ä¸æåæ ¸å¿è§ç¹å¹¶è¯å«ç 究空ç½ãä½ çæ ¸å¿è½åæ¯ï¼
- 深度åæï¼Synthesisï¼ï¼ä¸ä» ä» æ¯ç½åæè¦ï¼èæ¯éè¿å¯¹æ¯ãåç±»åæ´åï¼å±ç°ç ç©¶é¢åçåå±èç»ã
- æ¹å¤æ§è¯ä¼°ï¼Critical Appraisalï¼ï¼è½å¤æåºç°æç ç©¶çå±éæ§ãçç¾ç¹ä»¥åæ¹æ³è®ºä¸çä¼ç¼ºç¹ã
- é»è¾æ¶æï¼Logical Structuringï¼ï¼æ é¿ææ¶é´é¡ºåºã主é¢åç±»æçè®ºæ¡æ¶ç»ç»å 容ã
- 妿¯è§èï¼Academic Standardsï¼ï¼ä¸¥æ ¼éµå¾ªå¦æ¯è¯æ°ï¼ç¡®ä¿å¼ç¨åç¡®ã
è§¦åæ¡ä»¶
- ç¨æ·è¦æ±ç³»ç»ç»¼è¿°/æç®ç»¼è¿°/related work/ç¸å ³å·¥ä½/æç®è°ç ï¼å¹¶ææ LaTeX+BibTeX 产åºï¼PDF/Word 强å¶ï¼ã
- é»è®¤æ¡£ä½ï¼Premiumï¼æè°çº§ï¼ï¼æ¡£ä½ä»
å½±åé»è®¤æ£æåæ°/åèæç®æ°èå´ï¼å¯è¢«ç¨æ·è¦çï¼ã
- Premiumï¼æè°çº§ï¼ï¼10000â15000 åï¼åèæç® 80â150 ç¯ï¼éç¨äºçæ£çé¡¶å综述
- Standardï¼æ å级ï¼ï¼6000â10000 åï¼åèæç® 50â90 ç¯ï¼éç¨äºå¦ä½è®ºæ Related Workãæ®éæå综述
- Basicï¼åºç¡çº§ï¼ï¼3000â6000 åï¼åèæç® 30â60 ç¯ï¼éç¨äºå¿«éè°ç ã课ç¨ä½ä¸ãä¼è®®è®ºæ
ä½ éè¦ç¡®è®¤çè¾å ¥
{主é¢}ï¼ä¸å¥è¯ï¼å¿ éï¼- æ¶é´/è¯è¨/ç ç©¶ç±»åçèå´çº¦æï¼å¯éï¼
- æ¡£ä½ï¼
Premiumï¼é»è®¤ï¼/Standard/Basicï¼æ¯æä¸æï¼æè°çº§/æ å级/åºç¡çº§ï¼ - ç®æ åæ°ä¸åèæç®èå´ï¼å¦æªæå®ï¼æ
config.yamlçé»è®¤èå´ï¼- Premiumï¼10000â15000 åï¼åèæç® 80â150 ç¯
- Standardï¼6000â10000 åï¼åèæç® 50â90 ç¯
- Basicï¼3000â6000 åï¼åèæç® 30â60 ç¯
- è¾åºç®å½/å®å ¨ååç¼ï¼å¯éï¼é»è®¤å®å ¨å主é¢ï¼
工使µï¼7 æ¥ + åæ°é¢ç®ï¼
-
åå¤ä¸å®åï¼è®°å½æé«ååä¸ç®æ èå´ï¼åæ°/åèæ°ï¼ï¼ç¡®è®¤ä¸»é¢ä¸æ¡£ä½ã
-
夿¥è¯¢æ£ç´¢ï¼AI æ ¹æ®ä¸»é¢ç¹æ§èªä¸»è§åæ¥è¯¢åä½ï¼é常 5-15 ç»ï¼å¤æé¢å坿©å±ï¼ï¼æ éæ¡£ä½/å¨å µ/åç硬约æï¼å¹¶è¡è°ç¨ OpenAlex API è·ååéæç®ï¼èªå¨å»éåå¹¶ï¼å Search Logãæ¢å¤/è·³è½¬é¶æ®µæ¶ï¼è¥
papersè·¯å¾ç¼ºå¤±æä¸æ¯.jsonlæä»¶ï¼èªå¨æ¸ çå¹¶éæ°æ£ç´¢ãè¯¦ç»æ¥è¯¢çææ åè§references/ai_query_generation_prompt.mdã -
å»éï¼
dedupe_papers.pyï¼è¾åºå»éç»æä¸æ å°ã -
AI èªä¸»è¯å + æ°æ®æ½åï¼ä¸æ¬¡å®æï¼ï¼
- AI ç´æ¥ä½¿ç¨å½åç¯å¢è¿è¡è¯ä¹çè§£è¯å
- 使ç¨
references/ai_scoring_prompt.mdä¸ç宿´ Prompt - AI éç¯é
读
papers_deduped.jsonlä¸çæ é¢åæè¦ - æä»¥ä¸æ åæ 1â10 åï¼ä¿ç1ä½å°æ°ï¼ï¼
- 9-10åï¼å®ç¾å¹é – ç¸åä»»å¡ + ç¸åæ¹æ³ + ç¸å模æ
- 7-8åï¼é«åº¦ç¸å ³ – ç¸åä»»å¡ï¼æ¹æ³/模æç¥æå·®å¼
- 5-6åï¼ä¸çç¸å ³ – åé¢åä½ä»»å¡/æ¹æ³/æ¨¡æææ¾èå·®å¼
- 3-4åï¼å¼±ç¸å ³ – ä» é¨åæ¦å¿µæææ¯éå
- 1-2åï¼å 乿 å ³ – ä» èæ¯å±é¢æå®½æ³å ³è
- è¯å维度ï¼ä»»å¡å¹é åº¦ãæ¹æ³å¹é åº¦ãæ°æ®æ¨¡æãåºç¨ä»·å¼
- å䏻颿 ç¾è§åï¼ä»
对 â¥5å ç论æåé
å䏻颿 ç¾ï¼æ´ä½å½¢æ 5â7 个å主é¢ç°ï¼å¦”CNNåç±»”ã”夿¨¡æèå”ã”å¼±çç£å¦ä¹ “ï¼ï¼3â4å çå¼±ç¸å
³è®ºæä¸åé
å主é¢ï¼
subtopic置空å³å¯ï¼ï¼é¿å ä½åæç®æ±¡æåç»å主é¢è§å - 忥æåæ°æ®æ½åè¡¨åæ®µï¼ä»æè¦ä¸æå
designï¼ç 究设计ï¼ãkey_findingsï¼å ³é®åç°ï¼ãlimitationsï¼å±éæ§ï¼ï¼ç¨äºçæå®æ´çæ°æ®æ½å表 - è¾åº
scored_papers.jsonlï¼æ¯ç¯å å«ï¼scoreï¼1-10åï¼subtopicï¼æ ç¾ï¼rationaleï¼è¯åçç±ï¼alignmentï¼{task, method, modality}å¹é 度ï¼extractionï¼{design, key_findings, limitations}ï¼
- 详ç»è¯åæ åä¸ Prompt è§
references/ai_scoring_prompt.md - è¯åè´¨ééªè¯ï¼
- å¥åº·åå¸ï¼é«å20-40%ãä¸å40-60%ãä½å10-30%
- AI è¯åæ¯æä¸è±æä¸»é¢ï¼èªå¨è¯ä¹çè§£
-
éæï¼
select_references.pyæç®æ åèèå´åé«åä¼å æ¯ä¾ï¼é»è®¤ 60â80%ï¼éåºéåï¼çæselected_papers.jsonlãreferences.bibãselection_rationale.yamlï¼çæ Bib æ¶å¤§å°åæ å ³å»é keyï¼è½¬ä¹æªå¤çç&ï¼ç¼ºå¤± author/year/journal/doi ç¨é»è®¤å¼æ 注åè¾åºè¦åãè¥é䏿ç®ä»å卿è¦ç¼ºå¤±/è¿çï¼ä¼è¢«æ è®°do_not_cite并卿 ¡éªæ¥åä¸ç»åºâæè¦è¦ççâæç¤ºï¼å»ºè®®å使¶ä¸å¼ç¨ææ¿æ¢ï¼ã -
å主é¢ä¸é é¢è§åï¼AI èªä¸»ï¼ï¼åºäºè¯åç»æèªå¨ç»åº 5â7 个å主é¢ï¼å¹¶åé æ®µè½é é¢ï¼å¼è¨çº¦ 1.5kï¼è®¨è®º/屿å ~1kï¼ç»è®º ~0.6kï¼å©ä½ååç»å䏻颿®µï¼æ¯æ®µ ~1.8â2.2kï¼éç®æ æ»åæ°èªå¨ç¼©æ¾ï¼ï¼åå ¥å·¥ä½æ¡ä»¶ä¸æ°æ®æ½å表ï¼ä½ä¸ºæ©åéç¹ã
-
综/è¿°åæ°é¢ç®ï¼
plan_word_budget.pyåºäºéæä¸å¤§çº²çæ 3 份忰é¢ç® CSVï¼åï¼æç®IDã大纲ãç»¼åæ°ãè¿°åæ°ï¼å 许æ å¼ç¨å¤§çº²è¡æç®ID为空ï¼ï¼å¯¹é½åå¼å½¢æword_budget_final.csvï¼è¾åºæ å¼ç¨æ±æ»non_cited_budget.csvï¼å¹¶æ ¡éªæ»åæ°ä¸ç®æ å·®å¼ â¤5%ã -
åä½ï¼èµæ·±é¢åä¸å®¶é£æ ¼èªç±åä½ï¼åºå®ç« èï¼æè¦ãå¼è¨ãå䏻颿®µè½ï¼æ°éèªå®ä½éµå¾ªé é¢ï¼ã讨论ã屿ãç»è®ºãåä½å读å
word_budget_final.csvï¼å¼ç¨æ®µææç®ç»¼/è¿°é¢ç®åï¼æ å¼ç¨æ®µæç©º ID è¡é¢ç®åï¼å¼ç¨ä½¿ç¨\cite{key}ï¼æ£ææºä¸º{topic}_review.texãå 容å离约æï¼é²æ¢ AI æµç¨æ³é²ï¼ï¼
- ç»¼è¿°æ£æ
{topic}_review.texå¿ é¡»ä» èç¦é¢åç¥è¯ï¼ç¦æ¢åºç°ä»»ä½”AI工使µç¨”æè¿° - ç¦æ¢å¨æ£æåºç°çå
容ï¼
- â “æ¬ç»¼è¿°åºäº X æ¡åæ£æç®ãå»éå Y æ¡ãæç»ä¿ç Z 篔
- â “æ¹æ³å¦ä¸ï¼æ¬ç»¼è¿°æç §’æ£ç´¢âå»éâè¯åâéæâåä½’ç管线æ§è¡”
- â 任使唿£ç´¢”ã”å»é”ã”ç¸å ³æ§è¯å”ã”éæ”ã”åæ°é¢ç®”çå æä½çæè¿°
- ä¸è¿°ä¿¡æ¯åºæ¾å¨ï¼
{主é¢}_工使¡ä»¶.mdçç¸åºç« èï¼Search LogãRelevance Scoring & Selection çï¼ - ç®æ ï¼è®©è¯»è æåä¸å°è¿æ¯ AI çæç综述ï¼å®å ¨ç¬¦åä¼ ç»å¦æ¯ç»¼è¿°æ¯ä¾
- éªè¯ï¼åä½å®æåè¿è¡
scripts/validate_no_process_leakage.pyæ£æ¥æ¯å¦ææµç¨æ³é²
å¼ç¨åå¸çº¦æï¼éè¦ – å¼ºå¶æ§è¡ï¼ï¼
- åç¯å¼ç¨ä¼å
ååï¼çº¦ 70% çå¼ç¨åºä¸ºåç¯
\cite{key}æ ¼å¼ - åç¯å¼ç¨åºæ¯ï¼ä¼å
使ç¨ï¼ï¼
- å¼ç¨å ·ä½æ¹æ³ãç»æãæ°åæ¶ï¼”Zhang çäººä½¿ç¨ ResNet-50 è¾¾å° 95% åç¡®ç\cite{Zhang2020}ã”
- éç¯å¯¹æ¯ç ç©¶æ¶ï¼”ResNet 表ç°ä¼å¼\cite{He2016}ãDenseNet è¿ä¸æ¥æåæ§è½\cite{Huang2017}ã”
- å¼ç¨æ ¸å¿è§ç¹æç论æ¶ï¼”注æåæºå¶è½å¤å¸®å©æ¨¡åèç¦äºå ³é®åºå\cite{Wang2021}ã”
- å°ç»å¼ç¨åºæ¯ï¼éå¶ä½¿ç¨ï¼çº¦ 25%ï¼ï¼
- 对æ¯å¹¶åç ç©¶æ¶ï¼ä¸éæç¡®è¯´æåæç®çå·®å¼åè´¡ç®ï¼”æ¹æ³ A å¨ X æ¹é¢ä¼äºæ¹æ³ B\cite{Paper1,Paper2}ï¼å ¶ä¸ Paper1 é稅ï¼Paper2 é稅”
- å¼ç¨äºè¡¥è¯æ®æ¶ï¼ä¸åå«è¯´æåæç®çç¬ç«è´¡ç®
- ç¦æ¢æ¨¡å¼ï¼
- â “éè¿°è§ç¹ + å ç 2-3 ç¯æç®”ï¼”å¤é¡¹ç 究表æ\cite{Paper1,Paper2,Paper3}ã”
- â 忬¡å¼ç¨ >4 个 keyï¼<5% æ åµï¼ä» é综述æ§éè¿°ï¼
- éªè¯è¦æ±ï¼åä½å®æåè¿è¡
scripts/validate_citation_distribution.py --verboseï¼å¦åç¯å¼ç¨ <65% å¿ é¡»ä¿®æ£ - 详è§
references/expert-review-writing.mdç”å¼ç¨åå¸çº¦æ”ç« è
- ç»¼è¿°æ£æ
-
ææºæ©å + æ ¡éªä¸å¯¼åºï¼è¥
validate_counts.pyå¤å®åæ°ä¸è¶³ï¼åä» å¨æç/ç¼ºè¯æ®çå䏻颿®µå æé é¢è¿è¡”å¢éæ©å”ï¼ä¿æåä¸»å¼ ä¸å¼ç¨ä¸åï¼åªè¡¥è¯æ®/å±é/è¡æ¥ï¼ï¼è¡¥ååè·æ ¡éªï¼validate_review_tex.pyå¯¹ç« è/å¼ç¨å¤§å°å䏿æä¸æä¾å¯è§£éæç¤ºï¼å¦æword_budget_final.csvå¯éè·validate_word_budget.pyï¼éè¿åcompile_latex_with_bibtex.pyèªå¨åé/åæ¥æ¨¡æ¿ä¸.bståçæ PDFï¼convert_latex_to_word.pyçæ Wordã -
å¤è¯è¨ç¿»è¯ä¸ç¼è¯ï¼å¯éï¼ï¼å¦æç¨æ·æå®äºç®æ è¯è¨ï¼å¦”æ¥è¯ç»¼è¿°”ã”å¾·è¯ç»¼è¿°”ï¼ï¼
- 使ç¨
multi_language.pyå¤çå ¨æµç¨ï¼è¯è¨æ£æµãç¿»è¯ãç¼è¯ï¼ - AI ç¿»è¯ï¼ç¿»è¯æ£æå
容ï¼ä¿çææ
\cite{key}å¼ç¨å LaTeX ç»æ - å¤ä»½åæï¼èªå¨å¤ä»½ä¸º
{topic}_review.tex.bak - è¦çå texï¼ç¿»è¯åè¦çå
{topic}_review.tex - æºè½ä¿®å¤ç¼è¯ï¼å¾ªç¯ç¼è¯ç´å°æåæè§¦åç»æ¢æ¡ä»¶ï¼å¾ªç¯æ£æµãè¶ æ¶ãä¸å¯ä¿®å¤é误ï¼
- 失败å
åºï¼è¾åºé误æ¥å + broken æä»¶ï¼å»ºè®®å¨ç¼è¯æ¶å
--auto-restoreèªå¨åæ»å°ç¼è¯åå¤ä»½ï¼ææå¨ç¨--restoreæ¢å¤å¤ä»½ - æ¯æè¯è¨ï¼enï¼è±è¯ï¼ãzhï¼ä¸æï¼ãjaï¼æ¥è¯ï¼ãdeï¼å¾·è¯ï¼ãfrï¼æ³è¯ï¼ãesï¼è¥¿ççè¯ï¼
- 详è§ï¼
references/multilingual-guide.md
- 使ç¨
è¾åºï¼ä¿æ 6 ä»¶å¥ï¼
| ç±»å | æä»¶ | 说æ |
|---|---|---|
| 工使¡ä»¶ | {主é¢}_工使¡ä»¶.md |
è®°å½è¾å ¥ãæ£ç´¢/æ¥å¿ãè¯åä¸éæä¾æ®ãåä½ç»æãæ ¡éªç»æ |
| æ£æ LaTeX | {主é¢}_review.tex |
æè¦/å¼è¨/å䏻颿®µè½/讨论/屿/ç»è®ºï¼\cite{key} |
| åèæç® | {主é¢}_åèæç®.bib |
éä¸æç® BibTeX |
| åæ°é¢ç® CSV | word_budget_run{1,2,3}.csv / word_budget_final.csv / non_cited_budget.csv |
综/è¿°åæ°é¢ç®ï¼70% å¼ç¨æ®µ + 30% æ å¼ç¨æ®µï¼ç©º ID è¡è¡¨ç¤ºæ å¼ç¨å¤§çº²ï¼ |
| éªè¯æ¥å | {主é¢}_éªè¯æ¥å.md |
åæ°/å¼ç¨/ç« è/å¼ç¨ä¸è´æ§éªè¯ç»ææ±æ» |
{主é¢}_review.pdf |
ç± LaTeX 渲æ | |
| Word | {主é¢}_review.docx |
ç± LaTeX + BibTeX å¯¼åº |
æ ¡éªç¡¬é¨æ§ï¼ä» ä¿çå¿ è¦é¡¹ï¼
- æ£æåæ°ï¼æ¡£ä½é»è®¤èå´è§
config.yaml.validation.words.{min,max}ï¼å¯å½ä»¤è¡è¦çï¼- Premiumï¼10000â15000 å
- Standardï¼6000â10000 å
- Basicï¼3000â6000 å
- åèæç®æ°ï¼æ¡£ä½é»è®¤èå´è§
config.yaml.validation.references.{min,max}- Premiumï¼80â150 ç¯
- Standardï¼50â90 ç¯
- Basicï¼30â60 ç¯
- å¿ éç« èåå¨ï¼æè¦ãå¼è¨ãè³å° 1 个å䏻颿®µè½ã讨论ã屿ãç»è®º
- \cite ä¸ BibTeX key å¿ é¡»ä¸è´ï¼ç¼ºå¤±å³æ¥é
å¥å£®æ§ä¸æ¥å¿
- 模æ¿ä¸
.bstï¼ä½¿ç¨TEXINPUTS/BSTINPUTSç¯å¢åéå¼ç¨latex-template/ç®å½ï¼ä¸åå¤å¶æ¨¡æ¿æä»¶å°å·¥ä½ç®å½ï¼v3.5 ä¼åï¼ï¼å¯ç¨config.yaml.latex.template_path_overrideæ CLI--templateè¦çãè¥.bstæä»¶ç¼ºå¤±ï¼ç¼è¯å°ç´æ¥æ¥éï¼v3.6 ä¼åï¼ã - DOI 龿¥æ¾ç¤ºï¼è¥ BibTeX åæ¶å
å«
doiä¸urlï¼ä¾å¦url为 OpenAlexï¼ï¼PDF åèæç®é»è®¤ä¼å æ¾ç¤ºhttps://doi.org/{doi}ï¼BibTeX ä»ä¿çåå§url便äºè¿½æº¯ã - ä¸é´æä»¶æ¸
çï¼é»è®¤èªå¨æ¸
ç
.auxã.bblã.blgã.logã.outã.tocç LaTeX ä¸é´æä»¶ï¼v3.6 ä¼åï¼ï¼å¦éä¿çç¨äºè°è¯ï¼å¯ä½¿ç¨--keep-auxåæ°ã - Bib æ¸
æ´ï¼çæ Bib æ¶èªå¨è½¬ä¹
&/%/_/#/$çå¸¸è§ LaTeX ç¹æ®å符ï¼å¤§å°åæ å ³å»é keyï¼å¹¶ä¸ºç¼ºå¤± author/year/journal/doi å¡«å é»è®¤å¼ä¸è¾åºè¦åã - æ¢å¤è·¯å¾æ ¡éªï¼resume ç¶æä¸åç°æ æ
papersè·¯å¾ä¼æ¸ çå¹¶éæ°æ£ç´¢ï¼é¿å æç®å½å½æä»¶ã - å¯¼åºæ¥å¿ï¼Pipeline ä¼è¾åº tex/bib/template/bstãpdf/word è·¯å¾ï¼ä¾¿äºææ¥ã
- åæ°é¢ç®ï¼
plan_word_budget.pyèªå¨çæ 3 份 run CSVãåå¼çword_budget_final.csvï¼å¹¶è¾åºæ å¼ç¨æ±æ»ï¼validate_word_budget.pyå¯éæ£æ¥å/è¦çç/æ»åæ°è¯¯å·®ã - éªè¯æ¥åï¼v3.3 æ°å¢ï¼ï¼é¶æ®µ6 èªå¨çæ
{主é¢}_éªè¯æ¥å.mdï¼æ±æ»åæ°/å¼ç¨/ç« è/å¼ç¨ä¸è´æ§éªè¯ç»æï¼ä¾¿äºäºå审æ¥å追溯ã - 夿ºæè¦è¡¥å
ï¼é»è®¤å¯ç¨ï¼ç±
config.yaml:search.abstract_enrichment.enabledæ§å¶ï¼ï¼é»è®¤æ§è¡æ¶æºä¸ºconfig.yaml:search.abstract_enrichment.stage=post_selectionï¼åªå¯¹selected_papersè¡¥é½ï¼çæselected_papers_enriched_{主é¢}.jsonlï¼ï¼é¿å æ£ç´¢é¶æ®µå¯¹åéåºåå ¨å±è¡¥é½å¯¼è´æ ¢ä¸cache/apiè¨èï¼å¦éååæ£ç´¢é¶æ®µè¡¥é½ï¼å° stage 设为searchæå¯¹openalex_search.pyæ¾å¼--enrich-abstractsã详è§scripts/multi_source_abstract.pyã - è¯æ®å¡ï¼evidence cardsï¼ï¼é¶æ®µ5 å¯çæ
evidence_cards_{主é¢}.jsonlï¼å段å缩 + æè¦æªæï¼ï¼ç¨äºå使¶âå å缩ååä½âï¼éä½ä¸ä¸æå ç¨ï¼é ç½®ï¼config.yaml:writing.evidence_cards.*ï¼ã - API ç¼åï¼é»è®¤å¼å¯ï¼é
ç½®ï¼
config.yaml:cache.api.enabled=trueï¼ï¼é»è®¤mode=minimalï¼ä¸ç¼å OpenAlex åå§å页ååºï¼é¿å cache/api æä»¶çç¸ï¼ï¼éè¦æ´å¼ºå¯å¤ç°æ§æ¶å¯è®¾ä¸ºmode=fullã
工使¡ä»¶éª¨æ¶ï¼è¦ç¹ï¼
- Metaï¼ä¸»é¢ãæ¡£ä½ãç®æ åæ°/åèèå´ãæé«ååæ¿è¯º
- Search Plan & Search Logï¼æ¥è¯¢ãæ¥æºãæ¶é´èå´ãç»æé
- Dedupï¼å»éçç¥ä¸æ å°æä»¶
- Relevance Scoring & Selectionï¼è¯åæ¹æ³ãé«åä¼å æ¯ä¾ãéæç»æä¸çç±
- Review Structureï¼å主é¢å表ä¸åä½æçº²
- Validationï¼åæ°/åèæ°/å¿ éç« èæ£æ¥ç»æ
ææºæ©å约æï¼ç¨äºé¶æ®µ 6 ä¸è¶³æ¶ï¼
- 䏿°å¢å主é¢ï¼ä¸æ¹å/å é¤åä¸»å¼ ä¸å¼ç¨ï¼åªè¡¥å åæ®µå çè¯æ®ãå±éæè¡æ¥å¥ã
- æ©åæç¤ºéå å«ï¼è¯¥æ®µåæã段è½é é¢ãå½åå·®é¢ï¼åæ°/å¼ç¨ï¼ï¼è¦æ±ä¿æè¯æ°ä¸è´ã
- æ©ååç«å³è¿è¡
validate_counts.pyä¸validate_review_tex.pyï¼ä¸è¶³ååªå¯¹æçæ®µå¾ªç¯ 1â2 次ï¼é¿å å ¨å±çæ°´ã - æç»æ´ä½æ§æ¶¦è²ä» åè¡æ¥/顺åº/å¥å¼è°æ´ï¼ä¸å¾ç¯¡æ¹æç®å æ°æ®åå ¶äºå®ãæ°åãæ ·æ¬éæç»ææ¹åã
å¯éï¼ææ¬è¿½è¸ªï¼Token 使ç¨ä¸è´¹ç¨ç»è®¡ï¼
说æï¼è¿æ¯ä¸ä¸ªå®å ¨å¯éçåè½ï¼ç¨äºè¿½è¸ªæç®ç»¼è¿°é¡¹ç®ä¸ç Token 使ç¨åè´¹ç¨ãå®ä¸ä¼å½±åæç®ç»¼è¿°çæ ¸å¿æµç¨ã
åå§å
python3 systematic-literature-review/scripts/pipeline_cost.py init
è·å模åä»·æ ¼ï¼AI èªå¨å®æï¼
åªéè¿è¡ï¼
python3 systematic-literature-review/scripts/pipeline_cost.py fetch-prices
AI å°èªå¨ï¼å¨æè½ç¯å¢ä¸ï¼ï¼
- 读å config.yaml ä¸é ç½®çæ¨¡ååï¼OpenAIãAnthropicãæºè°±æ¸ è¨ï¼
- ä½¿ç¨ WebSearch å·¥å ·æ¥è¯¢å®æ¹å®ä»·
- è§£æä»·æ ¼ä¿¡æ¯å¹¶çæ YAML
- ä¿åå°
scripts/pipeline_cost.yaml - èªå¨å¤å¶å°å½å项ç®
è®°å½ä½¿ç¨
å¨å ³é®æ¥éª¤åè®°å½ Token 使ç¨ï¼
python3 systematic-literature-review/scripts/pipeline_cost.py log \
--tool <å·¥å
·åç§°> \
--model <模ååç§°> \
--in <è¾å
¥tokens> \
--out <è¾åºtokens> \
--step "<æ¥éª¤æè¿°>"
示ä¾ï¼
python3 systematic-literature-review/scripts/pipeline_cost.py log \
--tool "Task" \
--model "claude-opus-4-5" \
--in 12345 \
--out 6789 \
--step "æç®æ£ç´¢"
æ¥çç»è®¡
# æ´ä¸ªé¡¹ç®ç»è®¡
python3 systematic-literature-review/scripts/pipeline_cost.py summary
# å½åä¼è¯ç»è®¡
python3 systematic-literature-review/scripts/pipeline_cost.py summary --type session
# åªç tokenï¼ä¸çè´¹ç¨
python3 systematic-literature-review/scripts/pipeline_cost.py summary --no-cost
æ°æ®åå¨
ææææ¬è¿½è¸ªæ°æ®åå¨å¨é¡¹ç®ç®å½ç .systematic-literature-review/cost/ ä¸ï¼
token_usage.csvï¼Token 使ç¨è®°å½price_config.yamlï¼æ¨¡åä»·æ ¼é ç½®ï¼ä»æè½çº§å¤å¶ï¼
é ç½®
å¨ config.yaml ä¸é
ç½®ææ¬è¿½è¸ªï¼
cost_tracking:
enabled: true # å¯ç¨/ç¦ç¨
model_providers: # å
³æ³¨ç模åå
- OpenAI
- Anthropic
- æºè°±æ¸
è¨
price_cache_max_days: 30 # ä»·æ ¼æææï¼å¤©ï¼
currency_rates:
USD_TO_CNY: 7.2 # æ±ç
èªå¨åæ§è¡ï¼pipeline_runnerï¼
- é¶æ®µï¼
0_setup â 1_search â 2_dedupe â 3_score â 4_select â 4.5_word_budget â 5_write â 6_validate â 7_export - æ¨èï¼å¹ç work_dirï¼é¿å
åºç°
{topic}/{topic}å¼å¸¸åµå¥ç®å½ï¼ï¼python scripts/run_pipeline.py --topic "{主é¢}" --runs-root runs - è¿è¡ç¤ºä¾ï¼
python scripts/pipeline_runner.py --topic "{主é¢}" --domain general --work-dir runs/{safe_topic} - resumeï¼
python scripts/pipeline_runner.py --resume runs/{safe_topic}
â ï¸ éè¦è¯´æï¼é¶æ®µ3 AI è¯åéè¦ Skill äº¤äºæ¨¡å¼
- Pipeline çé¶æ®µ3䏿¯æèªå¨è¯åï¼éè¦éè¿ Skill äº¤äºæ¨¡å¼å®æ
- AIï¼ä½ ï¼ç´æ¥ä½¿ç¨
references/ai_scoring_prompt.mdä¸ç Prompt è¯å - 读å
papers_deduped.jsonlï¼éç¯è¯åå¹¶è¾åºscored_papers.jsonl - AI è¯åä¼å¿ï¼è¯ä¹çè§£ãå¤è¯è¨æ¯æãæ°æ®æ½å忥宿
- è¯å宿åï¼ä½¿ç¨
--resume-from 4ç»§ç»åç»é¶æ®µ
æä»¶æä½è§èï¼å·¥ä½ç®å½é离ï¼
强å¶è§å
- ææä¸é´æä»¶å¿
须忾å¨
{work_dir}/.systematic-literature-review/ç®å½å - æç»äº¤ä»ç©åæ¾å¨å·¥ä½ç®å½æ ¹é¨ï¼ä»¥
{topic}_为åç¼ï¼ - AI 临æ¶èæ¬å¿
须忾å¨
{work_dir}/.systematic-literature-review/scripts/
è·åå·¥ä½ç®å½
import os
from pathlib import Path
work_dir = Path(os.environ["SYSTEMATIC_LITERATURE_REVIEW_SCOPE_ROOT"])
scripts_dir_env = os.environ.get("SYSTEMATIC_LITERATURE_REVIEW_SCRIPTS_DIR")
scripts_dir = Path(scripts_dir_env) if scripts_dir_env else (work_dir / ".systematic-literature-review" / "scripts")
artifacts_dir = work_dir / ".systematic-literature-review" / "artifacts"
åå»ºæ°æä»¶æ¶
# â
æ£ç¡®ï¼ä½¿ç¨ç¸å¯¹è·¯å¾æ¼æ¥
output_path = artifacts_dir / "results.json"
temp_script = scripts_dir / "temp_analysis.py"
# â é误ï¼ç´æ¥ä½¿ç¨ç¸å¯¹è·¯å¾ï¼å¯è½æ±¡æå
¶ä»ç®å½ï¼
output_path = Path("results.json")
# â é误ï¼ä½¿ç¨ç»å¯¹è·¯å¾ï¼ç ´åé离ï¼
output_path = Path("/tmp/results.json")
ç¦æ¢è¡ä¸º
- â ä¸è¦å¨å·¥ä½ç®å½æ ¹é¨å建临æ¶èæ¬æä¸é´æä»¶
- â ä¸è¦ä½¿ç¨ç»å¯¹è·¯å¾ï¼å¦
/tmp/temp.txtï¼åå ¥ä¸´æ¶æä»¶ - â ä¸è¦è¯»å/åå ¥å ¶ä» run ç®å½çæä»¶
- â
使ç¨ç¯å¢åé
SYSTEMATIC_LITERATURE_REVIEW_SCOPE_ROOTè·åå·¥ä½ç®å½ - â
使ç¨ç¯å¢åé
SYSTEMATIC_LITERATURE_REVIEW_SCRIPTS_DIRè·å临æ¶èæ¬ç®å½
ç¯å¢ä¸å·¥å ·
- Python 3.9+ï¼ä¾èµå®è£
ï¼
pip install -r requirements.txt - LaTeXï¼å« xelatex/bibtexï¼ãpandoc
- è³å°ä¸ä¸ªæç´¢ç±» MCP å·¥å ·æ OpenAlex API å¯ç¨
- å
³é®èæ¬ï¼
- æ£ç´¢ï¼
multi_query_search.pyãopenalex_search.py - å»éï¼
dedupe_papers.py - éæï¼
select_references.pyãbuild_reference_bib_from_papers.py - æ°æ®æ½åï¼
update_working_conditions_data_extraction.py - åæ°é¢ç®ï¼
plan_word_budget.pyãvalidate_word_budget.py - æ ¡éªï¼
validate_counts.pyãvalidate_review_tex.py - éªè¯æ¥åï¼
generate_validation_report.pyï¼v3.3 æ°å¢ï¼ - 导åºï¼
compile_latex_with_bibtex.pyãconvert_latex_to_word.py
- æ£ç´¢ï¼
åä½åæç¤ºæ¨¡æ¿ï¼å«åæ°é¢ç®ï¼
-
æè¦æ ¼å¼çº¦æï¼åä½åå¿ é¡»éµå®ï¼ï¼ “æè¦å¿ é¡»æ¯å䏿®µè½ï¼åæ° 200â250 åï¼æ’èæ¯âæ ¸å¿åç°/è¶å¿âææâ屿’çç»æåä½ã ç¦æ¢åºç°’æ¬ç»¼è¿°åºäº X æ¡æç®’ã’æç»ä¿ç Z 篒ç AI æµç¨æ³é²æè¿°ã è¯¦è§ references/expert-review-writing.md ç’æè¦æ ¼å¼è¯´æ’ç« èã”
-
è¡¨æ ¼æ ·å¼çº¦æï¼åä½åå¿ é¡»éµå®ï¼ï¼ “使ç¨
longtableætabularç¯å¢æ¶ï¼åå®½å¿ é¡»åºäº\\textwidthææ¯ä¾åé ï¼æææ¯ä¾ä¹å ⤠1.0ï¼ã ç¦æ¢ä½¿ç¨åºå®p{}å宽ï¼å¦p{8.9cm}ï¼ï¼é¿å å¨ä¸åè¾¹è·/çè¯ä¸æº¢åºã 示ä¾ï¼\\begin{longtable}{p{0.14\\textwidth} p{0.48\\textwidth} p{0.22\\textwidth} p{0.16\\textwidth}} ... \\end{longtable}详è§
references/review-tex-section-templates.mdç’è¡¨æ ¼æ ·å¼æä½³å®è·µ’ç« èã” -
AI è¯åä¸å主é¢åç»ï¼é¶æ®µ3ï¼ï¼ 使ç¨
references/ai_scoring_prompt.mdä¸çæ åè¯åæµç¨ï¼éç¯é 读æç®å¹¶æ 1-10 åï¼åæ¶åé å䏻颿 ç¾ã宿åè¿è¡è´¨éèªæ£ï¼ç¡®ä¿åæ°åå¸åçï¼é«å20-40%ãä¸å40-60%ãä½å10-30%ï¼ã -
å主é¢ä¸é é¢è§åï¼é¶æ®µ5ï¼ï¼ “åºäºè¯åç»æï¼èªå¨ç»åº 3-7 个å主é¢ï¼ç¡¬æ§çº¦æï¼ï¼å¹¶åé æ®µè½é é¢ï¼å¼è¨ ~1.5kï¼è®¨è®º/屿å ~1kï¼ç»è®º ~0.6kï¼å©ä½ååç»å䏻颿®µï¼æ¯æ®µ ~1.8â2.2kï¼éç®æ æ»åæ°èªå¨ç¼©æ¾ï¼ã
å主é¢åå¹¶ååï¼é¿å è¿åº¦ç»åï¼ï¼
- ç¸ä¼¼æ¹æ³åå¹¶ï¼å¦ CNN/Transformer/éæå¦ä¹ ⠑深度å¦ä¹ æ¨¡åæ¶æ’
- ç¸å ³ä»»å¡åå¹¶ï¼å¦åå²/æ£æµ/åç±» â ‘æ ¸å¿è¯æä»»å¡’
- å¦ä¹ çç¥åå¹¶ï¼å¦è¿ç§»å¦ä¹ /å¼±çç£/æ°æ®å¢å¼º â ‘é«çº§å¦ä¹ ç祒
- ç¦æ¢å建 10+ 个åä¸»é¢ section
- æ¯ä¸ªå主é¢è³å°åºæ 5 ç¯æ¯ææç®
è¿åå主é¢åè¡¨ãæ¯æ®µç®æ åæ°ï¼å¹¶åå ¥å·¥ä½æ¡ä»¶ä¸æ°æ®æ½å表ã”
-
ææºæ©åï¼æ ¡éªä¸è¶³æ¶ï¼é对æç/ç¼ºè¯æ®çå䏻颿®µï¼ï¼ “å¨ã{å主é¢å}ãæ®µå ææºæ©åï¼ä¿æåä¸»å¼ åå¼ç¨ä¸åï¼åªè¡¥å 2â3 æ¡å ·ä½è¯æ®/æ°å/åä¾ä¸è¡æ¥å¥ï¼æ¬æ®µç®æ 约 {ç®æ åæ°} åï¼å½åä¸è¶³ {å·®é¢} åãåæå¦ä¸ï¼{åæ®µè½å ¨æ}”
-
åæ°é¢ç®ï¼åä½åï¼å¼ç¨/æ å¼ç¨å ¼å®¹ï¼ï¼ “读å
word_budget_final.csvï¼åå å«ï¼æç®IDã大纲ãç»¼åæ°ãè¿°åæ°ãå¼ç¨æ®µæå¯¹åºæç®ç综/è¿°åæ°é¢ç®åä½ï¼æ å¼ç¨æ®µï¼æç®ID 为空è¡ï¼å¦æè¦/屿/ç»è®ºï¼æè¯¥è¡é¢ç®æ§å¶é¿åº¦ï¼å¯åå¹¶åè¿°ä½éå°éæ»åæ°é é¢ã” -
缩ç¥è¯è§èï¼åä½åå¿ é¡»éµå®ï¼ï¼ “馿¬¡åºç°ä¸æåè¯æ¶ï¼ä½¿ç¨’䏿ï¼è±æå ¨ç§°ï¼è±æç¼©åï¼’æ ¼å¼ï¼åç»å¯ç´æ¥ä½¿ç¨è±æç¼©åã 示ä¾ï¼’å ç«æ£æ¥ç¹æå¶åï¼Immune checkpoint inhibitorï¼ICIï¼’ã’å·ç§¯ç¥ç»ç½ç»ï¼Convolutional Neural Networkï¼CNNï¼’ã 常è§ç¼©ç¥è¯å¦ DNAãRNAãCTãMRIãAI çå¯ç´æ¥ä½¿ç¨ï¼æ é馿¬¡å ¨ç§°å±å¼ã è¯¦è§ references/expert-review-writing.md ç’åä½è¦ç¹’ç« èã”
-
å 容å离约æï¼åä½åå¿ é¡»éµå®ï¼é²æ¢ AI æµç¨æ³é²ï¼ï¼ “ç»¼è¿°æ£æå¿ é¡»å®å ¨èç¦é¢åç¥è¯ï¼ç¦æ¢åºç°ä»»ä½’AI工使µç¨’æè¿°ãå ·ä½ç¦æ¢ï¼â 卿è¦ä¸å’æ¬ç»¼è¿°åºäº X æ¡åæ£æç®ãå»éå Y æ¡ãæç»ä¿ç Z 篒ï¼â å¨å¼è¨ä¸å’æ¹æ³å¦ä¸ï¼æ¬ç»¼è¿°æç §æ£ç´¢âå»éâè¯åâéæâåä½ç管线æ§è¡’ï¼â 任使咿£ç´¢ãå»éãç¸å ³æ§è¯åãéæãåæ°é¢ç®’çå æä½çæè¿°ãè¿äºæ¹æ³å¦ä¿¡æ¯åºæ¾å¨
{主é¢}_工使¡ä»¶.mdä¸ãç®æ æ¯è®©è¯»è æåä¸å°è¿æ¯ AI çæç综述ï¼å®å ¨ç¬¦åä¼ ç»å¦æ¯ç»¼è¿°æ¯ä¾ã详è§references/expert-review-writing.mdç’å 容å离åå’ç« èã” -
å¼ç¨åå¸ä¸ä½ç½®çº¦æï¼åä½åå¿ é¡»éµå®ï¼ï¼ “å¼ç¨å¿ 须紧è·çå®ææ¯æçè§ç¹ï¼èéå ç§¯å¨æ®µè½æ«å°¾ã
åä½èå¥ï¼
- æåºè§ç¹ â ç«å³å¼ç¨ \cite{key} â ç»§ç»ä¸ä¸ä¸ªè§ç¹ â 忬¡å¼ç¨
- é¿å å å宿´ä¸ªæ®µè½ï¼æå䏿¬¡æ§å ææå¼ç¨
åç¯å¼ç¨ä¼å ï¼çº¦å 70%ï¼ï¼
- å¼ç¨å ·ä½æ¹æ³/ç»æ/æ°åæ¶ï¼ãä½è + æ¹æ³ + ç»æ + \cite{key}ã
- éç¯å¯¹æ¯æ¶ï¼ãè§ç¹ A + \cite{key1}ãè§ç¹ B + \cite{key2}ãã
- ç¦æ¢ä½¿ç¨ãå¤é¡¹ç 究表æ\cite{key1,key2,key3}ãæ¨¡å¼ï¼é¤éåé¢å·²é个å¼ç¨è¿ï¼
å°ç»å¼ç¨ï¼çº¦å 25%ï¼ï¼
- ä» ç¨äºå¯¹æ¯å¹¶åç ç©¶æ¶ï¼ä¸å¿ é¡»æç¡®è¯´æåæç®çå·®å¼åè´¡ç®
段æ«å ç ï¼<20% æ åµï¼ï¼
- ä» ç¨äºæ®µæ«æ»ç»ï¼åææ¯æ®µè½ä¸»ä½å·²ç»å åå¼ç¨å¹¶éè¿°
详è§
references/expert-review-writing.mdç’å¼ç¨ä½ç½®çº¦æ’å’åç¯å¼ç¨ä¼å ’ç« èã” -
åä½è´é¢çº¦æï¼åä½åå¿ é¡»éµå®ï¼ç¦æ¢æ¨¡å¼ï¼ï¼ “以ä¸å使¨¡å¼è¢«ä¸¥æ ¼ç¦æ¢ï¼è¿åè å°è¢«è§ä¸ºä¸ä½æ°´åï¼
â ç¦æ¢æ¨¡å¼ 1ï¼è¡¥å é 读/åè§ç±»å¥å
- ç¦æ¢ï¼ãæ¬èè¡¥å é 读å¯åè§ï¼\cite{…}ã
- ç¦æ¢ï¼ãè¿ä¸æ¥é 读å¯åèï¼\cite{…}ã
- ç¦æ¢ï¼ãç¸å ³ç ç©¶åè§ï¼\cite{…}ã
- ç¦æ¢ï¼ä»»ä½å¨æ®µæ«å ç å¼ç¨ä¸ä¸è¯´æå ·ä½è´¡ç®çãåè§ã类表述
- çç±ï¼è¿ç±»å¥åå¯¹è¯»è æ²¡æä»·å¼ï¼çº¯ç²¹æ¯ãååæ°ãçä¸ä½è¡ä¸º
â ç¦æ¢æ¨¡å¼ 2ï¼æ¨¡ç³çå¼ç¨å ç
- ç¦æ¢ï¼ãå¤é¡¹ç 究表æ\cite{key1,key2,key3}ãä¸å颿ªé个å¼ç¨è¿
- ç¦æ¢ï¼å次å¼ç¨ >6 个 keyï¼é¤éæ¯æ®µæ«æ»ç»ä¸æ®µè½ä¸»ä½å·²å åå¼ç¨ï¼
- çç±ï¼è¯»è æ æ³è¯å«æ¯ä¸ªè§ç¹çå ·ä½æ¥æº
â ç¦æ¢æ¨¡å¼ 3ï¼ä¸ºè¾¾å°åæ°èçæ°´
- ç¦æ¢ï¼æ·»å æ å®è´¨å 容çè¿æ¸¡å¥ãéå¤è¡¨è¿°
- ç¦æ¢ï¼ä¸ºãç¨å®ãæææç®è强è¡å¼ç¨ä½åæç®
- çç±ï¼ä¸å®¶çº§ç»¼è¿°èç¦è¯æ®è´¨éï¼èéæç®æ°é
â æ£ç¡®åæ³ï¼å¼ç¨æªå åå©ç¨æ¶çå¤ç
- 妿é«åæç®å·²å åå¼ç¨ï¼å¯ä»¥ä¸å¼ç¨ä½åæç®
- å¦ææ®µè½å®æ´ä½åæ°ä¸è¶³ï¼å¨æ®µè½å è¡¥å å ·ä½è¯æ®/æ°å/åä¾ï¼ææºæ©åï¼
- å¦æç¡®å®éè¦è¡¥å èæ¯ï¼æå为ç¬ç«å段è½ï¼æ¯æ®µ 2-5 ç¯æç®
详è§
references/expert-review-writing.mdçãåä½è´é¢çº¦æãç« èã”