PM Artifact Publish(产品经理产物提交规范 · 编排)
Purpose
PRD 专用编排 — 调用 platform skill 完成 Confluence / JIRA 创建与更新,回传稳定链接。不重复实现 REST 脚本。
内容结构由
multica-pm-requirement-spec负责;本 skill 只管「提交到哪里、如何更新」。
Platform 协作
| Platform skill | 本 skill 用途 |
|---|---|
multica-platform-confluence |
创建/更新 PRD 页面、拉取已有页面 |
multica-platform-jira |
创建/更新 Story、描述追加、流转、钉钉 |
凭据:JIRA_USERNAME / JIRA_PASSWORD(见 frontmatter 与 platform skill)。
智能体指令见 references/agent-instructions.md;创建/更新细则见 references/publish-workflow.md。
@ProductManager 标准流程
1. multica-pm-requirement-spec — 结构化 PRD + 修订记录
2. multica-pm-artifact-publish — 本 skill:Confluence + JIRA + 可选钉钉
Workflow A:首次提交(创建)
- Confluence — 在 PRD 父页面下创建页面(HTML/Markdown 由 spec 产出):
bash scripts/confluence.sh create-page \
"<title>" "<parent_id>" "<html>" "<space>"
# ↑ multica-platform-confluence;路径由 MULTICA_SKILLS_ROOT 解析
- JIRA Story — 描述含 Confluence 链接:
bash scripts/jira.sh create-story \
--project <KEY> --summary "<title>" --description "..." ...
# ↑ multica-platform-jira
- 可选钉钉:
multica-platform-jira→notify-story
或编排脚本:
export MULTICA_SKILLS_ROOT="/path/to/templates/skills"
bash scripts/publish-prd.sh --project PROJ --summary "..." --html-file prd.html \
-- --need-user <user> --background "..." ...
- 回传 Leader:Confluence URL、JIRA Key、创建时间、修订版本号。
Workflow B:Review 后二次提交(更新)
禁止为同一需求重复
create-story;Review 修订走更新链路。
- Confluence — 对已有页面 upsert/update(保留 pageId;修订记录写入正文)
- JIRA — 对已有 Story:
append-description或update摘要/描述(含「修订 vN」与 Confluence 链接)- 禁止新建第二个 Story 代替修订
- 回传更新后的链接 + 修订版本号,供 ProductReviewer 复审
Workflow C–E
状态流转、排期、Confluence 阻塞降级(Workflow E:PRD 全文写入 JIRA 描述)——见 multica-platform-jira / multica-platform-confluence SKILL.md。
配置
- PRD 父页面 / space:
multica-platform-confluence/config.yaml - JIRA 字段 / 项目:
multica-platform-jira/config.yaml - 本目录
config.yaml:团队 PRD 默认值与钉钉映射(向后兼容)
用法(角色侧)
先用 multica-pm-requirement-spec 结构化 PRD,
再用 multica-pm-artifact-publish 落地并回传链接;
Review FAIL 后修订 PRD,再用 publish Workflow B 更新(勿重复创建 Story)。
为什么有效
JIRA / Confluence 共用 platform skill;创建 vs 更新分离,避免 Review 迭代产生重复 Story;编排通过 skill 名 + MULTICA_SKILLS_ROOT 定位。