☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
用Microsoft Copilot把旧代码自动整理成说明文档时，反复修改提示词导致效率低下，根本原因是初始提示词没锁定核心信息结构和输出边界。
明确文档用途再写提示词
先问自己：这份文档给谁看？是给新同事快速上手，还是给测试人员核对逻辑，或是给产品经理理解功能边界？不同读者决定你提示词里要强调什么。比如给运维看，就要突出异常路径和依赖服务；给前端看，就得写清API入参格式和状态码含义。
这一步跳过直接写提示词，Copilot大概率生成泛泛而谈的“该模块负责处理用户请求”这类废话，后续只能靠人工一句句删改。
用三段式模板固定提示词骨架
方法一：角色+任务+约束
请以资深后端开发工程师身份，将以下Python函数转换为技术说明文档。要求：①开头用一句话概括函数核心职责；②参数列表必须标注类型、是否必填、示例值；③用「正常流程」「异常分支」两个小标题分述执行逻辑；④禁止出现“可能”“通常”等模糊表述；⑤输出纯Markdown，不加解释性文字。
方法二：输入-输出对照表驱动
Microsoft Copilot是微软推出的AI助手，整合于Windows、Edge、GitHub及Microsoft 365等产品中。它内置于Word、Excel、PowerPoint、Outlook和Teams等应用，通过大型语言模型与Microsoft Graph中的组织数据（如文件、邮件）相结合，提供文档起草、数据分析、会议总结等上下文感知的智能协助，旨在提升工作效率与创造力。
请严格按以下格式解析代码：【输入】列出所有入参名+类型+业务含义；【处理】用带编号的步骤描述主干逻辑（每步不超过15字）；【输出】说明返回值结构+各字段含义+典型错误码。不要补充任何代码外的信息。
【Copilot对模糊指令容忍度极低，没写“禁止出现‘可能’”这类硬约束，它就会默认加入推测性描述】
精准喂代码前做两件事
第一步：删掉无关注释和调试print语句。Copilot会把“# TODO: 优化缓存”当成待办事项写进文档，把“print(‘debug’, x)”误判为关键日志行为。
第二步：把函数签名单独提出来，放在代码块最上方。例如：def calculate_discount(user_id: str, order_amount: float, coupon_code: Optional[str] = None) -> Dict[str, Any]:。Copilot优先抓取第一行，签名缺失会导致参数类型全错。
第三步：如果函数调用了内部工具函数，且那些函数没有源码，就在提示词末尾追加一句：“若遇到未提供实现的函数调用，请标注‘[需查阅XXX模块]’并停止展开。”
