القائمة
学术写作全流程技能——覆盖报告、书稿、SCI论文、中文核心期刊论文、发明专利、国内标准、国际标准、公众号文章、演示文稿九大文体，实现"写作→多角色评审→修改→迭代"闭环，持续优化直到达到发表/授权/颁布标准。支持批量写作、进度追踪、跨文档一致性检查。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/leixiaohui-1974/books --skill academic-writerيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
استنادا إلى تصنيف SOC المهني
| name | academic-writer |
| description | 学术写作全流程技能——覆盖报告、书稿、SCI论文、中文核心期刊论文、发明专利、国内标准、国际标准、公众号文章、演示文稿九大文体，实现"写作→多角色评审→修改→迭代"闭环，持续优化直到达到发表/授权/颁布标准。支持批量写作、进度追踪、跨文档一致性检查。 |
统一的"写—审—改—迭代"引擎，覆盖九大文体
| 指令 | 示例 | 效果 |
|---|---|---|
| 开始[类型][编号] | 开始SCI-P1a 开始专利PF2-3 开始书稿M1-ch03 | 启动指定文档的写作全流程 |
| 自然语言触发 | 写篇公众号 做个PPT 写个标准 写国际标准 | 启动对应文体，进入讨论→提纲→写作流程 |
| 继续 | 继续 | 从中断处恢复，自动读取进度文件 |
| 状态 | 状态 进度 | 查看当前所有文档的写作进度 |
| 代号 | 文体 | 说明 |
|---|---|---|
RPT | 技术报告/研究报告 | 项目报告、可研报告、技术方案 |
BK | 书稿/专著/教材 | 章节制，逐章写作评审 |
SCI | SCI英文论文 | 针对WRR/Nature Water等国际顶刊 |
CN | 中文核心期刊论文 | 针对水利学报/中国科学等 |
PAT | 发明专利 | 中国发明专利申请文件 |
STD-CN | 国内技术标准 | GB/T、SL/T、DB、T/ 行业标准/团体标准/企业标准 |
STD-INT | 国际技术标准 | ISO、IEC、OGC、IWA、IAHR技术报告 |
WX | 微信公众号文章 | 科普/行业分析/观点输出，手机阅读优化 |
PPT | 演示文稿 | 学术汇报/项目答辩/产品发布/国际会议演讲 |
用户指令 → 读取规格 → [写作] → [多角色评审] → 达标？
↑ ↓ 否
└── [修改] ←┘
↓ 是
保存终稿 → 更新进度 → 提示"继续"
所有文体共享此流程，仅评审角色和质量标准因文体而异。
references/scoring_rubrics.md 锚点标准逐维度打分并给出修改意见| 文体 | 达标条件 | 评分制 |
|---|---|---|
| SCI | 连续2轮所有评审角色给出"小修"或"接受" | Major/Minor/Accept |
| CN | 连续2轮所有评审角色给出"小修"或"接受" | Major/Minor/Accept |
| PAT | 综合评分 ≥ 7.5/10 | 1-10 数值打分 |
| BK | 综合评分 ≥ 8.0/10 且无🔴标记 | 🔴/🟡/🟢 三级 |
| RPT | 综合评分 ≥ 7.0/10 | 1-10 数值打分 |
| STD-CN | 综合评分 ≥ 8.0/10 且条文合规率100%（GB/T 1.1-2020） | 1-10 + 合规检查 |
| STD-INT | 综合评分 ≥ 8.0/10 且条文合规率100%（ISO/IEC Directives Part 2） | 1-10 + 合规检查 |
| WX | 综合评分 ≥ 7.5/10 且无🔴标记，自动检查脚本通过 | 1-10 + 脚本检查 |
| PPT | 综合评分 ≥ 7.5/10 且无🔴标记，风格指南合规 | 1-10 + 设计检查 |
写作技法: 撰写初稿时须参照
references/writing_craft_guide.md中的文体技法和句型库。 金标准片段: 撰写和评审时须参照references/gold_standard_fragments.md中的优秀范文片段。 评分锚点: 评审打分时须参照references/scoring_rubrics.md中的量化锚点标准。9-10=卓越 / 7-8=良好 / 5-6=一般 / <5=不合格。
| 角色 | 身份 | 评审维度 |
|---|---|---|
| Reviewer A | 该领域顶刊资深审稿人 | 创新性、理论深度、数学严谨性、文献完备性 |
| Reviewer B | 方法论专家 | 实验设计、可重复性、数据分析、统计显著性 |
| Reviewer C | 应用领域工程师 | 工程可行性、案例说服力、实际影响力 |
评审输出格式：
## Reviewer [A/B/C] 评审意见
**Decision**: [Major Revision / Minor Revision / Accept]
**Summary**: 一段话总结论文贡献和主要问题
**Specific Comments**:
1. [具体意见 + 修改建议]
2. ...（至少5条）
**Minor Issues**: 语法、格式、引用等细节问题
═══ SCI论文评审汇总 ═══
Reviewer A: [Major/Minor/Accept] 关键意见: [摘要]
Reviewer B: [Major/Minor/Accept] 关键意见: [摘要]
Reviewer C: [Major/Minor/Accept] 关键意见: [摘要]
综合判定: [达标(连续2轮全Minor/Accept) / 未达标]
SCI专有规则：
| 角色 | 身份 | 评审维度 |
|---|---|---|
| 审稿人A | 学科专家 | 理论创新性、学术规范、文献综述深度 |
| 审稿人B | 工程应用专家 | 工程实用性、案例数据可信度、成果推广价值 |
| 审稿人C | 期刊编辑视角 | 行文逻辑、中文学术写作规范、图表质量、参考文献格式 |
中文论文专有规则：
评审输出格式：
═══ 中文核心期刊论文评审汇总 ═══
文件: [标题] | 目标期刊: [期刊名]
审稿人A（学科）: [大修/小修/录用]
意见: 1. ... 2. ...（至少5条）
审稿人B（工程）: [大修/小修/录用]
意见: 1. ... 2. ...（至少5条）
审稿人C（编辑）: [大修/小修/录用]
意见: 1. ... 2. ...
综合判定: [达标(连续2轮全小修/录用) / 未达标]
| 角色 | 身份 | 评审维度 |
|---|---|---|
| 审查员 | 专利审查员 | 新颖性、创造性、充分公开、权利要求完整性、实用性 |
| 代理人 | 资深专利代理人 | 保护范围适当性、从属权利要求层次、与同族群专利区分度 |
| 技术专家 | 水利自动化技术专家 | 公式算法正确性、技术效果可信度、工程可实施性 |
专利专有规则：
评审权重: 审查员40% + 代理人30% + 技术专家30%
评审输出格式：
═══ 发明专利评审汇总 ═══
文件: [专利名称] | 权利要求数: X项
审查员 (40%): X/10
新颖性: 通过/未通过 | 创造性: 通过/未通过
意见: 1. ... 2. ...
代理人 (30%): X/10
保护范围: 偏宽/适当/偏窄
意见: 1. ... 2. ...
技术专家 (30%): X/10
意见: 1. ... 2. ...
加权均分: X/10
达标判定: [达标(≥7.5) / 未达标]
| 角色 | 身份 | 评审维度 |
|---|---|---|
| 教师 | 学科教师 | 教学可用性、知识递进逻辑、例题/思考题质量 |
| 专家 | 学科资深学者 | 学术准确性、理论深度、前沿覆盖度 |
| 工程师 | 行业工程师 | 工程实用性、案例真实性、操作指导价值 |
| 国际读者 | 英文版跨文化评审 | 术语准确性、表达可达性、国际读者理解障碍 |
评审输出格式：
## [角色名] 评审
**总评**: 🟢/🟡/🔴
**评分**:
- 内容准确性: X/10
- 教学效果: X/10
- 实用价值: X/10
- 写作质量: X/10
- 图表质量: X/10
**必须修改 (🔴)**: ...
**建议修改 (🟡)**: ...
**锦上添花 (🟢)**: ...
═══ 书稿评审汇总 ═══
教师: X/10 | 专家: X/10 | 工程师: X/10 | 国际读者: X/10
均分: X/10
达标判定: [达标(≥8.0且无🔴) / 未达标]
书稿专有规则：
references/citation_style_guide.md §5）：
| 角色 | 身份 | 评审维度 |
|---|---|---|
| 技术审查人 | 项目委托方技术负责人(60%) | 技术方案完整性、数据可靠性、结论合理性 |
| 管理审查人 | 项目管理者(40%) | 报告结构、执行摘要质量、建议可操作性、经费合理性 |
报告专有规则：
评审输出格式：
═══ 技术报告评审汇总 ═══
文件: [报告名称] | 类型: [项目报告/可研报告/技术方案/验收报告]
技术审查人 (60%): X/10
意见: 1. ... 2. ...（至少5条）
管理审查人 (40%): X/10
执行摘要测试: 通过/未通过
意见: 1. ... 2. ...（至少5条）
加权均分: X/10
达标判定: [达标(≥7.0) / 未达标]
| 角色 | 身份 | 评审维度 |
|---|---|---|
| 标准化专家 | 标准化技术委员会委员，精通GB/T 1.1-2020 | GB/T 1.1合规、前言要素、条文用语（应/宜/可/不应/不宜）、引用标准有效性、术语定义法、量和单位 |
| 技术专家 | 水利自动化领域教授级高工 | 技术指标取值依据、WSAL分级合理性、测试方法可行性、与CHS体系一致性、协议覆盖度 |
| 实施方代表 | 水利工程集成企业技术总监 | 可操作性、指标可达性、检测成本与周期、兼容现有SCADA升级、中小型工程可行性 |
国内标准专有规则：
评审权重: 标准化专家40% + 技术专家35% + 实施方代表25%
评审输出格式：
═══ 国内标准评审汇总 ═══
文件: [SL/T XXXX] [标题] | 标准层级: [GB/T / SL/T / DB / T/]
标准化专家 (40%): X/10 | 条文合规率: X%
意见: 1. ... 2. ...
技术专家 (35%): X/10
意见: 1. ... 2. ...
实施方代表 (25%): X/10
意见: 1. ... 2. ...
加权均分: X/10
达标判定: [达标(≥8.0且合规率100%) / 未达标]
参考范例：research-materials/reports/SLT_水网智能调控系统技术要求_V3_征求意见稿.docx
注：地方标准(DB)和团体标准(T/)在结构上与行标(SL/T)一致，但归口单位和审批流程不同，前言中须相应调整。
| 角色 | 身份 | 评审维度 |
|---|---|---|
| ISO标准化专家 | ISO/TC资深专家，精通ISO/IEC Directives Part 2 | 结构合规、术语符合ISO 704、条文用语（shall/should/may）、英法双语标题、文件阶段标识、与SAE J3016/IEC 62443/ISO 21448对标 |
| 国际水利专家 | IAHR/IWA高级会员，非中国背景 | 国际普适性、术语国际通用性、中国案例适度引用、SI单位制、覆盖多国实践、与ISO 24591关系、英文表述规范 |
| 工业界代表 | 国际水利自动化企业CTO级别 | 技术壁垒/厂商偏向风险、FMI/DDS/OPC UA工业实现度、SIL/HIL成本-收益、IPR声明、过渡期安排 |
国际标准专有规则：
评审权重: ISO标准化专家40% + 国际水利专家35% + 工业界代表25%
评审输出格式：
═══ 国际标准评审汇总 ═══
文件: [ISO/CD XXXXX] [标题] | 阶段: [WD/CD/DIS/FDIS]
ISO标准化专家 (40%): X/10 | 条文合规率: X%
意见: 1. ... 2. ...
国际水利专家 (35%): X/10
意见: 1. ... 2. ...
工业界代表 (25%): X/10
意见: 1. ... 2. ...
加权均分: X/10
达标判定: [达标(≥8.0且合规率100%) / 未达标]
参考范例：research-materials/reports/ISO_CD_XXXXX_Water_Network_Intelligent_Control_Draft.docx
| 角色 | 身份 | 评审维度 |
|---|---|---|
| 读者代表 | 目标受众（工程师/决策者/泛科普） | 3秒吸引力、走神点、核心观点可提炼性、转发意愿 |
| 编辑 | 公众号运营编辑 | 手机排版、段落长度、禁用词、自动检查脚本通过率 |
| 领域专家 | CHS/智慧水利技术专家 | 数据准确性、百分比反算、因果链、术语准确性 |
评审权重: 读者代表40% + 编辑30% + 领域专家30%
评审输出格式：
═══ 公众号文章评审汇总 ═══
文件: [标题] | 字数: XXXX字
读者代表 (40%): X/10
3秒测试: 通过/未通过 | 走神点: [位置]
意见: 1. ... 2. ...（至少5条）
编辑 (30%): X/10
自动检查: 🔴X项 / 🟡X项 / ⚪X项
意见: 1. ... 2. ...
领域专家 (30%): X/10
数据验证: X处数据，Y处已验证，Z处存疑
意见: 1. ... 2. ...
加权均分: X/10
达标判定: [达标(≥7.5且无🔴+脚本通过) / 未达标]
公众号文章专有规则（手机阅读铁律）：
段落与句子：
排版与视觉：
--- 分隔线开头与结尾：
语言风格：
数据规范：
自动检查：
scripts/check_article.py输出格式：
特殊场景：
> 引用块更正说明（≤3段）| 角色 | 身份 | 评审维度 |
|---|---|---|
| 听众代表 | 目标观众（评委/验收专家/领导/国际听众）(35%) | 开场吸引力、叙事逻辑链、信息密度、节奏感、记忆点、行动召唤 |
| 设计审查 | 资深PPT设计师(30%) | 配色规范（蓝红体系）、字体规范（微软雅黑）、排版规范（16:9）、视觉元素一致性 |
| 内容专家 | CHS/智慧水利领域专家(35%) | 技术准确性、数据来源、逻辑完整性、Speaker Notes覆盖率、时间控制、术语一致性 |
PPT风格指南（强制遵循）：
以下为关键约束的速查版。完整风格指南（含素材清单）见
references/ppt_style_guide.md，以该文件为权威来源。
配色核心约束：
字体核心约束：
排版规范：
视觉元素：
内容规范：
技术实现：
评审输出格式：
═══ 演示文稿评审汇总 ═══
文件: [标题].pptx | 页数: XX页 | 目标时长: XX分钟
听众代表 (35%): X/10
开场测试: 通过/未通过 | 文字墙页面: [页码]
记忆点: [能否提炼3个]
意见: 1. ... 2. ...
设计审查 (30%): X/10
配色合规: X/6 | 字体合规: X/6 | 排版合规: X/5 | 视觉合规: X/3
意见: 1. ... 2. ...
内容专家 (35%): X/10
讲稿覆盖率: X% | 数据验证: X处
意见: 1. ... 2. ...
加权均分: X/10
达标判定: [达标(≥7.5且无🔴+风格合规) / 未达标]
PPT文体附加步骤: 初稿生成后须用LibreOffice转PDF进行视觉QA，确认配色/字体/排版与风格指南一致。详细风格规范见
references/ppt_style_guide.md。
每个项目维护一个 progress.json：
{
"project": "项目名称",
"total": 25,
"completed": 3,
"documents": {
"SCI-P1a": {
"type": "SCI",
"title": "论文标题",
"target": "Water Resources Research",
"status": "in_review_v9",
"current_version": 9,
"last_review_result": "minor_revision",
"consecutive_passes": 1,
"updated_at": "2026-02-19T10:00:00Z"
}
}
}
not_started → drafting → in_review_v{N} → revising_v{N} → in_review_v{N+1} → ... → completed
→ manual_review_needed
docs/
├── SCI-P1a/
│ ├── draft_v01.md
│ ├── review_v01.md
│ ├── response_v01.md
│ ├── draft_v02.md
│ ├── draft_final.md
│ ├── references.bib
│ └── figures/
├── PAT-PF1-1/
│ ├── draft_v01.md
│ └── ...
├── BK-M1/
│ ├── ch01_v01.md
│ ├── ch01_review_v01.md
│ ├── ch01_final.md
│ └── ...
├── STD-CN-SLT-XXXX/
│ ├── draft_v01.docx
│ ├── review_v01.md
│ └── ...
├── WX-水网操作系统科普/
│ ├── draft_v01.md
│ ├── check_report_v01.txt
│ └── draft_final.md
├── PPT-理论与体系汇报/
│ ├── create_ppt.js
│ ├── slides_v01.pptx
│ ├── review_v01.md
│ └── slides_final.pptx
└── progress.json
步骤1: 识别文档类型和编号
步骤2: 读取 progress.json（如存在），确认该文档当前状态
步骤3: 读取该文档的写作规格（从 docs/project_config.yaml 或用户提供，格式见 references/project_config_template.md）
步骤4: 如有前序版本/前序章节，读取最近内容用于衔接
步骤5: 用 web_search 进行背景检索（按文体差异化）
- SCI/CN: 检索近5年顶刊相关论文，确认创新性
- PAT: 检索5篇最接近的已有专利，确认新颖性
- BK: 检索同类教材/专著，确认定位差异
- RPT: 检索相关项目报告和技术标准
- STD-CN: web_search逐一确认规范性引用文件(GB/T, SL/T)现行有效
- STD-INT: 确认Normative references为现行ISO/IEC/OGC标准
- WX: 检索热点数据、竞品文章、最新行业动态
- PPT: 检索最新数据/成果、确认引用图表来源
步骤6: 参照 `references/writing_craft_guide.md` 对应文体技法，按文体模板撰写初稿
⚠️ 参考文献铁律：每一条参考文献必须真实可查，格式必须规范，**绝不编造**。
不确定的文献标注 `⚠️ 待核实`，提醒用户人工确认。
格式规范见 `references/citation_style_guide.md`。
步骤6.5: 【参考文献验证关卡——不可跳过】
本步骤为硬性关卡，🔴项未清零不得进入步骤7。
a) 运行 `scripts/check_references.py <文件> --type [类型]`
b) 用 web_search 逐一验证参考文献真实性：
- SCI/CN: 抽查≥50%（≥15篇），验证DOI/标题/作者/期刊/卷期
- BK(教材/专著): 抽查≥30%，验证书名/出版社/年份/ISBN
- PAT: 验证100%对比文件的公开号真实存在
- STD: 验证100%规范性引用标准现行有效
- RPT: 抽查≥30%数据来源的真实性
c) 核查格式规范：
- CN/BK/RPT: GB/T 7714-2015（含[J]/[M]/[C]/[D]/[S]/[R]类型标识）
- SCI: 与目标期刊Author Guidelines完全一致
- PAT: 背景技术引用标注完整公开号
- STD-CN: 规范性引用文件含标准导语
d) 核查数量达标（见§7.3.4数量表）
e) 🔴项清零 → 进入步骤7；🔴项未清零 → 修正后重新运行检查
步骤7: 进入多角色评审循环
步骤8: 达标后保存终稿，更新 progress.json
步骤9: 输出："✅ [文档编号] 已完成，输入'继续'进入下一个"
统一质量调度器：
scripts/run_checks.py <文件> --type [类型]自动按顺序运行所有适用检查（通用质量→参考文献→文体专属），🔴=0方可进入评审。文体特殊步骤：
- WX: 步骤6后运行
scripts/check_article.py（14项检查），🔴项清零后方可评审。- STD-CN: 步骤6后运行
scripts/check_standard.py --type cn（条文用语+结构合规），合规率须100%。- STD-INT: 步骤6后运行
scripts/check_standard.py --type int（ISO合规+英法双语），合规率须100%。- 所有文体: 步骤6.5为强制关卡——必须运行
scripts/check_references.py并用web_search验证文献真实性，🔴项清零后方可进入评审。- PPT: 步骤6使用 pptxgenjs 生成 .pptx，步骤7前运行
scripts/check_ppt.py [--duration 分钟]。- SCI/CN/PAT/BK/RPT: 步骤7前运行
scripts/check_quality.py --type [类型]（公式/术语/一致性检查，参考文献已在6.5检查）。
步骤1: 读取 progress.json
步骤2: 找到下一个未完成的文档（或当前文档的下一章）
步骤3: 从步骤3（§4.1）开始执行
如果对话中断后重新开始，发送"继续"即可。系统会：
当文档字数超过5万字时，一次性生成往往因上下文窗口溢出而失败。本节定义四级策略，根据字数规模选择合适的生成方式。
| 级别 | 文档规模 | 策略 | 适用场景 |
|---|---|---|---|
| L1 | < 3万字 | 单轮生成：直接生成完整MD→转docx | 单章节、短报告 |
| L2 | 3-10万字 | 分模块生成：按章拆分→分别生成→组装→转docx | 一般专著单部分、技术报告 |
| L3 | 10-30万字 | 模块化流水线：目录→模块拆分→批量生成→组装→统计验证→docx | 完整专著、大型技术报告 |
| L4 | > 30万字 | 增量迭代：L3基础上+增量修改+版本标签+四角色评审循环 | 系列丛书、超大型专著 |
模块拆分原则：
.md文件，放入modules/目录p{部分号}_s{节号}_{英文描述}.md（如p2_s4_canal_control.md）p0_front_matter.md（前言/目录）、p5_references.md（参考文献）、p6_glossary.md（术语表）组装脚本：将所有模块按顺序拼接为report_full_assembled.md，每次修改后重新组装并统计：
版本管理：
git commit并标注版本号（如v03、v04）git tag（如git tag v04）基于BK专著v01→v04实战，以下可读性规则已验证有效：
| 规则 | 阈值 | 检测方法 |
|---|---|---|
| 段落长度上限 | ≤ 400字/段 | 统计空行间字符数 |
| 术语首次出现释义 | 跨学科术语100%标注 | 检查（英文，中文释义）格式 |
| 概念速览框 | 每个跨学科章节入口≥1个 | 检查"📖给水利工程师的速览"标记 |
| 章末小结格式 | ### §x.x 本节小结 + ---分隔线 | 正则匹配 |
| 图表前后空行 | 图表引用块前后各1空行 | 检查> **图/表前后 |
| 思考题分隔 | ---分隔线 + 四级难度（L1概念→L4综合） | 正则匹配 |
| 元素 | 格式要求 |
|---|---|
| 正文 | 宋体12pt，段前段后6pt |
| 一级标题(#) | Heading 1 |
| 二级标题(##) | Heading 2 |
| 三级标题(###) | Heading 3 |
| 表格 | Light Grid Accent 1样式，9pt字体 |
| 代码块 | Courier New 8pt，左缩进1cm |
| 引用块(>) | 左缩进1cm，10.5pt |
| 图表标题 | 居中，加粗，11pt |
以下规则针对claude.ai网页端用
create_file+bash_tool生成.docx的场景。
问题诊断：当文档内容超过约8000字时，单个JS文件内嵌全部中文字符串字面量会导致：
create_file传输超时或截断强制分级生成策略：
| 字数 | 方法 | 要点 |
|---|---|---|
| ≤5000字 | JS直接内嵌 | 常规docx库生成 |
| 5001-12000字 | 数据-引擎分离 | 内容→content.json(纯文本数据) + 通用engine.js(格式引擎) |
| 12001-25000字 | 分段组装 | 按节写入多个.md→合并→python-docx生成 |
| >25000字 | 多文件分册 | 拆为多个独立.docx，交付用户合并 |
数据-引擎分离模式（L2核心）：
步骤A: create_file → content.json (每段标注类型: h1/h2/h3/para/table/blockquote)
步骤B: create_file → engine.js (通用格式引擎，约200行，读取JSON生成docx)
步骤C: bash_tool → node engine.js → output.docx
关键防失败规则：
各文体典型级别：
| 文体 | 典型字数 | 推荐级别 |
|---|---|---|
| WX公众号 | 3000-5000 | L1 |
| SCI论文 | 8000-15000 | L2 |
| CN论文 | 6000-10000 | L2 |
| 发明专利 | 5000-8000 | L1-L2 |
| 单章书稿 | 15000-30000 | L3 |
| 完整专著 | 100000-400000 | L4 |
| 技术报告 | 10000-50000 | L2-L3 |
| 技术标准 | 15000-30000 | L3 |
| 中文 | English | 缩写 |
|---|---|---|
| 水系统控制论 | Cybernetics of Hydro Systems | CHS |
| 水网操作系统 | Hydraulic Network Operating System | HydroOS |
| 水网自主运行等级 | Water-network Self-driving Autonomy Level | WSAL(L0-L5) |
| 运行设计域 | Operational Design Domain | ODD |
| 积分延迟零模型 | Integrator Delay Zero model | IDZ |
| 分布式模型预测控制 | Distributed Model Predictive Control | DMPC |
| 多智能体系统 | Multi-Agent System | MAS |
| 模型在环/软件在环/硬件在环 | Model/Software/Hardware-in-the-Loop | MIL/SIL/HIL |
| 安全包络 | Safety Envelope | SE |
| 认知智能 | Cognitive Intelligence | CI |
| 瀚铎水网大模型 | Hando Water Network Large Model | HWLM |
| 符号 | 含义 | 首次定义于 |
|---|---|---|
| G(s) | 渠池传递函数 | SCI-P1a |
| H(s) | 控制器传递函数 | SCI-P1a |
| A_s | 水面面积 | SCI-P1a |
| τ^d | 延迟时间 | SCI-P1a |
| α, β | IDZ模型参数 | SCI-P1a |
| Q | 流量 (m³/s) | 通用 |
| Z | 水位 (m) | 通用 |
| n | 糙率 (Manning系数) | 通用 |
| S_0 | 底坡 | 通用 |
| B | 渠道底宽 | 通用 |
写公众号时，专业概念必须翻译为读者能理解的语言：
| 专业概念 | 公众号表述 | 推荐类比 |
|---|---|---|
| 水系统控制论(CHS) | 一门研究"水网怎么运行"的学问 | 相当于电力系统的自动控制理论 |
| HydroOS | 水网的操作系统 | 相当于手机的Android/iOS |
| 自主运行水网 | 能"自己跑"的水网 | 从人工驾驶到自动驾驶 |
| Saint-Venant方程 | 描述水流运动的基本方程 | 牛顿运动定律之于力学 |
| 传递函数/IDZ模型 | 简化版的水流计算模型 | 用近似公式代替精确计算 |
| SCADA系统 | 水利工程的监控系统 | 工厂的中控室 |
| MPC(模型预测控制) | "看远一步再行动"的控制方法 | 下棋时多看几步 |
| ODD(运行设计域) | 系统能安全工作的条件范围 | 自动驾驶的适用场景 |
| SIL/HIL(在环测试) | 在虚拟/半实物环境中测试系统 | 飞行模拟器训练飞行员 |
| 数字孪生 | 水利工程的虚拟镜像 | 在电脑中复制一个真实世界 |
| DMPC | 各渠段"商量着来"的控制方法 | 高速公路各收费站协调限流 |
| MAS(多智能体) | 多个AI小助手分工协作 | 蜂群各司其职但协同工作 |
| WSAL(L0-L5) | 水网自动化的"段位" | 自动驾驶L0-L5等级 |
常用背景数据（WX文体引用时必须注明来源）：
以下核心内容在多篇文档中出现时，必须保持一致：
| 编号 | 内容 | 涉及文档 |
|---|---|---|
| CONS-01 | CHS八原理的表述 | 所有SCI/CN/BK |
| CONS-02 | WSAL(L0-L5)定义 | 所有SCI/CN/PAT/BK/STD-CN/STD-INT |
| CONS-03 | Saint-Venant方程的离散化表述 | SCI-P1a, BK-T2a, PAT-PF1系列 |
| CONS-04 | MPC控制原理描述 | SCI-P2系列, BK-M2, PAT-PF2系列 |
| CONS-05 | HydroOS五层架构 | SCI-P5c, BK-M7, PAT-PF7系列, STD-CN/STD-INT |
| CONS-06 | 胶东调水工程参数 | SCI工程线, BK-M8, PAT工程专利 |
| CONS-07 | 沙坪水电站工程参数 | SCI工程线, BK-M8, PAT工程专利 |
| CONS-08 | 南水北调中线工程参数 | 多篇SCI/CN/BK |
| CONS-09 | 安全包络ODD边界条件 | SCI-P2c, BK-M3, PAT-PF3系列, STD-CN/STD-INT |
| CONS-10 | §5.1术语表中英对照 | 所有文体（WX用§5.3翻译表，PPT遵循同一术语体系） |
自动检查脚本:
scripts/check_consistency.py <文档目录>该脚本自动扫描已完成文档，逐条检查CONS-01~10，检测术语全称不一致、工程参数数值差异等问题。
每篇文档终稿前必须通过以下检查：
铁律：参考文献必须真实、准确、格式规范。绝不编造不存在的文献。 格式规范：完整格式要求见
references/citation_style_guide.md。 自动检查：scripts/check_references.py <文件> --type [类型]
⚠️ 待核实，提醒用户人工确认| 文体 | 最低数量 | 近5年≥ | 自引率 | 特殊要求 |
|---|---|---|---|---|
| SCI | ≥30篇 | 50% | 15-25% | 会议论文≤20% |
| CN | ≥20篇 | 40% | 10-20% | 含国内外对比文献 |
| BK(教材) | 每章≥10，全书≥100 | 30% | ≤15% | 含推荐阅读 |
| BK(专著) | 每章≥15，全书≥200 | 40% | 15-25% | 覆盖所有重要流派 |
| RPT | ≥10篇 | 按需 | 按需 | 数据来源必须标注 |
| PAT | ≥3篇对比文件 | — | — | 背景技术引用公开号 |
撰写时引用雷晓辉自有文献，必须使用 references/citation_style_guide.md §9中的标准格式，确保全系统一致。
scripts/check_article.py 脚本，🔴项为零--- 分隔线自动检查脚本:
scripts/check_standard.py <文件> --type cn|int
自动检查脚本:
scripts/check_ppt.py <文件> [--duration 分钟]
Title
Authors and Affiliations
Abstract (150-300 words)
Keywords (3-8)
1. Introduction
2. Literature Review / Background
3. Methodology / Theoretical Framework
4. Case Study / Numerical Experiments
5. Results and Discussion
6. Conclusions
Acknowledgments
Data Availability Statement
References
Appendix (if needed)
题名
作者 单位
摘要 (200-300字)
关键词 (3-8个)
中图分类号 文献标志码
引言
1 方法/理论
2 模型/算法
3 案例验证
4 结果与讨论
5 结论
参考文献
英文标题、作者、摘要、关键词
（一）技术领域 (50-100字，三级分类)
（二）背景技术 (500-800字，3-5个现有技术缺陷)
（三）发明内容
- 所要解决的技术问题
- 技术方案
- 有益效果
（四）附图说明 (至少3幅图)
（五）具体实施方式 (2000-4000字，含完整实施例)
（六）权利要求书 (8-15项)
- 独立权利要求：前序+特征两段式
- 从属权利要求：逐层细化
（七）摘要 (150-300字)
# 第X部分 部分标题（中文）
Part X: Part Title (English)
[部分导言 500-1000字：场景切入→核心问题→各章路线图→与前后部分衔接]
## X.1 节标题（中文标题 English Title）
> ---
> 📖 给水利工程师的速览：[核心问题]？ （跨学科章节必须）
> [200字白话文回答"这对水利工程师意味着什么"]
> ---
[正文内容：段落≤400字，跨学科术语首次出现标注（英文，中文释义）]
> **概念辨析框：XXX vs YYY** （关键概念边界澄清时使用）
> ...
> **图 X-Y 图标题** （ASCII art或描述，前后各留1空行）
> *Fig. X-Y English caption*
| 表X-Y 表标题 | | | | （量化数据表格）
---
### §X.1 本节小结
[300-500字，概括核心结论，衔接下一节]
---
**思考与讨论**
1. （概念理解）L1题...
2. （计算练习/分析比较）L2-L3题...
3. （综合设计/批判思考）L3-L4题...
[参考文献放在全书末尾，统一编号]
模块化文件规范（>10万字时必须）：
modules/p{部分号}_s{节号}_{英文描述}.mdp0_front_matter.md, p5_references.md, p6_glossary.mdreport_full_assembled.mdcheck_readability.py 验证封面（项目名称、编号、编制单位、日期）
修订记录
执行摘要
目录
1 项目概况
2 技术方案
3 实施过程
4 成果分析
5 结论与建议
附录
参考文献
封面（标准编号、ICS分类号、中国标准文献分类号）
目次
前言（起草规则声明、归口单位、起草单位、起草人）
引言（编制背景与目的，可选）
1 范围（适用对象、适用边界、不适用范围）
2 规范性引用文件（逐一web_search确认现行有效）
3 术语和定义（"属概念+种差"定义法）
4 缩略语（可选）
5 总则/一般规定
6-N 技术要求各章（用语：应/宜/可/不应/不宜）
附录A (规范性) 测试方法
附录B (资料性) 示例/计算方法
参考文献 (资料性)
Cover page (ISO/CD XXXXX, TC/SC/WG info)
Contents
Foreword (TC/SC info, drafting basis, version notes)
Introduction (industry background, pain points, scope rationale)
1 Scope (applicable systems, exclusions)
2 Normative references (ISO/IEC/OGC only, all current)
3 Terms and definitions (ISO 704 compliant, reference OBP)
4 Abbreviated terms
5-N Technical requirements (wording: shall/should/may)
Annex A (normative) Test methods / protocol matrices
Annex B (informative) Examples / comparisons (e.g. SAE J3016 mapping)
Bibliography
# 标题（15字以内为佳，最多22字）
**引子第一段（加粗的核心判断或钩子）**
引子2-3段（150字内，制造好奇心或紧迫感）
---
## 一、第一节标题 — 现状/问题/背景
正文段落（每段≤150字）...
**点睛句独立成段。**
正文段落...
---
## 二、第二节标题 — 核心观点/分析
正文段落...
---
## 三~五、展开论述各节
...
---
## 六、收束节标题（不写"总结"/"结论"）
有余味的收束段落（回扣开头/新问题/有力判断）
公众号文章字数与结构参考：
| 类型 | 字数范围 | 节数 | 每节字数 | 阅读时间 |
|---|---|---|---|---|
| 短文 | 1500-2500字 | 4-6节 | 300-500字 | 3-5分钟 |
| 中篇 | 2500-4000字 | 6-8节 | 400-600字 | 5-8分钟 |
| 长文 | 4000-6000字 | 7-9节 | 500-800字 | 8-12分钟 |
Slide 1: 封面（项目名称 + 单位Logo + 汇报人 + 日期）
Slide 2: 目录/纲要（分章节，带编号）
Slide 3: 过渡页 — 第一章节标题
Slide 4-N: 内容页（图文1:1，每页一个核心信息）
Slide N+1: 过渡页 — 第二章节标题
...循环...
Slide M-1: 总结/展望页
Slide M: 结尾页（"谢谢" / "Thank You"）
PPT页数与时长参考：
| 场景 | 汇报时长 | 建议页数 | 每页时间 |
|---|---|---|---|
| 项目答辩 | 15-20分钟 | 15-25页 | 1-1.5分钟 |
| 学术报告 | 30-40分钟 | 30-40页 | 1分钟 |
| 产品发布 | 45-60分钟 | 35-50页 | 1-1.5分钟 |
| 国际会议 | 15-20分钟 | 15-20页 | 1分钟 |
| 简短汇报 | 5-10分钟 | 8-12页 | 1分钟 |
PPT页面类型配比建议：
| 文体 | 自引率范围 | 说明 |
|---|---|---|
| SCI | 15-25% | 体系内互引 + 已发表Lei2025a-d |
| CN | 10-20% | 合理引用前期成果 |
| PAT | 不适用 | 背景技术不刻意自引 |
| BK | 3-15% | 按章节性质灵活控制 |
| RPT | 无目标 | 按项目需求引用，无自引率要求 |
| STD-CN | 无目标 | 规范性引用须为现行有效国标/行标，非学术自引概念 |
| WX | 无目标 | 数据须注明来源，但不涉及学术引用管理 |
| STD-INT | 无目标 | 规范性引用须为现行ISO/IEC标准，非学术自引概念 |
| PPT | 无目标 | 数据页须标注来源，但不涉及学术引用管理 |
经典文献：Wiener 1948, Kalman 1960, Wylie 1969, Malaterre 1998, Buyalski 1991, VanOverloop 2006, Litrico & Fromion 2009
Lei 代表作（已发表）：Lei 2025a (水网自主调控), Lei 2025b (CHS基本理论), Lei 2025c (在环测试体系), Lei 2025d (水资源系统分析)
[FIGURE-ID: fig_XX]
[TYPE: 系统架构图/流程图/数据曲线/对比柱状图/示意图]
[DESCRIPTION: 详细描述图表内容]
[KEY ELEMENTS: 列出必须包含的元素]
[STYLE: 学术论文风格/教材插图风格/专利附图风格]
按依赖关系分批：
Batch 1: 基础理论文档（无依赖）
Batch 2: 方法论文档（依赖Batch 1）
Batch 3: 实验验证文档（依赖Batch 1+2）
Batch 4: 工程应用文档（依赖Batch 1+2+3）
以25篇论文的水系统控制论学术矩阵为例：
Batch 1 (基础理论) Batch 2 (方法论) Batch 3 (验证) Batch 4 (应用)
────────────────── ────────────────── ────────────────── ──────────────────
SCI-P1a: IDZ建模 SCI-P2a: DMPC框架 SCI-P3a: 中线验证 BK-ch05: 案例章节
↓ ↓ ↓ ↓
SCI-P1b: 参数辨识 SCI-P2b: MAS架构 SCI-P3b: 胶东验证 RPT-01: 项目报告
↓ ↓ ↓ ↓
CN-C1: 综述论文 PAT-PF2: 控制专利 SCI-P3c: 对比实验 STD-CN: 行业标准
批次间规则：
check_consistency.py）# 单文档检查
python3 scripts/run_checks.py paper.md --type sci
# 批次完成后跨文档检查
python3 scripts/check_consistency.py ./batch1_outputs/
# 全局审计（所有批次完成后）
for f in outputs/*.md; do python3 scripts/run_checks.py "$f"; done
python3 scripts/check_consistency.py ./outputs/
每个批次完成后执行：
| 异常情况 | 处理方式 |
|---|---|
| web_search无法访问 | 基于已有知识继续，标注"待补充检索验证" |
| 评审分数始终无法达标 | 超出上限后输出当前最好版本 + 问题清单 |
| 用户规格不完整 | 询问缺失信息或基于同类文档合理推断 |
| 跨文档一致性冲突 | 以先完成的文档为准，提示用户确认 |
| 会话token接近上限 | 保存当前进度，提示开新会话 |
| pptxgenjs生成失败(PPT) | 检查Node.js环境和依赖，降级为手动排版指导 |
| 字体不可用(PPT) | 降级为系统默认无衬线字体，标注"字体待替换" |
| 引用标准已废止(STD) | web_search查找替代标准，标注"⚠️ 原引用已废止，建议替换为XXX" |
| LibreOffice不可用(PPT) | 跳过视觉QA步骤，标注"待人工视觉检查" |
将本SKILL.md放入工作目录即可：
cd ~/my-project
claude
> 开始SCI-P1a
新对话中提供本文件核心内容 + 文档规格 + 进度状态即可。
开始[类型][编号] — 启动写作继续 — 推进下一个═══════════════════════════════════════
文档: [编号] v[版本号] | 类型: [SCI/CN/PAT/BK/RPT/STD-CN/STD-INT/WX/PPT]
评审轮次: 第[N]轮
═══════════════════════════════════════
[角色1] 决定/评分: [值] 关键意见: [摘要]
[角色2] 决定/评分: [值] 关键意见: [摘要]
[角色3] 决定/评分: [值] 关键意见: [摘要]
[角色4] 决定/评分: [值] 关键意见: [摘要]
综合判定: [达标/未达标] | 综合评分: [值]
下一步: [进入修改v{N+1} / 保存终稿 / 标记人工审核]
═══════════════════════════════════════