copilot生成错误代码是因为提示词未锚定真实上下文；需用结构化指令明确函数签名、约束条件、示例、上下文锚点、分层提示及团队规范。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在VS Code里敲下注释“处理用户数据”，Copilot却生成一段与你项目中User模型字段完全不匹配的代码，说明提示词没把真实上下文锚定住——这不是AI理解力问题，而是你没给它可依赖的结构化指令。
明确任务边界与I/O规范
第一步：在光标上方单独一行写明函数签名，含参数名、类型和返回值类型，例如：// def validate_user_profile(data: dict, required_fields: list[str]) -> tuple[bool, str]。
第二步：用自然语言补全约束条件，必须包含输入校验规则和输出行为定义，比如“若data缺失required_fields中任一字段，返回(False, 'missing field: email')；否则返回(True, 'valid')”。
第三步：在下方空行插入一个最小可行示例，格式为“输入→输出”，例如：// 输入: {"name": "Alice"}, ["name", "email"] → 输出: (False, 'missing field: email')。这一步不能省略，【Copilot对箭头式样例的响应优先级远高于纯文字描述】。
嵌入上下文锚点
在注释开头列出当前文件已导入的核心模块和版本号，例如：// 使用pydantic v2.6.3、fastapi 0.115.0，不引入sqlalchemy。
复述相邻函数的关键签名或类属性，比如你正在写的函数调用了user_repo.get_by_id()，就写一句：// user_repo.get_by_id(id: int) → User | None，User含id: int、role: Literal["admin","user"]。
指出当前代码块所在路径及职责，例如：// 本段位于/src/api/v2/auth.py，负责JWT令牌签发前的二次身份核验。这能让Copilot自动过滤掉无关的OAuth2通用逻辑。
专为资深工程师设计，用于高效日常使用 GitHub Copilot CLI。适用于在规划、提示、审查或链式调用 gh copilot 命令时，探索代码库、起草变更、调试问题或加速工作流，且不偏离架构意图。
提供结构化示例
方法一：直接粘贴一段已验证通过的真实输出片段，并用中文括号标注字段含义。
例如：// 期望返回JSON对象: {"code": 200, "data": {"user_id": 123, "permissions": ["read:order"]}, "trace_id": "abc123"} // 其中"code"为HTTP状态码(int)，"data"必须含"user_id"(int)和"permissions"(list[str])。
方法二：对多步骤处理任务，用→串联流程节点，不加任何连接词。
例如：// 原始请求头 → 提取X-Request-ID → 校验是否为UUID格式 → 若非法则返回400错误响应。这比写“请按顺序完成以下三步”更有效。
分层递进式提示
先让Copilot生成函数骨架，只写签名和文档字符串，不写实现体。
待该代码块生成并确认无误后，在其下方新起一行写：“// 在上述函数内，添加逻辑：从data字典中提取email字段，用正则^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$校验格式”。
最后再追加一句：“// 若校验失败，抛出ValidationError('invalid email format')，异常类已在models/errors.py中定义”。【跳过中间确认直接写满三层逻辑，Copilot大概率遗漏第二步的正则细节】。
启用自定义指令固化团队规范
在项目根目录创建.copilot/prompt_rules.md，写入三条不可协商的规则：
• 所有API路由函数必须以async def声明，返回JSONResponse
• 日志统一使用logger.info()，禁止console.log或print()
• 每个导出函数顶部必须含完整JSDoc，含@param、@returns、@throws
在每次编写新函数前，在注释中引用该契约：// 遵循.copilot/prompt_rules.md全部三条规则。VS Code插件会自动读取该文件内容注入上下文。
