必须先完成jira cloud与workbuddy的oauth 2.0双向认证并启用jira cloud connector，再映射自定义状态至标准进度值，否则任务聚合、sprint回顾等skill无法加载真实数据或输出错误百分比。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让WorkBuddy自动读取Jira中的任务状态、Sprint数据和阻塞日志来生成日报或回顾报告，必须先完成Jira与WorkBuddy之间的双向身份认证和数据通道建立，否则所有依赖Jira源的Skill（如“任务进度聚合v2.3”“Sprint回顾模板”）将无法加载真实字段。
确认Jira实例类型并启用对应连接器
WorkBuddy仅支持Jira Cloud（非Server/Data Center），且必须使用OAuth 2.0协议授权，不接受Basic Auth或API Token直连。
登录WorkBuddy网页端→点击左下角「设置」→进入【集成中心】→【应用连接】→查找“Jira Cloud Connector”条目。
若该条目显示“未安装”，点击右侧「安装」；若已安装但状态为“已禁用”，点击「启用」并等待绿色对勾出现。
【必须确保当前WorkBuddy工作区管理员拥有Jira Cloud租户的Admin权限，否则OAuth授权流程会在第二步中断】
完成OAuth 2.0授权绑定
点击已启用的“Jira Cloud Connector”右侧「配置」按钮。
系统弹出Jira登录页，输入你用于管理Jira项目的**企业统一身份账号**（非个人邮箱别名，例如：zhangwei@tencent.com，而非zhangw@xxx.com）。
在Jira权限确认页中，勾选全部6项权限范围（含“Read Jira issues”“Read Jira sprints”“Read Jira worklogs”），点击“Allow”。
返回WorkBuddy后，页面自动显示“已连接至https://your-company.atlassian.net”，且右上角同步出现Jira图标。
验证数据拉取是否生效
方法一：通过技能触发校验
启用「任务进度聚合 v2.3」Skill → 点击「测试数据源」→ 选择任意一个已同步至Jira Cloud的项目Key（如PROJ-123）→ 点击「立即拉取」。
腾讯云代码助手CodeBuddy旗下WorkBuddy 4.24.8版本正式发布。本版本重点修复了上下文压缩异常、冷加载时偶现历史消息丢失、任务停止卡死等问题，并深度优化了Windows沙箱(lightSandbox)的日志写入与误弹窗逻辑，提供更安全稳定的AI协作体验。
若返回结果含完整任务列表（含Status、Assignee、Due Date字段），说明连接成功；若提示“401 Unauthorized”或空数组，请重新执行OAuth授权步骤。
方法二：通过自然语言指令即时验证
在WorkBuddy主对话框输入：“列出我负责的、截止日期在本周内的Jira任务，只显示Summary和Story ID”。
若返回3条及以上带真实Jira Issue Key（如PROJ-456）的结果，则证明WorkBuddy已具备实时读取能力。
方法三：检查动态中心底层事件流
进入「团队动态」页面 → 点击右上角筛选器 → 选择「数据源：Jira」→ 观察最近24小时是否有“任务状态更新”“Sprint开始”等事件卡片生成。
映射Jira字段到WorkBuddy标准语义
第一步：打开「技能市场」→ 搜索“Jira字段映射器”→ 安装并启用该辅助Skill。
第二步：运行该Skill → 系统自动拉取你所连接Jira实例中全部项目的状态机配置。
第三步：在映射界面中，将Jira自定义状态（如“代码评审中”“UAT待验收”）手动关联至WorkBuddy进度标准值：
→ “待开始” → 0%
→ “进行中” → 30%
→ “已评审” → 70%
→ “已完成” → 100%
【跳过此步会导致所有进度聚合类Skill输出的百分比始终为0%或100%，因为WorkBuddy无法识别Jira私有状态名】
第四步：点击「保存映射规则」→ 等待右下角提示“字段映射已全局生效”。
