如果你是软件工程师，大概率经历过这样的场景：需求变化快、代码要可维护，而接口文档又必须按时交付。用 AI 辅助，目标不是“让 AI 替你做完”，而是让你更快拿到一个可修改的接口文档。

什么时候适合用 AI

  • 适合：接口代码比较多、需要快速形成接口文档初稿，或者需要换个角度查漏补缺的时候。
  • 谨慎：材料涉及未公开或敏感信息、结论需要专业资质背书，或者容易出现“文档与实现不同步”的情况。
  • 不适合：需要现场判断、当面沟通或承担最终责任的环节——这些仍由软件工程师本人完成。
  • 预期：AI 负责“快”和“全”，你负责“准”和“对”。把节省下来的时间用在复核和沟通上，整体质量才会提升。

使用前

  • 明确这份接口文档的读者和用途
  • 准备好接口代码并脱敏
  • 确认所用工具符合单位规定

使用后

  • 输入的接口代码已脱敏，不含不该外传的信息
  • 已告诉 AI 这份接口文档的读者和用途
  • 输出中的数字、日期、名称都已回到原始材料核对
  • 已专门检查：文档与实现不同步
  • 标注为【待确认】的内容都已补齐或删除
  • 语气和格式符合单位或行业惯例
  • 涉及专业判断、承诺或责任的内容，由本人或有资质的人确认
  • 好用的提示词和最终版本已存档

配套提示词

下面是一份接口文档的草稿。请你站在挑剔的审阅者角度：
1. 找出事实可能有误、缺少依据或前后矛盾的地方；
2. 检查是否存在这个风险：文档与实现不同步；
3. 指出读者可能看不懂的表述；
4. 给出修改建议，但不要直接改写全文。
草稿：【粘贴】

相关文章

注：模板与提示词仅作演示，请按实际情况调整；涉及法律、财务、医疗等专业判断时，以有资质的专业人士意见为准。