licanfu/multica-best-practices/multica-artifact-architect

Artifact · Architect（薄编排）

Purpose

只规定架构师产物写什么、发布前怎么自检；Confluence 上传、父页面解析、JIRA 回写全部由 platform skill 封装。

本 skill 不含脚本；跨平台请直接调用 platform 层的 Python CLI（Windows / macOS / Linux 均可）。

Platform 协作

凭据与 CLI 细节只查 platform skill。

@Architect 标准流程

1. multica-technical-design       — 写 docs/design/<ISSUE-KEY>/design.md
2. 自检（见下表）
3. multica-platform-confluence      — publish_design.py（默认父页面 = JIRA 需求 Confluence 页）
4. multica-platform-jira            — 已在 --append-jira 时一并回写；或单独 append-artifact-link
5. 向 Leader 回传 Confluence 链接

父页面规则（Issue Hub）

Issue 创建时已绑定 JIRA 编号；JIRA 描述中的 Confluence 需求页 是本需求的文档根（PRD Hub）。

Leader / 下游读 PRD：multica-platform-jira → get-confluence-url → multica-platform-confluence → fetch-page。

架构师产物规范（发布前自检）

本地草稿：docs/design/<ISSUE-KEY>/design.md（章节基线见 multica-platform-confluence/scripts/templates/design-template.md）。

自检 FAIL → 先补草稿，不调 platform。

落地（platform skill，一条命令）

pip install -r multica-platform-confluence/scripts/requirements.txt
python multica-platform-confluence/scripts/publish_design.py \
  <ISSUE-KEY> docs/design/<ISSUE-KEY>/design.md \
  --append-jira --json

• 默认从 JIRA 解析 Confluence 需求页作为父页面；需禁用：--no-parent-from-jira
• 显式指定父页面：--parent <pageId>
• JIRA 单独回写链接：python multica-platform-jira/scripts/jira_cli.py append-artifact-link ...

详细参数见 multica-platform-confluence/SKILL.md 与 multica-platform-jira/SKILL.md。

用法（角色侧）

先用 multica-technical-design 写 docs/design/<ISSUE-KEY>/design.md，
再用 multica-artifact-architect 规范自检后，按 platform skill 发布并回传链接。

为什么有效

产物 skill 保持薄层：规范与流程在 artifact，能力与脚本在 platform；Issue 自带 JIRA + Confluence 需求链接，后续文档天然挂在同一需求树下，无需固定全局 pageId。