用途：这是内部共享技能，作为合并后 Jira 状态更新与修复评论的唯一事实来源。宿主需在 dependencies 中声明它，缺失则中止，并传入字段映射；宿主不得内联重述两步 API 或状态边界。本技能不解析 PAT 文件，会话或 MCP 认证沿用 jira-read。
前置检查：必须可用 jira-wiki-markup；缺失则中止并打印标准安装提示 npx skills add FuDesign2008/open-skills -g --skill '*' --yes。
运行时机：仅在 PR/MR 成功合并进目标分支之后，绝不在创建 PR 时运行。
流程一，流转：调用 jira_get_transitions（或等价工具）选择开发者自有、等价于「已修复」的状态；调用 jira_transition_issue 且不带 comment 参数；不得流转到关闭、已验证或 QA 自有状态；若无匹配流转，跳过并告警，尽量继续评论。
流程二，评论：加载 jira-wiki-markup，按宿主字段映射和该技能的规范修复评论骨架（Wiki 标记）组装 body；若某行以 h1. 或 h2. 开头，改写为编号 # name 项，使评论保持在 h3./h4. 加列表层级；用可用评论工具把文本放在 body 字段发布，绝不依赖 jira_transition_issue 的 comment 参数记录修复（可能被静默丢弃）。
保真校验：完成前回读存储的 body 并与组装文本比对，行首标题（h3./h4.）、bold、{{mono}}、[label|url] 必须原样保留；仅 2xx 不算成功，中间层可能转义标记或改写标题仍返回 2xx。保真失败时用捆绑的 REST 回退脚本 scripts/update-comment-wiki.mjs 重写评论（凭据链同 jira-read；创建时不传 comment id，更新时传 id；脚本自行复验保真），并依据其 PASS 输出报告。
失败处理：流转或评论 API 失败则告警并记入宿主报告，不阻塞或回滚已完成的合并。
宿主字段映射：宿主必须提供以下语义字段的具体值（确实不适用才可省略并说明）：Fix branch 源分支名、Commit 合并后 tip SHA 或主修复提交、PR/MR URL、Root cause 根因简述、Fix summary 变更内容、Changed files 关键路径、Verification 功能/边界/回归说明（宿主可要求各≥2）、Extra 宿主特定项（如 jira-fix-workflow 的分析报告路径、opsx-jira-fix-workflow 的 OpenSpec 变更路径、QA 风险等）。
集成：在 frontmatter dependencies 中声明 jira-status-writeback；回写时加载本技能、传入字段映射并遵循 SOP；宿主保留回写在阶段顺序中的位置（合并后，必要时归档后）以及字段映射本身。