メニュー
JIRA 读写：Issue 查询、Confluence 链接解析、Story 创建、流转、排期、描述回写、钉钉。平台 skill，与 Confluence 解耦。
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/it235/multica-best-practices --skill multica-platform-jiraコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
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、回传链接。
| 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 产物。