给软件工程师的 Brisk 上手指南:步骤、提示词与注意事项
教师用的浏览器扩展,可在 Google Docs 中生成反馈与教学材料——这是 Brisk Teaching 最主要的用途,也是本文讨论的前提。
这篇写给软件工程师:围绕代码阅读与重构、测试与排错和技术文档这几类日常工作,说明它能帮上什么忙、怎么用、哪些地方必须自己把关。
软件工程师的三个高频用法
1. 代码阅读与重构
在 Brisk Teaching 中可以这样提:
先不要改代码。阅读这个模块,画出主要函数的调用关系,指出可以安全重构的部分和风险点,再给出分步重构计划。
把关:先计划后改动。
2. 测试与排错
在 Brisk Teaching 中可以这样提:
这是失败的测试输出和相关代码,请定位原因,给出最小修复,并补一个能防止回归的测试用例。
把关:修复后测试通过。
3. 技术文档
可直接复制到 Brisk 里修改:
根据这段代码和注释生成接口文档:参数、返回值、错误码、调用示例,示例必须能直接运行。
把关:示例代码可运行。
也可以试试:口语陪练
这是「教育与学习」类工具的通用任务,软件工程师同样用得上。
我们来做角色扮演:你是咖啡店店员,我是顾客。请用简单英语和我对话,每次只说一两句;对话结束后指出我的 3 个表达问题并给出更自然的说法。
边界与合规
不要把密钥和未开源代码上传到未授权工具,合并前审阅每处改动。
- 产出由软件工程师本人负责,AI 只是草稿和辅助。
- 对外内容发布前至少看一遍。
- 如单位有规定的工具清单,优先在清单内选择;Brisk Teaching 的同类还有 MagicSchool、Diffit。
一周试用建议
选一个最常做的任务连续用 5 个工作日,记录每次节省的时间和需要修改的地方,再决定是否把 Brisk 纳入日常流程。
补充练习
错题分析
准备材料:一道做错的题和我的解答过程。
不要直接给答案。先指出我的解题过程从哪一步开始出错,再给一个提示让我自己重做;如果我第二次还错,再给出完整解析。
检查点:先给提示再给答案。
单元教案
准备材料:课程标准和教材章节。
为【年级/学科】的【单元】设计一份 2 课时教案:学习目标、导入活动、核心活动、课堂检测和作业,注明每个环节时长。
交付前确认:环节时长加起来等于课时。
分层阅读材料
输入:一篇课文或阅读材料。
把这篇材料改写为三个难度版本(基础 / 标准 / 拓展),保留核心知识点,每个版本配 3 道理解题。
验收标准:三个版本知识点一致。
常见问题:生成的题目有错
教师抽查答案,尤其是计算题与史实题。
常见问题:难度不适合
写清学生年级与已学内容,并给一个难度示例。
常见问题:学生直接让 AI 给答案
使用引导式模式,或在提示中要求「只给提示不给答案」
概念补充:评分量规(Rubric)
按维度和等级描述作业质量的评价工具。
概念补充:差异化教学
为不同水平学生提供不同难度的材料与任务。
注意事项
所有示例输出均为示意,不代表真实统计或效果承诺;请以自己的测试结果为准。
涉及个人信息、商业机密或受监管数据时,先确认 Brisk Teaching 的数据处理条款,再决定能否使用。