zcbot/skills/brief/SKILL.md

name	description
brief	生成科研方向简报(research direction briefing / 重要文献速览)。给定一个研究方向 + 时间窗,从各大相关期刊(Elsevier 数据库优先)挑选近期重要论文,产出一份「重要论文列表 + 内容总结」的可读简报:先列清单(每篇带标题/作者/期刊/年月/DOI + 一段简介或摘要概述),再对这批论文做客观归纳。可溯源、不编造引文,**只描述不给建议**。当用户要"简报 / 方向简报 / 最新文献 / 重要论文列表 / 研究动态 / 某方向近期重要论文 / 跟踪某领域最新研究"时使用。

科研方向简报(重要文献速览)

把"某方向近期发了哪些重要论文、都在讲什么"做成一份可读、可溯源、客观的简报。两段式:先一份重要期刊论文列表(各大相关期刊、Elsevier 数据库优先;每篇带一段简介/摘要概述),再对这批论文做内容总结。

只描述、不给建议。 简报呈现"发了什么、讲了什么",不给"本院应当……/可切入……/建议……"。判断留给读者。

"重要"怎么挑:来自主流期刊(Elsevier 旗舰刊优先)、方向上居中而非边缘、有实质发现。近期论文引用尚少,故主要看期刊层级 + 主题相关性 + 发现的分量,不是单纯按引用数。控量靠"重要性 + 时新",不靠主观褒贬。

简报 ≠ 综述论文(paper review):综述要全面、深、给定论;简报要快、准、客观——5–20 分钟掌握一个方向近期发了哪些重要论文、各讲了什么。

边界(免得和别的 skill 撞)

• vs research/documents:它们只取文献;brief 把取回的论文组织成可读列表 + 客观总结。
• vs paper(review):paper 写可投稿综述(几十页、定论);brief 出轻量速览(几页、客观、不给判断)。
• vs analyze:analyze 拆科学问题;brief 围绕已定方向列近期重要论文。
• vs proposal:proposal 写本子、给建议;brief 只列论文 + 客观总结。要"对本院的建议" → 转 proposal。

资源(路径相对 load_skill 头里的 dir=<绝对路径>)

• references/journals.md —— 各建材子领域主流期刊清单(Elsevier 数据库优先)+ 精确 publication_name + 0 命中降级法。阶段二必读。
• scripts/render_docx.py —— md→docx,商务红主题 + 列表 [n] 锚点 + 正文 [n]/[Wn] 引文上标回链 + DOI/URL 可点超链接 + 化学式下标白名单(CO2/C3S/Na2O...,不误伤 LC3/C595/Ca2+)。用 .venv/Scripts/python.exe 跑。

产物默认 .md;要 docx 用 render_docx.py;要 deck 转 ppt skill。

阶段一:定题对齐(BLOCKING)

写一份 task 级 spec(命名见 system prompt《task 级「宪法」文件命名约定》),填下面字段,有歧义先反问、不替用户拍板,写完复述确认再往下:

1. 方向 + 边界:具体到子方向(不是"水泥"而是"低碳水泥 SCM");明确纳入/排除
2. 时间窗:默认近 1 年(简报是"最新文献",窗口宜短);换算成 year_gte(今年见 system prompt)
3. 期刊范围:默认按方向所属子领域取 journals.md 主流期刊(Elsevier 优先);用户可增删指定刊
4. 深度 / 篇数:flash 10–20 篇 / standard(默认)20–40 篇 / deep 40–80 篇
5. 数据源(默认三路并用):research + documents 都是获取文献的主力(research 按期刊精确取最新 Elsevier 论文 + DOI;documents 取内部材料库全文),web search 取政策·标准·产业动向(单列、不混进论文总结)。某一路不可用时降级用其余两路,不整体放弃
6. 语言:中文(默认)/ 英文
7. 特殊关注点(可选):想重点呈现的材料体系 / 方法(仍只描述,不给建议)

阶段二:三路取数(research + documents 取文献 / web 取动向)

先读 references/journals.md。中文方向先转专业英文术语(库主语料英文):低碳水泥→low-carbon cement / clinker substitution;SCM→supplementary cementitious materials / fly ash / GGBFS / calcined clay;LC3→limestone calcined clay cement;碳化养护→CO2 curing / carbonation。缩写与全称都试。

research(逐刊取最新 Elsevier 论文 + DOI) —— run_python:

from skills.research.paper import search
# 逐刊拉最新:publication_name 精确匹配 + 时间窗;list 自带 abstract,看前 200-400 字判切题与分量
for jname in ["Cement and Concrete Research", "Cement and Concrete Composites",
              "Construction and Building Materials", "Journal of Cleaner Production"]:
    papers = search(publication_name=jname, year_gte=2025, limit=50)
    # 按 publication_date 倒序取最新若干;留重要的(主题居中 + 有实质发现),弃边缘

某刊精确名 0 命中 → 换 keyword=<方向英文术语> 再搜,从返回里挑 publication_name 命中目标刊的;仍空记"该刊本窗口库内无收录"。

documents(内部材料库取全文,材料类首选) —— host-side tool document_search,中英 query 都行(后端跨语言语义检索);胶凝材料库 classification_id=1。取 md_content 既做候选也供引文核验抓锚点最顺。

web search(取动向) —— 政策(双碳/碳配额)、标准(新国标/团标)、行业会议、企业产线中试。单列"其他动向",不混进论文列表与总结。

• 汇成证据表 <task_dir>/evidence.md:期刊 | 标题 | 第一作者(机构)| 年-月 | 摘要概述 | DOI | 来源(research/documents/web)。
• 跨源去重:同 DOI 一条(documents 全文优先,DOI 记自 research);web 不与论文去重、单列。

库时效(必交代):research(OpenAlex)约 3 个月索引滞后,"最新"= 库内最新。窗口内 0 篇 → 如实告知库未收录该窗口,可用 web 补更近的非论文动向,不脑补文献。

阶段三:列清单 + 内容总结(写 <task_dir>/sections/*.md)

骨架四段(flash 可省 00/03):

• 00_overview.md 概览:方向 + 纳入/排除边界 + 时间窗 + 覆盖了哪些期刊 + 收录多少篇。无引文。
• 01_papers.md 重要论文列表(主体):按期刊 ### 分组,每篇一条,行首 [n](渲染时此段作参考锚点、[n] 带 DOI 超链接):

  ### Cement and Concrete Research(Elsevier)
  
  [1] <标题>. <第一作者> et al., Cement and Concrete Research, 2026-03. DOI: 10.1016/j.cemconres.2026.xxxxxx
  
  <简介/摘要概述:2–4 句,讲研究对象、方法/表征、主要发现与关键数据 —— 基于 abstract 或全文,不夸张、不评判>
  

  按 publication_date 倒序,最新在前。每篇都要有摘要概述,不能只留标题。
• 02_summary.md 内容总结:对这批论文客观归纳——主题分布、常涉材料体系、常用方法/表征、共同关注点;引具体论文挂 [n] 上标(回链到 01)。只描述"这批论文在讲什么",不给"应当/建议/可切入"。
• 03_web.md 其他动向(仅 spec 开 web 时):政策/标准/会议/产业,[W1] 标来源 + 日期,单列。

数字/定量结论必须挂 [n];"据报道""有研究表明"这类无源句式禁止。

阶段四:引文核验(渲染前必跑)

论文直接来自 research/documents,DOI 以库返回字段为准(不沿用记忆、不编造)。逐条核验:

1. 存在性:search()/get_paper(doi) 或 documents 命中确认真实存在;查不到 → 标 [未核实],告诉用户"找不到来源,请提供 DOI 或删去",不编造。
2. 支撑度:摘要概述 / [n] 论断要和 abstract(或全文)一致;不一致 → 改概述迁就证据,不是改证据。
3. web:记原始 URL + 访问日期 + 发布机构,标"截至 <日期>";不当学术结论引。

台账可写 <task_dir>/CITATIONS.md。铁律:不为凑数编造文献;支撑不足改论断不改证据;查不到如实说。

阶段五:渲染验收

• 用户要 docx → .venv/Scripts/python.exe <dir>/scripts/render_docx.py <sections_dir> -o <方向>-简报.docx(--no-color 出黑白);要 deck → 转 ppt。
• 渲染前自查:[CITE-]/<TODO> 占位是否清干净、正文 [n] 与列表 [n] 是否对得上(无 orphan)、有没有混进"建议/启示/本院应当"措辞。
• 交付一句话说清:覆盖了哪些期刊、收了多少篇、时间窗、哪些刊本窗口库内无收录。

反模式

• ❌ 给建议/启示/"本院应当" —— 只描述论文讲了什么,判断留给读者
• ❌ 列表只留标题、没摘要概述 —— 每篇都要 2–4 句简介
• ❌ 跳过定题直接检索 / 用中文 keyword 搜英文库 / 期刊名不精确 —— 先定题、转英文术语、用精确 publication_name
• ❌ web 资讯混进论文列表/总结 —— 单列"其他动向"
• ❌ 编造 DOI / "据报道"无源句 —— 查不到就如实说