| name | multica-artifact-design-sync |
| description | 把技术设计文档落地到 Confluence（默认父页面 <CONFLUENCE_DESIGN_PAGE_ID>）并回写 JIRA 链接。用于 @Architect 发布设计，供实现与测试下游消费。 |
| metadata | {"orchestrates":["multica-platform-confluence","multica-platform-jira"],"landing":{"confluence_parent_page_id":"<CONFLUENCE_DESIGN_PAGE_ID>","local_draft":"docs/design/<ISSUE-KEY>/design.md"}} |
Artifact · Technical Design Sync
Purpose
编排 Confluence 发布 + JIRA 描述回写，把 @Architect 的技术设计变成下游可引用的稳定链接。
平台能力在 multica-platform-confluence 与 multica-platform-jira；本 skill 只管「设计产物」编排，不换平台时不动 Architect 提示词。
前置
- 内容已通过
multica-technical-design 写入本地：docs/design/<ISSUE-KEY>/design.md
- 凭据：
ATLASSIAN_USER / ATLASSIAN_PASS（见 SECURITY.md）
- 可选：
export MULTICA_SKILLS_ROOT="/path/to/templates/skills"
默认落点
| 步骤 | 平台 | 位置 |
|---|
| 发布 | Confluence | 父页面 <CONFLUENCE_DESIGN_PAGE_ID> 下 upsert 子页面 |
| 回写 | JIRA | Issue 描述追加「设计文档」Wiki 块 + 链接 |
设计目录页：pageId=<CONFLUENCE_DESIGN_PAGE_ID>
Workflow（来自 dev-workflow design publish）
- 发布 Markdown → Confluence（同 title 则更新版本，title 加
[AI] 后缀）：
export MULTICA_SKILLS_ROOT="<path-to>/templates/skills"
pip install -r "$MULTICA_SKILLS_ROOT/multica-platform-confluence/scripts/requirements.txt"
python "$MULTICA_SKILLS_ROOT/multica-platform-confluence/scripts/publish_design.py" \
<ISSUE-KEY> docs/design/<ISSUE-KEY>/design.md --json
-
从 JSON 取 url 与 title。
-
回写 JIRA 描述：
bash "$MULTICA_SKILLS_ROOT/multica-platform-jira/scripts/jira.sh" append-description \
<ISSUE-KEY> $'h3. 设计文档 (Design Document)\n* [<title>|<url>]\n* _Auto-published from: design.md_\n'
- 向 Leader 回传 Confluence 链接（稳定引用）。
或使用本 skill 编排脚本：
bash scripts/publish-design.sh <ISSUE-KEY> docs/design/<ISSUE-KEY>/design.md
产物内容规范
依据 multica-technical-design：当前架构、最小改动、受影响组件、实现步骤、验证计划、风险；保留稳定标题。
用法（角色侧只写这一句）
@Architect：「先用 multica-technical-design 写 docs/design/<ISSUE-KEY>/design.md，再用本 skill 发布到 Confluence 并回传链接。」
替换平台
换 Wiki / 语雀时改 multica-platform-confluence 实现；JIRA 回写改 multica-platform-jira；本 skill 编排步骤不变。
为什么有效
dev-workflow 已验证「本地 md → Confluence upsert → JIRA 挂链接」链路；platform skill 按名挂载 + MULTICA_SKILLS_ROOT，PRD / 设计 / API 文档可复用 Confluence 能力而不重复脚本。
