it235
it235/multica-best-practices
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/it235/multica-best-practices --skill multica-platform-confluence命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
| 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 与设计共用同一套读写能力。