docs: rebuild knowledge and polishing agent guides

文档润色Agent.md

@@ -1,252 +1,357 @@
-# 文档润色 Agent 与 Claude Scholar 学术插件快速索引
+# 文档润色 Agent 操作手册：面向图文手术导航项目材料
 
-问题开始时间：2026-05-30-16-16-29
+问题开始时间：2026-05-31-00-11-41
 
-## 0. 本次下载与阅读范围
+## 0. 本次重建结论
 
-本次已在 `文档润色流和知识库构建流` 中保留并新增以下材料：
+本文件是从当前工作区重新梳理后重建的“文档润色 Agent 快速索引”。它不只是 Claude Scholar 插件摘要，而是面向本项目实际材料的写作工作流说明。
 
-- 既有解包目录：`文档润色流和知识库构建流/claude-scholar`
-- 本次 Git 下载目录：`文档润色流和知识库构建流/claude-scholar-upstream`
-- GitHub 仓库：<https://github.com/Galaxy-Dawn/claude-scholar>
-- 当前读取提交：`105a476`
+当前工作区的核心事实：
 
-重点阅读文件：
+- 原始核心资料：`核心资料汇总`，19 个 PDF，约 114M。
+- 已转换资料：`核心资料汇总_MD`，19 个 Markdown、76 个 JSON、38 个 PDF 副本/版面文件、1718 张图片，约 370M。
+- 成果证据资料：`核心成果汇总`，66 个文件，覆盖专家共识、伦理、专利、软著、论文、查新、专著、获奖、荣誉、转化公示和设备图片，约 207M。
+- 后续本地待处理材料：`大赛-待撰写文档及规则` 与 `大赛-提供文件清单`，包含 3 个 DOCX 和 1 个空 Markdown，约 120K；这两个目录不纳入 Gitea 同步。
+- 外部工作流资料：`文档润色流和知识库构建流`，包含 `claude-scholar`、`claude-scholar-upstream`、`llm-wiki.md` 和执行记录。
+- 当前根目录 Git 状态在本次重建前显示 `文档润色Agent.md` 与 `知识库Agent构建.md` 已删除；本次按用户要求重新生成，不做旧版回滚。
 
-- `README.zh-CN.md`、`README.md`
-- `MCP_SETUP.zh-CN.md`
-- `OBSIDIAN_SETUP.zh-CN.md`
-- `.claude-plugin/plugin.json`
-- `.claude-plugin/marketplace.json`
-- `agents/*.md`
-- `skills/*/SKILL.md`
-- `commands/*.md`
-- `rules/claude-scholar-core.md`
-- `rules/agents.md`
-- `rules/experiment-reproducibility.md`
+## 1. 工作区地图
 
-## 1. 插件定位
+| 路径 | 角色 | 是否原始证据 | 主要用途 |
+|---|---|---:|---|
+| `核心资料汇总` | 原始项目材料 PDF | 是 | 保留未改动 PDF，作为 Mineru 转换和人工复核来源 |
+| `核心资料汇总_MD` | PDF 转 Markdown 后的主语料 | 是，近似转写 | 文本抽取、图片索引、章节重组、写作素材提炼 |
+| `核心成果汇总` | 成果证据包 | 是 | 证明伦理、专利、软著、论文、获奖、转化、设备实物等事实 |
+| `大赛-待撰写文档及规则` | 智慧医保大赛申报目标与评分规则 | 本地待处理 | 约束后续申报书结构、评分点和字数格式；不做 Gitea 同步 |
+| `大赛-提供文件清单` | 智慧医保大赛数据目录公告 | 本地待处理 | 支撑后续医保数据场景、数据价值和政策背景；不做 Gitea 同步 |
+| `文档润色流和知识库构建流/claude-scholar-upstream` | 学术插件快照 | 否 | 借用 agents、skills、commands、rules 的工作流设计 |
+| `文档润色流和知识库构建流/llm-wiki.md` | LLM Wiki 构建理念 | 否 | 指导持久知识库和索引/日志机制 |
+| `Mineru_api_client-V2.py` | PDF 转 Markdown 工具 | 否 | 后续新增 PDF 的批量转换工具 |
+| `文档润色Agent.md` | 本文件 | 否 | 指导如何用 Agent 做润色、审查和写作迁移 |
+| `知识库Agent构建.md` | 配套知识库方案 | 否 | 指导如何把资料建成文本+图片知识库 |
 
-`claude-scholar` 是面向学术研究、软件开发、实验分析、论文写作和项目知识库维护的半自动研究助手。它的核心理念不是替代研究者，而是把高重复、重结构、易遗忘的研究流程交给 Agent 维护，让人的判断仍处于中心。
+## 2. 文档润色的核心目标
 
-官方主线工作流可以概括为：
+本项目的“润色”不应理解为单纯把文字写得更华丽，而应理解为：
 
 ```text
-问题 -> 证据 -> 实验 -> 分析 -> 论断 -> 写作
+材料盘点 -> 证据抽取 -> 论断分级 -> 结构重排 -> 风格润色 -> 风险审查 -> 可追溯成稿
 ```
 
-对本项目的价值：
+优先级：
 
-- 将 `核心资料汇总_MD` 中的申报书、博士论文、答辩 PPT、商业计划书、项目申请表等材料变成可复用知识。
-- 对文档润色建立 claim-evidence 纪律，避免把材料中的宣传性表述直接当事实。
-- 从过往获批材料、BP、博士论文中提炼结构、表达、证据节点、图文组织和申报叙事。
-- 为后续知识库、标书、成果汇总、答辩稿、项目申请书提供可追溯的写作素材。
+1. 事实准确：所有事实性表述要能回到 `核心资料汇总_MD` 或 `核心成果汇总`。
+2. 逻辑闭环：从临床问题、技术瓶颈、系统方案、验证基础到转化价值。
+3. 证据可追溯：每个强论断都要标注来源文件、章节、页码、图片或证明材料。
+4. 表达自然：减少空泛套话、机械排比和 AI 味。
+5. 面向读者：不同输出面向专家评审、项目管理、产业转化、答辩听众时语气不同。
 
-## 2. 安装与调用方式
+## 3. 可借用的 Claude Scholar Agent
 
-### 2.1 完整安装
+本地插件快照包含 6 个主要 agents：
 
-```bash
-git clone https://github.com/Galaxy-Dawn/claude-scholar.git /tmp/claude-scholar
-bash /tmp/claude-scholar/scripts/setup.sh
-```
-
-说明：
-
-- `main` 分支面向 Claude Code。
-- Codex CLI 官方建议使用 `codex` 分支。
-- OpenCode 用户使用 `opencode` 分支。
-- 安装器会尽量保留已有配置，把仓库托管的 `CLAUDE.md` 作为 sidecar 文件安装。
-
-### 2.2 插件市场安装
-
-```text
-/plugin marketplace add Galaxy-Dawn/claude-scholar
-/plugin install claude-scholar@claude-scholar
-```
-
-注意：
-
-- 插件市场安装会加载 skills、commands、agents、hooks。
-- Claude Code 插件不能自动分发 `rules/`，rules 需要手动复制。
-- `CLAUDE.md` 和 `settings.json` 不会自动合并到用户原配置，需要人工选择。
-
-### 2.3 选择性安装
-
-只复制需要的组件，例如：
-
-```bash
-cp -r /tmp/claude-scholar/skills/research-ideation ~/.claude/skills/
-cp -r /tmp/claude-scholar/skills/ml-paper-writing ~/.claude/skills/
-cp /tmp/claude-scholar/agents/paper-miner.md ~/.claude/agents/
-cp /tmp/claude-scholar/rules/*.md ~/.claude/rules/
-```
-
-## 3. Agent 快速索引
-
-| Agent | 适用场景 | 核心功能 | 调用方法 |
+| Agent | 原始定位 | 本项目改造用法 | 典型触发语 |
 |---|---|---|---|
-| `literature-reviewer` | 新研究主题、文献综述、research gap、proposal 前期论证 | 多源检索论文；通过 Zotero MCP 导入 DOI/arXiv/URL；自动建 collection；读取 PDF 全文；生成综述、gap、研究问题和 BibTeX | 自然语言说“conduct literature review/search papers/identify research gaps”；或用 `/research-init`、`/zotero-review` |
-| `paper-miner` | 从优秀论文、申报书、BP、答辩材料中学习写作方式 | 读取 PDF/DOCX/arXiv/网页；抽取写作模式、结构信号、可复用表达、venue signals、rebuttal 表达；写入全局 writing memory | `/mine-writing-patterns <source> <focus>`，focus 可为 `general/introduction/method/results/rebuttal/venue` |
-| `rebuttal-writer` | 审稿回复、专家意见回复、项目评审修改说明 | 拆分 reviewer comments；分类 Major/Minor/Typos/Misunderstanding；选择 Accept/Defend/Clarify/Experiment；生成逐条回复 | `/rebuttal <review_file>` 或自然语言要求“respond to reviewers/analyze review comments” |
-| `code-reviewer` | 代码或脚本修改后的质量与安全审查 | 检查 git diff、硬编码密钥、输入验证、性能、测试覆盖、依赖许可、可维护性 | `/code-review` 或代码修改后自动触发 |
-| `tdd-guide` | 明确要求测试先行时 | RED -> GREEN -> REFACTOR，小步编写失败测试、最小实现、验证 | `/tdd` 或明确说“用 TDD” |
-| `kaggle-miner` | 学习 Kaggle 竞赛方案和工程经验 | 提取 Top solutions、技术路线、代码模板、best practices，按 NLP/CV/Tabular/Time Series/Multimodal 分类 | 提供 Kaggle URL 或请求“learn from Kaggle solutions” |
+| `paper-miner` | 从论文中挖掘写作模式 | 从博士论文、申报书、BP、答辩 PPT 中提取章节结构、叙事方式、可复用表达 | “请从这份材料中抽取写作模式” |
+| `literature-reviewer` | 文献综述和 research gap | 后续补充手术 AI、腔镜视觉、图文报告、导航机器人相关外部文献 | “请围绕某主题做文献综述并建立证据清单” |
+| `rebuttal-writer` | 审稿意见回复 | 模拟项目评审质询、答辩问答、专家意见逐条回复 | “请模拟专家评审并给出逐条回应” |
+| `code-reviewer` | 代码审查 | 审查转换脚本、知识库脚本、批处理脚本、备份命令 | “请审查这个脚本是否安全可靠” |
+| `tdd-guide` | 测试驱动开发 | 后续若写自动入库脚本，用它拆测试用例 | “请用 TDD 写入库脚本” |
+| `kaggle-miner` | Kaggle 技术方案挖掘 | 对本项目不是主线，只有学习竞赛 BP 或算法竞赛材料时使用 | “请学习某竞赛获奖方案” |
 
 本项目最常用组合：
 
 ```text
-paper-miner       -> 学习已有材料的结构与表达
-literature-reviewer -> 补外部文献证据
-review-response / rebuttal-writer -> 模拟专家质询与修改说明
-code-reviewer     -> 检查知识库脚本、批处理脚本和备份流程
+paper-miner -> citation/evidence discipline -> writing-anti-ai -> paper-self-review -> rebuttal-style QA
 ```
 
-## 4. 学术写作与润色 Skill 索引
+## 4. 可借用的 Claude Scholar Skill
 
-| Skill | 作用 | 本项目推荐用法 |
+### 4.1 写作与润色
+
+| Skill | 用途 | 本项目用法 |
 |---|---|---|
-| `research-ideation` | 5W1H、gap analysis、Research Question Card、方法选择、项目计划 | 把“手术图文报告/导航/机器人/智能感知”拆成科学问题、应用痛点、证据需求和可交付成果 |
-| `ml-paper-writing` | 顶会论文写作、claim ledger、引用核验、LaTeX、related work | 借用 claim-evidence gate：每个结论都要能回到来源材料或文献 |
-| `citation-verification` | 核查引用真实性、元数据、DOI/arXiv、claim 是否真的由文献支持 | 写项目背景和立项依据时避免伪引用、弱引用和过强表述 |
-| `writing-anti-ai` | 中英文去 AI 味、减少机械连接词和空泛排比 | 润色申报书、成果总结、商业计划书，保留正式但更自然的表达 |
-| `paper-self-review` | 投稿前自审，检查结构、逻辑、引用、图表和过度声称 | 用作标书/申报书提交前的专家预审清单 |
-| `review-response` | 审稿意见分类、回复策略、逐点答复 | 可迁移为“评审意见预演/答辩问答/修改说明” |
-| `doc-coauthoring` | 大型文档协作写作、结构设计、读者测试 | 用于长篇申报书、博士论文摘要、项目申请书重构 |
-| `daily-paper-generator` | arXiv/bioRxiv 主题论文日报 | 围绕手术 AI、Surgical VQA、Surgical Report Generation、MIS navigation 做定期文献追踪 |
-| `publication-chart-skill` | 论文级图表、pubfig/pubtab、图表 QA | 用于技术路线图、系统架构图、实验结果表的发表级整理 |
-| `results-analysis` | 统计分析、图表、effect size、CI、多重比较 | 若后续有实验结果或系统评测表，用它生成可信结果叙述 |
-| `results-report` | 把严格分析产物写成内部实验总结 | 将系统评测、临床验证、消融实验写成可引用报告 |
-| `nature-writing` | Nature 系列文章的章节写作和论证构建 | 可借用其“高密度、证据前置、叙事清晰”的写作纪律 |
-| `nature-polishing` | Nature 风格润色和语言打磨 | 用于英文摘要、英文论文或高端期刊风格材料 |
-| `nature-response` | Nature 系列逐点审稿回复 | 可参考其“comment-response tracker”处理专家意见 |
-| `nature-data` | 数据可得性、FAIR、数据引用 | 用于数据、代码、伦理、临床资料可得性说明 |
-| `expression-skill` | 结论先行、证据支撑、风险提示、下一步明确 | 用于所有项目汇报和阶段总结 |
-| `planning-with-files` | 用 `task_plan.md`、`notes.md`、deliverable 文件持久化复杂任务 | 后续知识库构建建议默认启用 |
+| `doc-coauthoring` | 大型文档协作写作 | 申报书、成果总结、博士材料重组 |
+| `writing-anti-ai` | 去 AI 味、改善表达自然度 | 减少“显著提升、全面赋能、系统推进”等泛化表述 |
+| `ml-paper-writing` | 顶会论文写作纪律 | 借用 claim ledger，不照搬 ML 论文模板 |
+| `paper-self-review` | 自审结构、逻辑、引用、图表 | 用作项目申报书提交前检查 |
+| `nature-writing` | 高密度学术叙事 | 英文摘要、高级别论文/申报材料表达 |
+| `nature-polishing` | Nature 风格润色 | 英文材料润色 |
+| `nature-response` | 逐点审稿回复 | 专家意见回复模板 |
+| `expression-skill` | 结论先行、证据支撑、风险提示 | 所有阶段性汇报和最终总结 |
 
-## 5. 知识库与 Obsidian 相关 Skill
+### 4.2 证据、文献和知识库
 
-| Skill | 功能 | 本项目落地方式 |
+| Skill | 用途 | 本项目用法 |
 |---|---|---|
-| `obsidian-project-kb-core` | 初始化和维护项目级 Obsidian KB，管理 Hub、Plan、Index、registry、Daily | 可把本项目绑定成 `Research/TWBG_Materials/` |
-| `obsidian-source-ingestion` | 将外部资料路由到 `Sources/Papers/Web/Docs/Data/Interviews/Notes` | 把 `核心资料汇总_MD` 中 19 份材料作为 `Sources/Docs` 或 `Sources/Proposals` |
-| `obsidian-literature-workflow` | 从 paper notes 生成 Literature Overview、Method Taxonomy、Research Gaps、Claim Map、literature.canvas | 后续补医学/手术 AI 文献时使用 |
-| `obsidian-kb-artifacts` | 生成或修复 canvas、Bases 和派生知识图谱 | 适合生成“项目-成果-论文-专利-系统模块”关系图 |
-| `zotero-obsidian-bridge` | Zotero 论文集合到 Obsidian paper notes 的桥接 | 外部文献进入 Zotero 后，再沉淀为 `Sources/Papers` |
-| `defuddle` | 网页内容抽取和清理 | 把网页新闻、政策、公示、成果转化页面清理成 Markdown |
+| `research-ideation` | 研究问题、gap、证据需求 | 把“图文手术报告/导航/机器人”拆成问题树 |
+| `citation-verification` | 引用真实性和 claim 支持关系 | 核查论文、专利、伦理、公示是否支撑对应表述 |
+| `obsidian-project-kb-core` | 项目级知识库核心 | 后续建立 `项目知识库` 或 Obsidian vault |
+| `obsidian-source-ingestion` | 外部资料入库 | 把 19 份 MD 和成果证据包变成 Source Notes |
+| `obsidian-literature-workflow` | 文献综合 | 外部论文进入 `Sources/Papers` 后生成综述 |
+| `obsidian-kb-artifacts` | Canvas/Bases/图谱产物 | 生成项目脉络图、证据图、成果图 |
+| `zotero-obsidian-bridge` | Zotero 到 Obsidian | 后续管理外部论文和 PDF |
+| `defuddle` | 网页清理 | 处理媒体报道、公示网页、政策网页 |
 
-## 6. Slash Command 快速索引
+### 4.3 结果、图表与输出
 
-### 6.1 文献与研究启动
-
-| Command | 用途 | 示例 |
+| Skill | 用途 | 本项目用法 |
 |---|---|---|
-| `/research-init` | 初始化研究主题，创建 Zotero collection，生成 Research Question Card、文献综述或 proposal | `/research-init "surgical report generation minimally invasive surgery" focused both` |
-| `/zotero-review` | 读取 Zotero collection，做深度文献分析并写入 Obsidian KB | `/zotero-review "Surgical AI Report Generation" deep` |
-| `/zotero-notes` | 批量生成 Zotero 论文阅读笔记 | `/zotero-notes "Surgical Navigation" detailed` |
+| `results-analysis` | 统计分析与科研图 | 后续系统评测、临床验证、消融实验 |
+| `results-report` | 实验报告 | 形成可进入申报书或论文的内部结果总结 |
+| `publication-chart-skill` | 论文级图表和表格 | 技术路线图、系统架构图、结果图表重绘 |
+| `post-acceptance` | 海报、slides、传播材料 | 答辩、路演、项目汇报 |
 
-### 6.2 写作与润色
+## 5. 可调用命令索引
 
-| Command | 用途 | 示例 |
+### 5.1 文档写作相关
+
+| 命令 | 作用 | 本项目示例 |
 |---|---|---|
-| `/mine-writing-patterns` | 从论文、标书、BP 中提取写作模式 | `/mine-writing-patterns 核心资料汇总_MD/.../项目申请书.md introduction` |
-| `/rebuttal` | 生成审稿/评审意见逐点回复 | `/rebuttal review-comments.md` |
-| `/poster` | 设计学术会议海报 | `/poster` |
-| `/presentation` | 创建会议或答辩 slides | `/presentation` |
+| `/mine-writing-patterns` | 从材料中学习写法 | `/mine-writing-patterns 核心资料汇总_MD/.../博士论文.md introduction` |
+| `/rebuttal` | 逐条回复评审意见 | `/rebuttal 专家意见.md` |
+| `/poster` | 学术海报 | 项目成果展海报 |
+| `/presentation` | 汇报 slides | 答辩 PPT、路演 PPT |
 
-### 6.3 知识库
+### 5.2 研究和文献相关
 
-| Command | 用途 | 说明 |
-|---|---|---|
-| `/kb-init` | 初始化项目知识库 | 创建 `Research/{project-slug}/` |
-| `/kb-ingest` | 导入外部材料 | PDF/Markdown/网页/数据集进入 `Sources/*` |
-| `/kb-promote` | 将稳定内容提升为 canonical knowledge | 从 source note 或 Daily 提升到 `Knowledge/`、`Writing/` |
-| `/kb-literature-review` | 从 `Sources/Papers` 生成文献综合 | 需要 Evidence Records 足够 |
-| `/kb-index` | 刷新 `02-Index.md` | 只更新自动索引块 |
-| `/kb-map` | 生成/修复 canvas 或关系图 | 默认文献图是 `Maps/literature.canvas` |
-| `/kb-lint` | 健康检查 | 查断链、孤立页、registry 覆盖、canvas 有效性 |
-| `/kb-sync` | 同步 scaffold、registry、index、Daily | 批量变更后使用 |
-| `/kb-status` | 汇总 KB 状态 | 看绑定、计数和关键路径 |
-| `/kb-log` | 更新 Daily 和项目运行时记忆 | 每次知识库工作结束后记录 |
-
-### 6.4 实验与代码
-
-| Command | 用途 |
+| 命令 | 作用 |
 |---|---|
-| `/analyze-results` | blocker-first 实验后分析，生成统计、图表和结果报告 |
-| `/code-review` | 代码质量和安全审查 |
-| `/tdd` | 测试驱动开发 |
-| `/verify` | 运行验证流程 |
-| `/commit` | 辅助提交 |
+| `/research-init` | 初始化研究主题、建立 Research Question Card、文献候选和 proposal gate |
+| `/zotero-review` | 分析 Zotero collection 并生成文献综述 |
+| `/zotero-notes` | 批量生成论文阅读笔记 |
 
-## 7. Zotero MCP 能力
+### 5.3 知识库相关
 
-`literature-reviewer`、`/research-init`、`/zotero-review`、`/zotero-notes` 依赖 Zotero MCP 时能力最完整。
+| 命令 | 作用 |
+|---|---|
+| `/kb-init` | 初始化项目知识库 |
+| `/kb-ingest` | 导入资料到 Sources |
+| `/kb-promote` | 将稳定事实提升到 Knowledge 或 Writing |
+| `/kb-literature-review` | 从论文源笔记生成文献综合 |
+| `/kb-index` | 刷新索引 |
+| `/kb-map` | 生成关系图或 canvas |
+| `/kb-lint` | 健康检查 |
+| `/kb-sync` | 批量同步 |
+| `/kb-status` | 汇总状态 |
+| `/kb-log` | 记录当天进展 |
 
-主要工具：
+## 6. 本项目材料的润色分工
 
-- 导入：`zotero_add_items_by_identifier`、`zotero_add_items_by_doi`、`zotero_add_items_by_arxiv`、`zotero_add_item_by_url`
-- 读取：`zotero_get_collections`、`zotero_get_collection_items`、`zotero_search_items`、`zotero_get_item_metadata`、`zotero_get_item_fulltext`
-- 更新：`zotero_create_collection`、`zotero_move_items_to_collection`、`zotero_update_item`、`zotero_update_note`
-- PDF：`zotero_find_and_attach_pdfs`、`zotero_add_linked_url_attachment`
-- 清理：`zotero_reconcile_collection_duplicates`
+| 材料组 | 输入路径 | 适合任务 | 首选 Agent/Skill |
+|---|---|---|---|
+| 博士论文与答辩 | `※2026_3_博士毕业...`、`※2026_2_博士毕业...` | 提炼技术体系、方法、实验结果、学术叙事 | `paper-miner`、`ml-paper-writing` |
+| 项目申请书 | `2023_...申报书`、`2026_...申报书`、`2026_申请表...` | 迁移立项依据、研究内容、技术路线、团队基础 | `doc-coauthoring`、`paper-self-review` |
+| BP/商业计划书 | `BP-*` | 产品定位、市场价值、转化路径、商业表达降噪 | `paper-miner`、`writing-anti-ai` |
+| 成果证据 | `核心成果汇总` | 证据支撑、事实核验、附件索引 | `citation-verification`、`obsidian-source-ingestion` |
+| 图片和图表 | `核心资料汇总_MD/**/images`、`扶镜系统图片` | 技术路线图、系统架构图、证据图重绘 | `publication-chart-skill`、Image Note 流程 |
+| 智慧医保大赛 | `大赛-待撰写文档及规则`、`大赛-提供文件清单` | 按评分细则撰写项目申报书，衔接医保数据目录和 SurClaw/图文报告材料 | `doc-coauthoring`、`paper-self-review`、`writing-anti-ai` |
 
-Codex CLI 配置示例：
+## 7. 文档润色标准流程
 
-```toml
-[mcp_servers.zotero]
-command = "zotero-mcp"
-args = ["serve"]
-enabled = true
+### Step 1：明确输出类型
 
-[mcp_servers.zotero.env]
-ZOTERO_API_KEY = "your-api-key"
-ZOTERO_LIBRARY_ID = "your-user-id"
-ZOTERO_LIBRARY_TYPE = "user"
-UNPAYWALL_EMAIL = "your-email@example.com"
-UNSAFE_OPERATIONS = "all"
-NO_PROXY = "localhost,127.0.0.1"
-```
+先判断目标文档：
 
-## 8. 本项目推荐调用路径
+- 项目申报书
+- 成果总结
+- 科技奖励材料
+- 博士论文/学位材料
+- 商业计划书
+- 智慧医保大赛项目申报书
+- 答辩 PPT
+- 专家意见回复
+- 新闻/宣传材料
 
-### 8.1 从 `核心资料汇总_MD` 学习材料写法
+不同文档有不同语气：
+
+| 输出类型 | 语气 | 风险 |
+|---|---|---|
+| 项目申报书 | 审慎、证据充分、任务明确 | 不能把目标写成已完成事实 |
+| 成果总结 | 事实密集、附件可追溯 | 不能夸大应用范围 |
+| BP | 清晰、有吸引力、但不过度 | 市场数据必须标注来源 |
+| 智慧医保大赛申报书 | 评分点导向、政策合规、医保场景明确 | 不能脱离评分细则和数据目录公告 |
+| 答辩 PPT | 结论先行、图表驱动 | 避免长段文字 |
+| 论文 | 方法严谨、引用准确 | 不能伪造引用或结果 |
+
+### Step 2：抽取 claim-evidence
+
+每个强论断至少包含：
 
 ```text
-请使用 paper-miner 的方式读取 `核心资料汇总_MD` 中的博士论文、项目申请书、BP 和支撑材料，
-抽取以下写作模式：
-1. 项目背景如何从临床问题进入技术问题；
-2. 系统贡献如何分层描述；
-3. 图文报告、手术导航、智能感知、机器人协同的叙事线；
-4. 可迁移到新申报书的章节结构和高频表达；
-5. 需要证据支撑或避免过度声称的表述。
+Claim:
+Source:
+Location:
+Evidence:
+Claim strength:
+Allowed wording:
+Forbidden stronger wording:
 ```
 
-### 8.2 建立 claim-evidence 台账
+推荐强度：
+
+| 强度 | 含义 | 可用措辞 |
+|---|---|---|
+| `speculative` | 假设或计划 | “拟探索”“有望”“预期” |
+| `stated` | 材料中声称，但未见独立证明 | “材料显示”“项目提出” |
+| `observed` | 有图表、实验、系统截图或记录 | “观察到”“初步显示” |
+| `supported` | 多来源材料支持 | “已形成”“已实现”“已有基础” |
+| `strong` | 有正式证明、授权、公示、论文或伦理 | “已获批”“已授权”“已发表”“已公示” |
+
+### Step 3：结构重排
+
+常用申报书结构：
 
 ```text
-请读取 `核心资料汇总_MD`，按 Evidence Record 格式建立“项目核心论断-证据台账”：
-每条记录包含来源文件、页码或章节、支持的论断、证据强度、允许表述、禁止更强表述。
+临床/行业痛点
+  -> 现有方法不足
+  -> 本项目关键技术
+  -> 前期工作基础
+  -> 研究/建设内容
+  -> 技术路线
+  -> 创新点
+  -> 预期成果与转化
 ```
 
-### 8.3 润色项目申报书
+智慧医保大赛申报书结构应优先服从模板和评分细则：
 
 ```text
-请用 writing-anti-ai + paper-self-review 的方式润色以下段落：
-要求保留正式申报语气，减少套话，所有无法由 `核心资料汇总_MD` 支撑的结论标为 [需证据]。
+项目概述
+背景领域的现状分析及问题提出
+  -> 背景领域的现状分析
+  -> 提出问题
+项目思路
+  -> 原理和流程
+  -> 创新点
+  -> 普遍意义
+技术实现
+  -> 技术概况
+  -> 技术框架
+  -> 技术性能
+  -> 技术效率
+实施效果
+  -> 现实效果
+  -> 展望效果
 ```
 
-### 8.4 专家评审预演
+评分细则强调的高分点：
+
+- 背景分析：全面性、准确性、深刻性。
+- 提出问题：创新性、先导性、典型性。
+- 项目思路：原理流程清晰、符合政策法规和医保业务流程。
+- 创新点：新视角、新方法。
+- 普遍意义：可推广复制到其他场景。
+- 技术实现：软硬件环境、功能模块、技术规范、新算法、稳定性、安全性、易用性、响应速度。
+
+常用成果总结结构：
 
 ```text
-请使用 review-response 的思路，模拟 5 类专家质询：
-技术原创性、临床转化、数据合规、系统可落地性、市场/成果转化。
-对每个问题给出建议答复和需要补强的材料路径。
+问题背景
+  -> 核心成果
+  -> 技术创新
+  -> 证据附件
+  -> 应用成效
+  -> 知识产权与转化
+  -> 后续推广价值
 ```
 
-## 9. 对本项目的使用边界
+### Step 4：风格润色
 
-- `claude-scholar` 原生更偏计算机科学/AI 研究；本项目可借用流程，但医学、临床、伦理、成果转化相关论断仍需用本项目材料或权威文献核证。
-- `核心资料汇总_MD` 是内部 source of truth，但其中的商业计划书和申报书可能包含宣传性语言，进入知识库时要分清“已验证事实”“项目目标”“预期效果”“商业表达”。
-- 所有写作结论应能回链到具体来源材料、文献、专利、伦理、转化公示或系统截图。
-- 文档润色不是单纯“变漂亮”，优先级应为：事实准确、逻辑闭环、证据可追溯、读者能快速理解价值。
+替换原则：
+
+- 把“全面赋能、深度融合、显著提升”改成具体对象、指标或使用场景。
+- 把“国际领先、国内首创”改成可证明的差异点，除非有查新或正式证明。
+- 把“解决所有问题”改成“面向某场景缓解某类问题”。
+- 把“已经证实”改成“初步验证/材料显示/拟进一步验证”，除非证据充分。
+
+### Step 5：自审
+
+提交前检查：
+
+- 每个章节是否回答一个明确问题。
+- 每个强论断是否有来源。
+- 图表是否有解释和图注。
+- 专利、软著、伦理、论文、获奖是否与正文对应。
+- 是否出现同一系统多个名称且未解释。
+- 是否将 BP 的商业表述误当作科研事实。
+
+## 8. 常用调用口令
+
+### 8.1 学习写法
+
+```text
+请使用 paper-miner 的方式读取以下材料，抽取可复用写作模式：
+1. 章节结构；
+2. 临床痛点到技术方案的过渡；
+3. 创新点表达；
+4. 图文配合方式；
+5. 可复用但需要降噪的商业表达。
+```
+
+### 8.2 证据驱动润色
+
+```text
+请润色以下段落。要求：
+1. 保持正式项目申报语气；
+2. 删除空泛套话；
+3. 所有无法由 `核心资料汇总_MD` 或 `核心成果汇总` 支撑的句子标注 [需证据]；
+4. 将过强表述改成与证据强度匹配的表述。
+```
+
+### 8.3 专家评审预演
+
+```text
+请模拟 5 类专家评审意见：
+技术原创性、临床可行性、数据合规、系统落地、成果转化。
+每类给出可能质疑、建议回应、需要补充的证据路径。
+```
+
+### 8.4 图表复用
+
+```text
+请从 `核心资料汇总_MD` 和 `核心成果汇总/扶镜系统图片` 中筛选可用于“技术路线”和“研究基础”的图片。
+对每张图输出：图片路径、图意、支撑论断、适合章节、是否建议重绘。
+```
+
+### 8.5 形成成稿
+
+```text
+请基于已建立的 Evidence Records，起草“项目基础与创新性”章节。
+要求每段后用 HTML 注释写出来源 ID，例如：
+<!-- ER-20260531-001; 核心成果汇总/2. 专利_...pdf -->
+```
+
+### 8.6 智慧医保大赛申报书
+
+```text
+请基于 `大赛-待撰写文档及规则/2026全国智慧医保大赛初赛评分细则.docx`、
+`大赛-待撰写文档及规则/待撰写-项目申报书.docx`、
+`大赛-提供文件清单/2026全国智慧医保大赛提供数据目录公告(4).docx`，
+结合 `核心资料汇总_MD` 中 SurClaw、医保质控与费控、图文手术报告生成系统材料，
+重构一版项目申报书大纲。
+要求每个二级标题对应评分点、可用项目证据、需补充数据。
+```
+
+## 9. 红线
+
+- 不直接修改 `核心资料汇总` 和 `核心资料汇总_MD` 中的原始转换产物，除非明确要求修复转换错误。
+- 不把商业计划书中的市场表述直接提升为科研结论。
+- 不编造论文、专利、伦理、奖项、发表状态。
+- 不把“拟研发/拟转化”写成“已完成/已应用”。
+- 不在没有证据时使用“首创、领先、唯一、显著”等强词。
+- 不在最终稿中保留无法追溯的关键数字。
+
+## 10. 最小可执行工作流
+
+如果下一步开始真实润色，建议按以下顺序：
+
+```text
+1. 选定目标文档类型和读者。
+2. 从 `核心资料汇总_MD` 选 3-5 个最相关主材料。
+3. 从 `核心成果汇总` 选对应证明材料。
+4. 如果目标是智慧医保大赛，先读取 `大赛-待撰写文档及规则` 的评分细则和模板。
+5. 建 claim-evidence 台账。
+6. 先重构大纲，再润色段落。
+7. 做自审和专家质询预演。
+8. 最后生成可追溯成稿。
+```