菜单
科研项目技术总结笔记生成器（所有专业通用）。当用户说"写总结笔记"、"技术总结"、"科研总结"、"项目复现笔记"、"整理项目文档"、"写个总结"、"项目做完了写笔记"、"毕设总结"、"课程设计总结"、"实验总结"、"课题总结"时使用。适用于机械/土木/电气/化学/生物/材料/计算机/经管/社科等任何需要按导师要求产出可复现技术文档的专业。Skill 会通过主动提问引导用户完成 4 项交付物：技术总结笔记、过程记录文档、录屏、项目文件压缩包，并以"他人可按文档复现"为唯一验收标准反复迭代。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | research-summary |
| description | 科研项目技术总结笔记生成器（所有专业通用）。当用户说"写总结笔记"、"技术总结"、"科研总结"、"项目复现笔记"、"整理项目文档"、"写个总结"、"项目做完了写笔记"、"毕设总结"、"课程设计总结"、"实验总结"、"课题总结"时使用。适用于机械/土木/电气/化学/生物/材料/计算机/经管/社科等任何需要按导师要求产出可复现技术文档的专业。Skill 会通过主动提问引导用户完成 4 项交付物：技术总结笔记、过程记录文档、录屏、项目文件压缩包，并以"他人可按文档复现"为唯一验收标准反复迭代。 |
不要用于：日常聊天总结、读书笔记、非技术类文字汇总、纯个人感想整理。本 Skill 仅适用于科研/工程类项目的技术文档产出。
帮你在科研任务（软件、编程、仿真、实验等）完成后，按导师要求产出可复现的完整技术文档包。
验收的唯一标准：一个刚接触该方向的同学，不跟你交流，只靠文档、源码、参考链接，就能完整复现你的项目。
如果做不到，就继续改文档，直到能做到为止。
每次完整产出包含 4 件东西：
| # | 交付物 | 说明 |
|---|---|---|
| 1 | 技术总结笔记 (.md 或 .docx) | 软件环境及版本、代码开发步骤、编程调试流程、参考链接 |
| 2 | 过程记录文档 (.md) | 逐条列出学习和编写过程中遇到的问题和解决方案 |
| 3 | 运行调试录屏 (.mp4，可选) | 完整的运行/调试过程录像 |
| 4 | 关键代码源文件压缩包 (.zip) | 命名规范、关键处有详细注释、代码开头注明可靠性测试内容 |
分 6 个阶段，按顺序推进。每个阶段结束时确认用户满意后再进入下一阶段。
先通过提问搞清楚项目的全貌。不要跳过，不要假设。
必须问到的问题（逐一问，不要一次抛太多）：
将用户回答整理成项目概况，让用户确认无误后再进入阶段 1。
根据阶段 0 收集的信息 + 阅读项目代码，产出技术总结笔记。
重要：使用 templates/技术总结笔记模板.docx 作为 Word 模板生成最终文档。该模板已预设好字体（Arial）、标题样式（H1 18pt 黑 #1A1A1A / H2 15pt 黑 #2B579A / H3 13pt 黑 #333333）、表格样式（#2B579A 蓝底白字表头）、页眉页脚和封面格式。用 docx skill 按此模板填入内容，确保所有产出的 Word 文档风格统一。章节结构同时参考 templates/技术总结笔记模板.md。
笔记必须包含的章节：
## 1. 项目概述
- 项目名称、目的、一句话描述
## 2. 软件环境与版本
- 操作系统及版本
- 所有依赖软件/库的精确版本（用表格列出）
- 环境配置步骤（每一步写清楚，包括命令）
## 3. 项目结构说明
- 目录树 + 每个文件/文件夹的作用
## 4. 代码开发步骤
- 按开发顺序，每一步做了什么、为什么这样做
- 关键代码段的解释
## 5. 编程调试流程
- 从零开始搭建环境 → 运行代码 → 看到结果的全流程
- 每一步的命令/操作 + 预期输出（截图位置标记）
- 常见报错与处理方法
## 6. 运行说明
- 如何启动项目（新人按步骤操作即可跑通）
- 预期运行结果描述
## 7. 参考链接
- 所有参考过的教程、文档、博客、论文链接
- 每个链接旁边注明它解决了什么问题
撰写要求：
产出后让用户审阅，特别问："如果你是一个完全没接触过这个项目的同学，只看这份文档能复现吗？有哪里不清楚？" 根据反馈修改，直到用户可以确认没有遗漏。
这一步和阶段 1 独立，但内容上互补。过程记录重点不是"怎么做"，而是"踩过什么坑"。
使用 templates/过程记录模板.md 的格式逐条填写：
文档格式：
## 问题与解决方案记录
### 问题 1：[简述问题]
- **现象**：发生了什么事
- **原因**：根因是什么
- **解决过程**：怎么排查的、试过哪些方法、最终怎么解决的
- **参考来源**：查了哪些资料、问了谁
- **经验教训**：下次怎么避免
### 问题 2：...
要求：至少 3 条，如果用户说"没什么问题"，提醒他回想一下——编译报错、环境配置问题、库版本不兼容、教程步骤过时等都属于问题。
先问用户：「你的项目需要录屏吗？如果需要，我帮你列一份录屏清单。如果不需要（比如纯代码项目用截图+README 就能说明问题），我们可以跳过这个交付物。」
如果用户选择需要录屏，继续以下步骤；如果不需要，标注交付物 3 为「跳过」，直接进入阶段 4。
录屏内容清单：
录屏要求：
输出录屏指导后，告诉用户："录好后把文件路径给我，我帮你检查内容是否覆盖了所有关键步骤。"
在打包之前，检查代码质量。
检查项：
## 可靠性测试记录
# 1. 连续运行 30 分钟无报错
# 2. 测试了 X/Y/Z 三种输入情况，输出均符合预期
# 3. 反复启停 20 次无异常
# 4. 测试了边界情况：空输入、超长输入、特殊字符输入
检查完毕后，先尝试用 scripts/pack.py 自动打包：python scripts/pack.py "项目目录" "项目名-技术文档.zip"（会自动排除 .git、缓存文件等）。如果项目没有 Python 环境，则手动指导用户用 Compress-Archive 打包。
Compress-Archive -Path "项目目录" -DestinationPath "项目名-技术文档-日期.zip"
或手动指导用户打包。
这是最后也最重要的环节。你作为"新手"角色，按照技术总结笔记一步步走一遍，验证是否真的可以复现。
检查方法：
不可复现 = 不合格。指出具体哪里卡住了，回到对应阶段修改，直到通过验证。
所有内容确认无误后，输出最终清单：
## 交付清单
| # | 交付物 | 文件 | 状态 |
|---|--------|------|------|
| 1 | 技术总结笔记 | xxx.md | ✅ |
| 2 | 过程记录文档 | xxx.md | ✅ |
| 3 | 运行调试录屏 | xxx.mp4 | ✅ / ⏭️跳过 |
| 4 | 代码源文件压缩包 | xxx.zip | ✅ |
项目名称：XXX
完成日期：YYYY-MM-DD
提醒用户将所有文件发给导师审阅。