SKILL.md
Jira Status Writeback
Internal shared skill. Single source of truth for post-merge Jira status update + repair comment. Hosts declare it in dependencies, abort if missing, and pass a field map; they MUST NOT restate the two-step API or status boundary inline. This skill does not resolve PAT files; session or MCP auth follows jira-read.
When to run
Only after the PR/MR has successfully merged into the target branch. Never at PR-create time.
SOP
- Transition (no comment on the transition call)
- Call jiragettransitions (or equivalent) and select the developer-owned status equivalent to「已修复」. - Call jiratransitionissue without a comment parameter. - Do not transition to close / verified / QA-owned statuses. - If no matching transition: skip transition, emit a warning, continue to comment if possible.
- Comment (independent call)
- Call jiraaddcomment(issuekey=..., body=...). - The comment text parameter name is body (not comment). - Never rely on jiratransition_issue's comment parameter for the repair record (it may be silently dropped).
- Failure handling
- Transition or comment API failure → warn and record for the host report; do not block or revert an already-completed merge.
Host field map
Hosts MUST supply concrete values for these semantic fields (omit a field only when truly N/A, and say so):
| Field |
Meaning |
| Fix branch |
Source branch name |
| Commit |
Merged tip SHA or primary fix commit |
| PR/MR URL |
Merge request URL |
| Root cause |
Short root-cause summary |
| Fix summary |
What changed |
| Changed files |
Key paths |
| Verification |
Functional / boundary / regression notes (hosts may require ≥2 each) |
| Extra |
Host-specific: analysis report path (jira-fix-workflow), OpenSpec change path (opsx-jira-fix-workflow), QA risks, etc. |
Integration
- Declare
jira-status-writeback in frontmatter dependencies.
- At writeback: load this skill, pass the field map, follow the SOP.
- Keep in the host: when writeback runs in the stage order (after merge; after archive when required), and the field map only.