lunwen
- Repo stars 554
- Author updated Live
- Author repo lunwen-skill
- Domain
- Documentation
- Compatible agents
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- Trust score
- 88 / 100 · community maintained
- Author / version / license
- @Doryoku1223 · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No special requirements
- Permissions
-
- Read-only
- Shell exec
- Write / modify
- Network behavior
- Local-only
- Install commands
- 26 variants
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: lunwen
description: 这个技能用于把“真实项目事实 + 样文/模板 + 文献约束 + 图表截图 + Word 成稿要求”稳定转化为一篇可交付的中文论文。目标不是把论文写厚,而是按样文体量、真实项目能力和版式规则,输…
category: documentation
runtime: no special runtime
---
# lunwen output preview
## PART A: Task fit
- Use case: 这个技能用于把“真实项目事实 + 样文/模板 + 文献约束 + 图表截图 + Word 成稿要求”稳定转化为一篇可交付的中文论文。目标不是把论文写厚,而是按样文体量、真实项目能力和版式规则,输出结构完整、字数可控、图表齐全的 .docx 成稿。 已完成样文 / 模板 / 任务书分析,但未开写。 用户已确认目录、字数和样式方案。 首次响应论文请求时,必须主动告诉用户可以直接提供模板、历届样文、开题报告、任务书或封面要求的本地路径,示例格式如: runs entirely locally. Works with Claude Code, Cursor, Cline and 23 more..
- Inputs: target material, constraints, expected output, and acceptance criteria.
- Evidence boundary: follow “Overview / Hard Gates / Execution States” and do not present inference as author intent.
## PART B: Execution result
- **01** The card summarizes the use case; runtime output centers on “这个技能用于把“真实项目事实 + 样文/模板 + 文献约束 + 图表截图 + Word 成稿要求”稳定转化为一篇可交付的中文论文。目标不是把论文写厚,而是按样文体量、真实项目能力和版式规则,输出结构完整、字数可控、图表齐全的 .docx 成稿。 已完成样文 / 模板 / 任务书分析,但未开写。 用户已确认目录、字数和样式方案。 首次响应论文请求时,必须主动告诉用户可以直接提供模板、历届样文、开题报告、任务书或封面要求的本地路径,示例格式如: runs entirely locally. Works with Claude Code, Cursor, Cline and 23 more.”.
- **02** When the source has headings, the agent prioritizes “Overview / Hard Gates / Execution States” so the result follows the author’s structure.
- **03** Typical output includes task judgment, concrete steps, required commands or file edits, validation, and follow-up options.
- **04** Risk context follows the fingerprint: read files, run shell commands, write/modify files; mostly runs locally; usually needs no extra API key.
## Running Rules
- read files, run shell commands, write/modify files; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding scope.
- Return the result, validation criteria, and next iteration options. The source does not require a stable slash command. After installation, invoke the skill by name and describe the task.
Name target files or source material, expected output, forbidden changes, and whether network or shell access is allowed. Permission fingerprint: read files, run shell commands, write/modify files.
Start with a small task and check whether the result follows “Overview / Hard Gates / Execution States”. Inspect diffs, logs, previews, or tests before expanding scope.
Confirm the final output includes a concrete result, evidence, and next action. If it stays generic, tighten inputs, boundaries, and acceptance criteria.
---
name: lunwen
description: 这个技能用于把“真实项目事实 + 样文/模板 + 文献约束 + 图表截图 + Word 成稿要求”稳定转化为一篇可交付的中文论文。目标不是把论文写厚,而是按样文体量、真实项目能力和版式规则,输…
category: documentation
source: Doryoku1223/lunwen-skill
---
# lunwen
## When to use
- 这个技能用于把“真实项目事实 + 样文/模板 + 文献约束 + 图表截图 + Word 成稿要求”稳定转化为一篇可交付的中文论文。目标不是把论文写厚,而是按样文体量、真实项目能力和版式规则,输出结构完整、字数可控、图表齐全的 .docx…
- Use it when the task has clear inputs, repeatable steps, and validation criteria.
## What to provide
- Target material, scope, expected result, and forbidden changes.
- Whether network, commands, file writes, or external services are allowed.
## Execution rules
- Organize steps around “Overview / Hard Gates / Execution States” and keep inference separate from source facts.
- read files, run shell commands, write/modify files; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding the task.
## Output requirements
- Return the deliverable, key evidence, validation method, and next action.
- Mark missing information as unknown; do not invent commands, platforms, or dependencies. The author source anchors workflow facts; repository files anchor sources and commands; Fluxly only adds fit, limitations, and quality judgment.
skill "lunwen" {
input -> user goal + target files + boundaries + acceptance criteria
context -> Overview / Hard Gates / Execution States
rules -> SKILL.md triggers / order / output contract
runtime -> no special runtime | read files, run shell commands, write/modify files | mostly runs locally
guardrails -> usually needs no extra API key + small-sample validation + diff/log review
output -> copyable result + checklist + next iteration
} Lunwen
Overview
这个技能用于把“真实项目事实 + 样文/模板 + 文献约束 + 图表截图 + Word 成稿要求”稳定转化为一篇可交付的中文论文。目标不是把论文写厚,而是按样文体量、真实项目能力和版式规则,输出结构完整、字数可控、图表齐全的 .docx 成稿。
Hard Gates
以下规则是硬约束:
- 用户第一次说“为项目生成论文”时,必须先索要辅助资料,至少包括:
- 学校模板
- 往届样文
- 开题报告 / 任务书
- 封面字段要求
- 字数要求
- 在用户明确表示“没有更多资料”或已经给出可分析资料之前,禁止直接生成论文初稿。
- 如果用户给了样文或模板,必须先分析样文与样式,先回传“建议目录 + 目标字数 + 样式摘要 + 冲突项”,等待用户确认后才能开写正文。
- 输出文件名必须使用论文标题,不得使用
smart-lab-thesis、final、draft这类通用名。 - 除主论文
.docx外,必须额外交付一个“附件.docx”,用于收录正文中的 Mermaid / PlantUML 图源码、数据库 E-R 图源码、关键流程图源码等不渲染版本。 - 第 4 章“系统详细设计与实现”必须是全文最长章节;每个一级功能模块默认都要包含:
- 模块说明
- 页面截图
- 简要核心代码或关键实现片段
- 如果正文数据库设计部分缺少 E-R 图,则视为未完成。
- 如果用户给了任务书 / 开题报告 / 学校模板 / 样文,必须先分析这些材料,禁止绕过分析直接生成正文。
- 如果任务书、样文、README、旧说明文档和源码之间出现冲突,默认以“学校模板 > 任务书/开题报告 > 用户明确要求 > 样文 > 项目源码 > README > 旧说明文档”为优先级。
- 旧部署说明、历史项目介绍、演示文档默认视为低可信来源;除非用户明确要求,否则不能作为论文事实主依据。
Execution States
本技能默认按以下状态机执行:
intake_only只收资料,不写正文。sample_analysis_done已完成样文 / 模板 / 任务书分析,但未开写。outline_confirmed用户已确认目录、字数和样式方案。writing_allowed允许开始正文写作。delivery_done已生成主论文、附件和校验产物。
状态约束:
- 未进入
outline_confirmed前,禁止写正文。 - 若用户中途补交新模板、新样文、新任务书,状态必须退回
sample_analysis_done。 - 只有进入
writing_allowed后,才允许生成主论文.md/.docx。
Core Flow
1. 锁定输入
先确认以下输入并确定优先级:
- 学校模板
- 任务书 / 开题报告
- 用户上传的往届样文
- 用户口头要求
- 项目源码
- README
- 旧项目说明文档
- 技能默认规则
首次响应论文请求时,必须主动告诉用户可以直接提供模板、历届样文、开题报告、任务书或封面要求的本地路径,示例格式如:
D:\论文模板.docxD:\论文样文1.docxD:\开题报告.pdf
并且必须明确说明:
- 如果用户还没提供样文、模板或任务书,当前阶段只收集资料和分析,不直接开写初稿。
- 如果用户确认“没有更多资料”,才能按项目源码和默认规则继续。
如果模板、样文和默认规则冲突,必须列出冲突项并让用户选择。样式冲突细则见:
prompts/intake.mdprompts/style_extractor.mdreferences/default-style.md
2. 冻结项目事实
先读项目代码和文档,再提炼固定的项目事实底稿。后续各章只能基于这份底稿扩写。
冻结事实时,必须明确区分:
- 任务书要求
- 源码实际实现
- 论文最终采用口径
如果三者不一致,必须在设计回传阶段提前告诉用户,不得等正文写完后再修正。
事实提取细则见:
prompts/fact_extractor.md
3. 学样文,不只学目录
如果用户提供样文或模板,必须同时分析:
- 结构:目录、页数、字数、图表节奏
- 样式:标题、正文、摘要、关键词、图题表题、参考文献、致谢
- 细节:中英文正文的字体字号、段前段后、行距、首行缩进
- 标题:一级、二级、三级标题的字体字号、加粗、对齐、分页方式
- 表图代码:图题、表题、表格内容、代码块或代码截图的插入位置与样式
对应资源:
prompts/sample_analyzer.mdprompts/style_extractor.mdtools/analyze_sample_pdf.pytools/analyze_docx.py
3.5 先回传设计,再开写
模板和样文分析结束后,必须先把以下内容回传给用户确认:
- 当前论文建议目录
- 各章目标字数
- 正文、标题、摘要、关键词、图题、表题、表格内容等版式样式
- 与默认规则的冲突项
回传时,默认必须结构化为 4 张表:
- 输入资料表
- 建议目录表
- 字数预算表
- 样式与冲突表
必须明确等待用户确认目录和样式;若用户提出新的修改意见,以用户最后确认的版本为准,再进入正文写作。
如果用户后续又补充了新样文、模板或任务书,必须中断正文写作流程,回到本步骤重新分析,不得沿用旧设计继续写。
4. 先定字数,再写作
写正文前必须生成目标章节字数表。默认优先贴近样文体量,不默认写厚。写完一章就统计一次,超出就压缩。
对应资源:
prompts/chapter_writer.mdtools/count_chapter_words.pyreferences/chapter-patterns.md
5. 图表与截图闭环
图表默认要求:
- 系统架构图
- E-R 图
- 关键流程图
- 数据表
- 测试用例表
E-R 图规则:
- 如果数据库总表 E-R 图过大,必须拆分为至少两张:
- 总表设计图
- 核心表设计图
- 若业务复杂,可继续拆成“权限与用户域”“预约与改派域”“设备与报修域”“耗材域”等多张图
- 正文中至少保留“总表设计图 + 核心表设计图”两张 E-R 图
截图默认要求:
- 第 4 章每个主要模块至少 1 张页面截图
- 如果模块跨“管理端 / 用户端”,优先两端都给截图
- 截图标题必须与正文模块对应,不得只放“系统页面图”这类空泛标题
代码默认要求:
- 第 4 章每个主要模块至少给出 1 段简要核心代码、SQL 片段或关键实现片段
- 代码以“解释业务规则”为目的,不堆大段源码
- 大段源码放附录,不直接塞正文
第 3 章设计图最低要求:
- 系统总体架构图
- 功能模块结构图
- 权限控制流程图
- 关键业务流程图
- E-R 图
第 4 章截图最低要求:
- 每个主模块至少 1 张截图
- 主模块跨多角色时,优先补多角色截图
- 截图总数不足 6 张时,默认视为实现章节不充分
如果存在 mermaid / plantuml,优先渲染为真实图片;若无法渲染,再退回源码或占位。
仓库内置 Playwright 截图链路。默认先用本仓库脚本自动抓取系统页面,不再要求用户额外安装浏览器 skill。
如果宿主环境提供 Chrome CDP / Chrome MCP 连接地址,可以作为增强路径复用当前浏览器会话;否则默认由仓库自举 Playwright Chromium。
对应资源:
tools/render_mermaid.pytools/ensure_thesis_assets.pytools/extract_screenshot_placeholders.pytools/build_screenshot_plan.pytools/capture_thesis_screenshots.py
6. 参考文献先建池再回填
默认约束:
- 2020 年及以后
- 中文 10-12 篇
- 英文 3-5 篇
- 总数约 15 篇
必须优先真实可核验文献,不确定就不用。
文献工作流必须分 5 步执行:
- 建候选池
- 做真实性核验
- 做相关性筛选
- 格式化参考文献
- 生成文献核验清单
默认文献质量规则:
- 中文优先使用 CNKI / 万方 / 维普中可核验的北大核心、CSCD 等来源
- 英文优先使用 IEEE、Elsevier、Springer、ACM、MDPI 等可核验 DOI 来源
- 优先近五年文献
- 优先被引较高文献
- 不确定真实性的条目直接丢弃,不写“猜测型引用”
文献交付产物默认至少包括:
- 正文参考文献列表
references-verified.json文献核验清单
文献核验清单默认字段:
- title
- authors
- year
- source
- doi_or_url
- citation_count_if_available
- relevance_note
- status
对应资源:
prompts/reference_selector.mdtools/build_reference_pool.py
7. DOCX 成稿交付
如果环境具备 doc / docx 能力,必须生成 .docx 成稿,而不是只停留在 Markdown。
交付物必须至少包括:
- 主论文
.md - 主论文
.docx - 图像映射文件
- 附件
.docx
文件名规则:
- 主论文文件名必须使用论文标题,如
智慧实验室管理系统的设计与实现.docx - 附件文件名必须使用论文标题加“附件”,如
智慧实验室管理系统的设计与实现-附件.docx - 禁止使用
smart-lab-thesis、paper-final、doc1等通用名
派生文件也应统一命名:
论文标题.md论文标题.docx论文标题-附件.docx论文标题-image-map.json论文标题-文献核验清单.json
附件 .docx 默认内容:
- 正文中的 Mermaid / PlantUML 源码
- 数据库 E-R 图源码
- 关键流程图源码
- 必要时补充核心 SQL / 接口结构说明
默认样式规则:
- 摘要、Abstract、参考文献、致谢标题居中
- 摘要与 Abstract 独立分页
- 一级章节分页开始
- 中文正文宋体
- 英文正文 Times New Roman
- 中文关键词单独成段,顶格,“关键词:”标签使用黑体小四加粗,内容使用宋体小四
- 中英文摘要正文除关键词行外,默认首行缩进 2 字符
- 英文摘要正文使用 Times New Roman 小四
- 英文关键词单独成段,顶格,不首行缩进,使用 Times New Roman 小四
- 参考文献悬挂缩进
对应资源:
prompts/docx_formatter.mdtools/generate_thesis_docx.pytools/analyze_docx.pyreferences/default-style.md
8. 最终检查
交付前必须检查:
- 章节完整
- 字数接近样文目标
- 参考文献比例正确
- 图表编号连续
- 是否残留占位符
.docx是否真实存在- 主论文文件名是否为论文标题
- 附件
.docx是否真实存在 - 第 4 章是否为全文最长章节或接近最长章节
- 第 4 章每个主要模块是否包含截图
- 第 4 章每个主要模块是否包含简要核心代码
- 第 3 章设计图数量是否达标
- E-R 图是否按需要拆分为总表图和核心表图
- 文献是否全部在目标时间范围内
- 是否还混入低可信旧说明文档中的事实
Style Guardrails
正文语言默认遵循以下风格约束:
- 模仿样文的章节推进节奏,不机械模仿原句。
- 优先写项目事实,不先写空泛结论。
- 避免连续堆砌“具有重要意义”“实现了良好效果”“具有较高价值”这类空话。
- 避免过密排比句、模板化总分总和明显 AI 套话。
- 每章至少应有一部分直接对应源码中的真实模块、真实规则或真实数据结构。
- 致谢可适度更自然、更有人情味,但正文不能过度口语化。
最终检查细则见:
prompts/final_checker.md
Resource Map
项目输入与冲突决策:
prompts/intake.md样文结构分析:
prompts/sample_analyzer.md样式提取:
prompts/style_extractor.md项目事实提取:
prompts/fact_extractor.md章节写作与控字:
prompts/chapter_writer.md参考文献筛选:
prompts/reference_selector.mdWord 格式化:
prompts/docx_formatter.md最终检查:
prompts/final_checker.md默认版式:
references/default-style.md章节模式:
references/chapter-patterns.md统计章节字数:
tools/count_chapter_words.py分析样文 PDF:
tools/analyze_sample_pdf.py分析样文 DOCX:
tools/analyze_docx.py检查参考文献池:
tools/build_reference_pool.py生成文献核验清单模板:
tools/write_reference_verification_template.py图表与截图补全检查:
tools/ensure_thesis_assets.py提取截图占位符:
tools/extract_screenshot_placeholders.py生成图源码附件 DOCX:
tools/generate_diagram_appendix_docx.py生成截图计划:
tools/build_screenshot_plan.py自动抓取页面截图:
tools/capture_thesis_screenshots.py渲染 Mermaid:
tools/render_mermaid.py生成 DOCX:
tools/generate_thesis_docx.py
Decide Fit First
Design Intent
How To Use It
Boundaries And Review