Menu
JIRA 读写：Issue 查询、Confluence 链接解析、Story 创建、流转、排期、描述回写、钉钉。平台 skill，与 Confluence 解耦。
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/it235/multica-best-practices --skill multica-platform-jiraThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
CI/CD 产物编排：G2 PASS 且代码已 push 后调用 multica-platform-jenkins 触发 dev/sit 构建，回写 JIRA 并回传部署 URL。Python 实现，Windows / Linux 通用。
把技术设计文档落地到 Confluence（默认父页面 <CONFLUENCE_DESIGN_PAGE_ID>）并回写 JIRA 链接。用于 @Architect 发布设计，供实现与测试下游消费。
PRD 产物编排：调用 multica-platform-confluence + multica-platform-jira 落地需求。用于 @ProductManager 上传 PRD、回传链接。
Showing SKILL.md
| name | multica-platform-jira |
| description | JIRA 读写：Issue 查询、Confluence 链接解析、Story 创建、流转、排期、描述回写、钉钉。平台 skill，与 Confluence 解耦。 |
| metadata | {"credentials":{"priority":["ATLASSIAN_USER / ATLASSIAN_PASS","ATLASSIAN_USER / ATLASSIAN_PASS","JIRA_USER / JIRA_PASS"]}} |
JIRA 读 + 写能力：查询 Issue、从描述解析 Confluence 链接；写入 Story、状态流转、排期、描述追加（回写 Confluence 链接）、钉钉通知。与 multica-platform-confluence 解耦。
multica-platform-jira/
├── SKILL.md
├── config.yaml
├── .env.example
└── scripts/
├── credentials.sh
├── jira.sh
└── validate.sh
# Issue 详情（summary、description、fields）
bash scripts/jira.sh get-issue <ISSUE-KEY>
# 从 Issue 描述 / 远程链接解析 Confluence URL 或 pageId
bash scripts/jira.sh get-confluence-url <ISSUE-KEY> [text|json]
# JQL 搜索
bash scripts/jira.sh search "<JQL>" [max_results]
典型链路：get-issue 读验收标准 → get-confluence-url 取 PRD pageId → multica-platform-confluence fetch-page 拉正文。
# 创建 Story（PRD 编排由 multica-artifact-req-sync 调用）
bash scripts/jira.sh create-story --project AAI --summary "..." ...
# 状态流转
bash scripts/jira.sh get-transitions <JIRA_ISSUE_KEY>
bash scripts/jira.sh transition <JIRA_ISSUE_KEY> 已评审
# 排期
bash scripts/jira.sh schedule <JIRA_ISSUE_KEY> <test_owner> 2026-05-28 2026-06-05
# 追加设计文档链接到描述（design-sync 编排调用）
bash scripts/jira.sh append-description <ISSUE_KEY> $'h3. 设计文档 (Design Document)\n* [分片上传设计 [AI]|http://confluence.../pages/viewpage.action?pageId=...]\n'
# 钉钉通知
bash scripts/jira.sh notify-story <JIRA_ISSUE_KEY> <confluence_page_id> aai
追加块使用 Jira Wiki（非 Markdown）：h3. 标题、* 列表、[text|url] 链接。大括号需转义 \{\}。
Confluence 创建失败时，multica-artifact-req-sync 可将 PRD 全文写入 JIRA Story 描述（本 skill create-story / append-description），并标注「Confluence 降级」；恢复后再补建 Confluence 页面并更新描述链接。
| 编排 skill | 调用本 skill |
|---|---|
multica-artifact-req-sync | create-story / transition / schedule / notify / get-issue |
multica-artifact-design-sync | append-description（回写设计 Confluence 链接） |
改 config.yaml 中 jira.url、projects.*.fields、field_options、defaults、dingtalk.project_webhook_map。
JIRA 自定义字段各团队差异大，独立 platform skill 后 Confluence / 设计发布变更不影响 JIRA 脚本；读写分离后 Leader / Architect 可稳定从 Issue 定位上游 Confluence 产物。