メニュー
Confluence 读写：页面拉取、PRD HTML 创建、Markdown 设计发布。平台 skill，与 JIRA 解耦；由产物编排 skill 调用。
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/it235/multica-best-practices --skill multica-platform-confluenceコマンドは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-confluence |
| description | Confluence 读写：页面拉取、PRD HTML 创建、Markdown 设计发布。平台 skill，与 JIRA 解耦；由产物编排 skill 调用。 |
| metadata | {"credentials":{"priority":["ATLASSIAN_USER / ATLASSIAN_PASS","ATLASSIAN_USER / ATLASSIAN_PASS","CONFLUENCE_USER / CONFLUENCE_PASS"]},"landing":{"prd_parent_page_id":"config confluence.default_parent_page_id","design_parent_page_id":"<CONFLUENCE_DESIGN_PAGE_ID>","design_local_draft":"docs/design/<ISSUE-KEY>/design.md"}} |
Confluence 读 + 写能力：拉取已有页面供 Agent 消费，把 PRD / 设计等产物落地并回传稳定页面链接。与 multica-platform-jira 解耦——只负责 Confluence，不负责 JIRA 字段写入。
角色提示词不写 Confluence URL / pageId；换 Wiki / 语雀 / 飞书只换本 skill。
| 产物类型 | Confluence 父页面 | 本地草稿（Agent 先写） |
|---|---|---|
| PRD | config.yaml → confluence.default_parent_page_id | 由 multica-requirement-analysis 结构化后交 req-sync 编排 |
| 技术设计 | <CONFLUENCE_DESIGN_PAGE_ID>（confluence.design_parent_page_id） | docs/design/<ISSUE-KEY>/design.md |
设计文档父页面：pageId=<CONFLUENCE_DESIGN_PAGE_ID>
multica-platform-confluence/
├── SKILL.md
├── config.yaml
├── spaces.json
├── .env.example
└── scripts/
├── credentials.sh
├── confluence.sh # Read/Write CLI
├── fetch_page.py # Confluence → local Markdown
├── publish_design.py # Markdown 设计 upsert
├── lib/md_to_confluence.py
├── lib/html_to_md.py
├── lib/resolve_skills.sh
├── requirements.txt
└── templates/
├── prd-template.md
└── design-template.md
# 按 pageId 拉取为 Markdown（可选写入 docs/design/<ISSUE-KEY>/ 或自定义目录）
bash scripts/confluence.sh fetch-page <page_id> [output_dir] [jira_key]
# 获取页面元数据 / 原始 storage（调试）
bash scripts/confluence.sh get-page <page_id>
# 按标题搜索
bash scripts/confluence.sh find-page "<title>" [space_key]
典型链路：JIRA Issue 描述含 Confluence 链接 → 用 multica-platform-jira 的 get-confluence-url 解析 pageId → 本 skill fetch-page 拉取 PRD / 设计正文。
bash scripts/confluence.sh create-page "<title>" "<parent_page_id>" "<html>" "<space_key>"
由 multica-artifact-req-sync 编排调用；Confluence 不可用时见 req-sync Workflow E（全文降级到 JIRA 描述）。
multica-technical-design 写本地：docs/design/<ISSUE-KEY>/design.md（基线见 scripts/templates/design-template.md）。pip install -r scripts/requirements.txt # 首次；可选 pip install markdownify 提升 HTML→MD 质量
python scripts/publish_design.py <ISSUE-KEY> docs/design/<ISSUE-KEY>/design.md \
[--space SPACE] [--parent PAGE_ID] [--title "标题"] [--json]
url / page_id；multica-artifact-design-sync 再调用 multica-platform-jira 把链接写入 JIRA。Upsert 规则：同 space + 同 title 则更新版本；title 自动加 [AI] 后缀。
metadata.credentials；禁止打印密码。scripts/，不要裸调 REST。MULTICA_SKILLS_ROOT 或同级 templates/skills/ 定位本 skill（见 scripts/lib/resolve_skills.sh）。config.yaml：confluence.url、default_space、*_parent_page_id。projects.<JIRA-PREFIX>.confluence_space / design_parent_page_id。spaces.json。Confluence 认证、space、父页面各团队不同；独立 platform skill 后，JIRA / 钉钉 / Git 变更不影响 Confluence 脚本，PRD 与设计共用同一套读写能力。