给软件工程师的 Diffit 上手指南:步骤、提示词与注意事项
Diffit 是一款在线服务:把阅读材料改写成不同难度版本的教师工具。
这篇写给软件工程师:围绕代码阅读与重构、测试与排错和技术文档这几类日常工作,说明它能帮上什么忙、怎么用、哪些地方必须自己把关。
软件工程师的三个高频用法
1. 代码阅读与重构
提示词示例:
先不要改代码。阅读这个模块,画出主要函数的调用关系,指出可以安全重构的部分和风险点,再给出分步重构计划。
把关:先计划后改动。
2. 测试与排错
在 Diffit 中可以这样提:
这是失败的测试输出和相关代码,请定位原因,给出最小修复,并补一个能防止回归的测试用例。
把关:修复后测试通过。
3. 技术文档
可直接复制到 Diffit 里修改:
根据这段代码和注释生成接口文档:参数、返回值、错误码、调用示例,示例必须能直接运行。
把关:示例代码可运行。
也可以试试:闪卡制作
这是「教育与学习」类工具的通用任务,软件工程师同样用得上。
把这一章的知识点做成 20 张问答式闪卡,每张只考一个知识点,问题避免能被直接猜出答案。
边界与合规
不要把密钥和未开源代码上传到未授权工具,合并前审阅每处改动。
- 产出由软件工程师本人负责,AI 只是草稿和辅助。
- 对外内容发布前至少看一遍。
- 如单位有规定的工具清单,优先在清单内选择;Diffit 的同类还有 MagicSchool、Brisk。
一周试用建议
选一个最常做的任务连续用 5 个工作日,记录每次节省的时间和需要修改的地方,再决定是否把 Diffit 纳入日常流程。
更多可以试的用法
评分量规
输入:一项作文或项目作业要求。
为这项作业设计评分量规:4 个维度、每个维度 4 个等级,每个等级写出可观察的描述,方便学生自评。
验收标准:等级描述可观察。
错题分析
准备材料:一道做错的题和我的解答过程。
不要直接给答案。先指出我的解题过程从哪一步开始出错,再给一个提示让我自己重做;如果我第二次还错,再给出完整解析。
检查点:先给提示再给答案。
单元教案
适用情况:手头有课程标准和教材章节时。
为【年级/学科】的【单元】设计一份 2 课时教案:学习目标、导入活动、核心活动、课堂检测和作业,注明每个环节时长。
检查点:环节时长加起来等于课时。
常见问题:生成的题目有错
教师抽查答案,尤其是计算题与史实题。
常见问题:口语练习太难开口
让 AI 放慢语速、只用简单词汇,先从固定句型开始。
常见问题:学生直接让 AI 给答案
使用引导式模式,或在提示中要求「只给提示不给答案」
概念补充:苏格拉底式提问
通过追问引导学习者自己得出答案。
概念补充:差异化教学
为不同水平学生提供不同难度的材料与任务。
适合人群:研究生
研究生可以用 Diffit 处理文献阅读、开题与论文写作等工作。需要注意:遵守学校学术诚信规定,AI 只用于辅助理解和润色。
使用提醒
所有示例输出均为示意,不代表真实统计或效果承诺;请以自己的测试结果为准。
文中提示词和示例仅作示意,实际效果取决于你的材料和 Diffit 当前版本,重要内容请人工核对后再使用。