ARTICLE · 1152084
我做了一个 AI 使用说明自动生成 Skill
“它可以从当前可见的真实 AI 对话,或用户提供的聊天导出文件中,按时间顺序整理出可核查的 AI 使用记录,并自动生成格式统一的 DOCX 使用说明。”
1
为什么会做这个Skill
现在越来越多课程作业、论文、科研项目和竞赛开始要求说明“是否使用了 AI、具体怎么使用、提示词是什么、AI 给了什么结果、最终如何采用”。真正开始整理时,会发现这件事比想象中麻烦。
如果一段任务里和 AI 来回交流了很多轮,手工去翻聊天记录、复制提示词、概括回答,再把内容整理到统一格式的 Word 表格里,既耗时间,也很容易漏掉关键记录。更麻烦的是,一旦为了“让表格完整”而补写并不存在的提示词或结果,AI 使用说明就失去了它原本应该具备的可核查性。
所以我做了这个 Skill:ai-use-statement-docx。它不负责替你“编一个看起来完整的 AI 使用过程”,而是尽可能把真实可见的对话整理清楚,再交给脚本稳定地生成 Word。
2
它到底能做什么?
这个项目目前定位很明确:把 AI 对话整理成规范的《AI使用说明》Word 文档。默认情况下,每一轮“用户输入 + AI 对应回复”会被整理为一条独立记录,并按真实对话顺序连续输出。
· 从当前可见的历史对话中提炼 AI 使用记录;
· 读取用户提供的 .txt、.md 或 .json 聊天导出;
· 为每条记录整理“询问目的、AI名称、提示词、AI回答、使用结果评价”;
· 按统一版式自动生成 A4 Word 文档;
· 自动进行结构校验,减少漏项和格式错误;
· 支持课程作业、论文、项目、竞赛等需要提交 AI 使用披露材料的场景。
最终生成的文档不是一段泛泛而谈的“我使用了 AI”,而是一组可以逐条追溯到真实对话的记录。对需要提交过程性材料的人来说,这比最后临时回忆“我当时到底问了什么”要可靠得多。
3
不编造缺失的AI使用记录
这个 Skill 在设计时专门加入了真实性边界。它优先使用当前任务里真正可见的用户消息和 AI 回复;如果较早的对话已经不可见、聊天记录被截断,或者导出文件本身不完整,它会继续处理能够确认的部分,但不会自动补写不存在的提示词、回答或评价。
同样地,如果对话里没有明确的“使用结果评价”,默认不会替用户写成“效果良好”“结果准确”之类的结论,而是提示需要人工确认。这样做看起来没有那么“自动”,但更符合 AI 使用说明本身的用途:它应该记录事实,而不是制造一份漂亮但无法核查的材料。
我给它设定了三个基本原则:
·真实:只整理真实可见或用户提供的对话,不凭空补写。
·可核查:提示词尽量保留原文,AI 回答忠实概括核心结论和成果。
·可交付:内容整理完成后,统一生成规范 DOCX,并进行结构校验。
4
生成的报告长啥样?
当前版本会自动生成统一的 A4 文档:标题居中加粗,每条记录使用单列表格展示,并在同一个“AI使用说明”标题下连续排列,由 Word 自然分页。
· 页面:A4;
· 标题:居中、加粗、16 磅;
· 正文表格:每条记录固定 5 项内容;
· 中文字体:宋体;
· 英文与数字:Times New Roman;
· 表格:浅蓝交替底色;
· 页脚:居中页码。
换句话说,Agent 负责“读懂对话并整理内容”,Python 脚本负责“确定性地生成版式”。把内容理解和文档排版拆开后,生成结果会稳定很多,也更容易做校验。
5
如何使用?
最简单的用法,就是在已经完成一段 AI 对话后,直接调用 Skill,让它根据当前可见聊天记录生成使用说明。
https://github.com/Yygz314/ai-use-statement-docx.git 利用这个skill,请根据当前对话生成 AI 使用说明,保存到当前项目
在真正整理前,Skill 会先确认本次说明里要填写的 AI 产品、版本或模型名称。之后,它会按对话时间顺序逐轮整理,最终交给生成脚本输出 DOCX。
当然,你也可以事先让你的智能体安装这个skill,后续在使用的时候就不需要反复输入相同指令啦。
6
适合哪些场景?
我觉得它最适合“AI 已经参与了实际工作,但最后还需要把使用过程正式说明清楚”的场景。
· 课程作业:需要附 AI 使用说明或生成式 AI 使用记录;
· 毕业论文 / 科研论文:需要说明 AI 辅助写作、检索、编程或分析过程;
· 创新创业 / 学科竞赛:需要提交 AI 工具使用说明、过程材料或合规披露;
· 项目开发:希望把和 AI 的关键交互整理成可追溯文档;
· 教师或团队统一要求:希望大家提交结构一致的 AI 使用记录。
它并不是为了判断“是否允许使用 AI”,也不会替学校、期刊或竞赛制定规则。它解决的是另一个更具体的问题:当你需要披露时,如何把已经发生的 AI 使用过程整理得更快、更规范、更可信。
7
为什么做成skill而不是普通脚本?
单纯的 Word 生成脚本只擅长排版,但很难理解上下文;单纯让大模型输出一份说明,又容易出现格式漂移、漏项或凭经验补全。把两者结合成 Skill 后,可以让 Agent 负责判断“哪些内容属于一条真实记录、回答应该如何概括、哪里存在信息缺口”,再让脚本负责稳定生成文档。
这种组合也让后续扩展更方便。例如,可以继续增加学校模板适配、期刊格式、竞赛专用表单、聊天导出解析、更多字段校验等功能,而不需要把所有逻辑都塞进一个超长提示词里。
8
开源地址
项目已经开源在 GitHub,采用 MIT License。欢迎直接使用,也欢迎根据自己的学校、课程或项目要求继续改。
GitHub:https://github.com/Yygz314/ai-use-statement-docx
如果这个项目刚好解决了你的需求,也欢迎点一个 Star。
仓库也可点击最下方阅读原文进入。
9
写在最后
AI 越来越深入地参与学习、科研和项目开发之后,“如何使用 AI”本身也开始成为需要被记录的一部分。与其到提交材料前再临时翻聊天记录,不如把这件事交给一个专门的工具:能自动整理的交给 Skill,不能确认的部分明确留给人工判断。
这个项目现在还很小,但我希望它至少能把一件重复、琐碎、又容易出错的事情做得更简单一些。后续如果有新的使用场景,我也会继续完善。