it235 Platform · JIRA
Platform 协作
本 skill 为 platform 层；供 artifact / Tester T1 等按名调用。读：get_issue.py、get-confluence-url；写：Story / append / transition。
Purpose
JIRA 读 + 写能力：查询 Issue、从描述解析 Confluence 需求页（Issue Hub）；写入 Story、流转、排期、描述追加、钉钉。
跨平台：优先
python scripts/jira_cli.py（Windows / macOS / Linux）；jira.sh为 Unix 全功能封装，非 artifact 流程必需。
Issue Hub
JIRA Issue 描述（及 remote link）中的 第一个 Confluence pageId = 本需求的 PRD/需求正文页。
- 下游文档产物（技术设计等）以该页为 Confluence 父页面（由
multica-platform-confluencepublish_design.py自动解析）。 - Leader / 下游读 PRD：本 skill 解析链接 → Confluence
fetch_page.py。 - 关联 Issue：
get_issue.py输出linked_issues；开工前必读规则见references/upstream-read.md与docs/multi-repo-and-issue-links.md§2。
Files
multica-platform-jira/
├── SKILL.md
├── config.yaml
├── .env.example
└── scripts/
├── jira_cli.py # 跨平台 CLI（推荐）
├── get_issue.py # Issue JSON（Tester fetch_all）
├── jira.sh # Unix 全功能封装（可选）
├── lib/jira_client.py
└── requirements.txt
Read（跨平台 CLI）
pip install -r scripts/requirements.txt
# 完整 Issue JSON（含 Confluence/Figma 链接、附件、linked_issues）— Tester fetch_all 使用
python scripts/jira_cli.py get-issue --url "https://jira.../browse/PROJ-123" --output data/jira.json
# 或直接
python scripts/get_issue.py --url "https://jira.../browse/PROJ-123" --output data/jira.json
# 含关联 Issue 一层描述与链接（迭代/依赖需求）
python scripts/get_issue.py --url "https://jira.../browse/PROJ-123" --with-linked -o data/jira-full.json
# Issue 中的 Confluence 链接 / pageId
python scripts/jira_cli.py get-confluence-url <ISSUE-KEY> --json
# 作为文档产物父页面的 pageId（第一个 Confluence 链接）
python scripts/jira_cli.py resolve-parent-page-id <ISSUE-KEY>
Unix 可选：bash scripts/jira.sh get-issue <ISSUE-KEY>、bash scripts/jira.sh search ...
Write · 产物链接回写
# 通用 Wiki 块追加
python scripts/jira_cli.py append-description <ISSUE-KEY> "h3. 标题\n* [链接|url]\n"
# 结构化产物链接（设计 / API 等）
python scripts/jira_cli.py append-artifact-link <ISSUE-KEY> \
--section "设计文档 (Design Document)" \
--title "xxx [AI]" \
--url "http://confluence.../pageId=..." \
--source design.md
publish_design.py --append-jira 会在发布成功后自动调用等价逻辑。
与产物 / 阶段 skill 的关系
| 调用方 | 实际调用 |
|---|---|
multica-pm-artifact-publish |
create-story / transition / … |
multica-artifact-architect |
get-confluence-url、append-artifact-link（发布由 confluence skill） |
multica-artifact-backend / -frontend |
append-artifact-link |
multica-test-t1-design |
get_issue.py / get-issue；import_to_tracker.py 仍在本 skill |
完整矩阵见 docs/platform-collaboration.md。
Adapting To A New Team
改 config.yaml：jira.url、projects.*.fields、钉钉映射等。
为什么有效
Issue 自带 JIRA 编号与 Confluence 需求链接，父页面无需写死在角色提示词；Python CLI 避免 Windows 上依赖 bash。