用途 jira-cr 是一个 AI 智能体技能，用于针对某个 Jira 工单生成 Change Request（CR）摘要，并在用户要求时将其作为评论发布到该工单。它把工单中的验收标准（Acceptance Criteria，AC）与经过核实的 Git 变更范围进行对照，输出面向开发、业务分析和测试人员共同阅读的结构化摘要。该技能可独立安装使用，仓库与 Jira 站点从当前任务上下文中解析。
触发方式 以用户显式调用为主：/jira-cr。适用于“为 PROJ-001 创建 CR”“对某个 Ticket ID 运行 jira-cr”等场景。
主要能力
- 获取 Jira 工单信息：按能力发现站点发现、问题获取、评论列表与评论创建等工具（工具名因智能体而异，需使用已配置的等价工具，而非假定固定命名空间）；解析目标站点与工单键，若多个站点都可能则先询问；拉取工单及已有评论，并翻页检查至找到相关历史摘要或穷尽评论；提取 Summary、Description 和 AC。
- 识别已有 CR 摘要：通过横幅行（首次为“AI-generated CR summary”，更新为“Updated CR summary”）或任意级别的 Story & CR 标题识别历史摘要（评论正文标记格式可能不同，不依赖字面 # 前缀）；若有多条则取最近一条，并记录其评论 ID、发布时间、语言及无法由 diff 重新生成的细节（如截图、分支、提交）。
- 解析并读取变更范围：检查仓库说明、Git 状态、分支与远程；优先遵循用户明确指定的暂存/提交/分支/MR/PR 范围；对不同范围分别读取 git diff --cached、提交补丁及父提交、提交区间全部差异、分支完整差异或 MR/PR 的源/目标引用与完整 diff。未指定范围时根据当前任务、匹配工单的分支及现有 MR/PR 推断；若多个合理范围会产生不同摘要则提出一个聚焦问题。记录仓库、范围模式、基准/头部 SHA、变更文件数；仅为生成摘要不得暂存或提交文件，需排除无关变更与敏感值。
- 分析与对比：把代码变更逐条映射到 AC，状态包括已验证实现、已实现未验证、部分实现、检查范围内未实现、未知；区分“缺少变更”与“周边代码已存在该功能”，保留历史状态并解释变化而非静默替换。识别代码库中受影响区域（配置项、模块、功能、组件），用产品化术语描述，模板中不写文件名与类名。报告实际运行的检查、结果及未运行的检查；仅靠代码阅读不能证明运行时正确性或完整验收。对 API 类改动可描述端点/方法、请求字段、鉴权、处理与源数据解析、重复行为、响应状态与范围，未知契约需明确标注。
- 按模板汇总：保留 Story & CR 标题、AC 汇总表（含截图列）与受影响区域表（配置项/模块/功能/组件），不增加其他章节；表格每行写状态、结果与简短范围，命令与日志在回复中报告而非写入评论。行内按编号描述，不写 AC1/AC2 标签。面向全体读者，从用户视角描述操作与所见界面，避免裸露代码信息；测试状态仅在确实运行或有人报告时使用并说明结果与来源，阅读代码不算测试。截图列在同时存在前后对比图时放置成对图片；功能列可注明需回归测试的相邻界面与未在工单要求内的行为（供 BA/QA 确认）。
- 草稿与发布：首次摘要在顶部加一句说明这是基于已检查变更范围的 AI 生成 CR 摘要；若已有历史摘要，则新评论须引用旧评论（更新横幅、旧评论链接），不新增变更章节而是就地更新表格，并保留仍有效、diff 无法重建的信息，语言默认与旧摘要一致。首次摘要默认使用模板示例语言（泰语，产品与 UI 名称保留英文），除非用户或仓库说明另有要求；图片按情况填写截图、测试输出、API 响应或数据库记录前后对比，待附时写“รอแนบภาพ”并说明待附内容，无需图片写“ไม่มีภาพ”，沿用旧图注明来源评论。若仅要求总结或审查，则以本地草稿结束，除非明确要求发布。发布前确认工单并重读相关历史摘要以防重复或覆盖更新版本；若所选变更在分析后发生变动需先刷新证据与草稿。使用可用的 Jira 评论创建工具发布到已核实工单，格式需先查看工具 schema：ADF 对象仅在工具接受时发送，不可假定 contentFormat: adf 或将 ADF 序列化为字符串（例如当前 Atlassian MCP 评论工具接受 Markdown 或 HTML 字符串而非原始 ADF 对象）；HTML 表格需遵循该工具的 getContentFormatGuide；均不支持时回退 Markdown（单元格单行、用 / 连接、不使用嵌套列表或换行），并告知用户格式损失；若用户明确要求 ADF 而无工具支持，则返回 ADF 草稿而非发布 Markdown。
- 验证结果：发布后取回新评论，校验工单、正文与链接；写入结果不确定时先检查已有评论再重试以防重复；返回评论链接与发布状态，或标注为草稿，并明确说明检查/测试的局限，无证据不宣称发布成功。
适用场景 适用于需要把代码改动与 Jira 验收标准对齐、形成可追踪 CR 记录的开发流程，尤其适合有明确工单、分支或 MR/PR 的团队，以及需要向 BA/QA 说明实现与验证状态的项目。
限制 需依赖可用的 Jira 工具（站点发现、问题获取、评论列表与创建）及 Git 仓库访问；评论格式支持取决于具体工具；仅凭代码检查无法确认运行时正确性；不提供自动测试、部署或工单状态变更功能；具体站点、仓库与权限配置需由实际环境提供，资料未提供更多细节。