明确Jira项目类型与角色权限

首先打开Jira项目设置，进入「项目配置」→「权限方案」，确认当前用户的角色是「开发人员」，而非「产品负责人」或「QA负责人」。不同角色可查看的字段完全不同：例如，开发人员无法看到「商业价值评分」字段，如果在提示词中引用了该字段，Codeium解析上下文时就会直接报错。

接着检查项目所使用的Issue Type Scheme，确认是基础的「Bug/Story/Task」三件套，还是已经扩展出「TechDebt」「Spike」「ReleaseNote」等自定义类型。提示词中必须使用Issue Type的全称——例如“Spike”不能简写为“spike”或“研究”。Codeium对大小写和空格极其敏感，哪怕一个字符错误，也无法正确匹配。

用Codeium插件内嵌Jira上下文

在VS Code中安装好Codeium插件后，右键任意代码文件→选择「Ask Codeium」→在弹出框顶部点击「Attach context」→勾选「Jira issue」→手动输入Jira编号（例如PROJ-1234）或从下拉列表选取。如果跳过这一步，Codeium生成的内容将脱离实际任务背景，变成一堆正确但无用的空话。

这里有两个方法比较实用：

方法一：在提示词开头直接引用Jira字段值
“基于Jira PROJ-1234中‘影响模块’=‘支付网关’、‘优先级’=‘P0’、‘验收标准’第2条要求‘响应时间≤200ms’，生成Python单元测试用例。”

方法二：用Codeium变量语法调取实时字段
“根据当前关联的Jira issue中【customfield_10025】（即‘前端对接人’）填写的姓名，生成对应风格的API文档注释。”

注意：customfield_10025这类ID需要提前在Jira管理员后台核实——每个实例的ID均不同，如果硬编码错误，整个提示词将失效。

注入团队特有术语与禁用词清单

这一步分三步走：

第一步：收集团队高频使用但未被Jira结构化的表达。查阅最近10个已关闭的Story类issue，提炼3～5个反复出现的非标准术语，例如“过账”“灰度切流”“熔断兜底”。这些词汇必须原封不动写进提示词，切勿擅自修改为“记账”“流量切换”“降级策略”——团队习惯用什么就保留什么。

第二步：列出绝对禁用词清单。在提示词末尾添加如下语句：“禁止使用以下词汇：user、util、handler、manager、service——全部替换为团队约定词：操作员、工具箱、调度器、守卫、通道。”

第三步：强制限定输出格式与长度。“生成的Jira评论严格控制在3行以内，每行不超过32个字符，首行动词必须是‘已修复’‘已验证’‘已部署’之一，不得使用‘已完成’。”

通过这一整套组合策略，Codeium生成的提示词才能精准落地执行，避免团队二次修改。