提示之前和提示之后：软件教程创建中的人机协作支架

使用 LLM，创建软件教程现在涉及引导模型的输出并将其塑造成连贯、准确的学习资源，但现有的 LLM 工具为编写者提供的这项工作几乎没有支持。通过分析对技术作家 ($N=17$) 的采访，我们确定了他们如何组装和构建多个 LLM 响应、管理模型使用的上下文以及验证生成的内容的三个要求。我们设计了一个名为 dBlocks 的工具，具有以下功能：用于范围内容的块、用于编辑上下文的上下文管理器以及用于验证代码的内联执行。遵循以人为本的设计方法，我们通过用户研究迭代完善设计（$N=5$）。在一项受试者内部实验室研究 ($N=16$) 中，将 dBlock 与参与者首选的 LLM 辅助创作工作流程进行比较，参与者表示对使用 dBlock 制作的教程的信心显着提高。此外，该工具减少了验证过程中的摩擦，编写者在起草时验证代码，而不是推迟或跳过它，并通过将工作范围划分为将每个教程部分及其 LLM 对话放在一起的块，帮助他们避免搜索长聊天历史记录。更广泛地说，我们的工作为在 SE 工作流程中构建人机协作的工具提供了启示，并展示了以人为本的设计如何指导 LLM 集成工具的开发。