Artifact · Frontend(薄编排)
Purpose
只规定前端实现说明写什么、发布前怎么自检;Confluence 发布、JIRA 回写由 platform skill 封装。代码在真实仓库,本文档供评审 / 测试 / Leader 对照。
本 skill 不含脚本;编码与体验见
multica-frontend-impl。
Platform 协作
| Platform skill | 本 skill 用途 |
|---|---|
multica-platform-jira |
读 Issue / 回写 impl-spec 链接 |
multica-platform-confluence |
发布 impl-spec.md 到 Issue Hub 子页 |
multica-platform-figma |
读设计链接(上游由 Designer / Issue 提供) |
凭据与 CLI 细节只查 platform skill。
@FrontendDev 标准流程
1. multica-frontend-impl — 读上游(PRD/架构/UI/API)
2. 写 docs/frontend/<ISSUE-KEY>/impl-spec.md(开工前或实现中更新)
3. 自检(见下表)
4. multica-platform-confluence — publish_design.py --append-jira
5. 实现页面/组件 + 测试
6. 回传 Confluence 链接 + 代码证据给 Leader
父页面(Issue Hub)
JIRA 描述中 Confluence 需求页 为父页面;前端实现说明发布为其子页面(与架构设计、API 契约并列)。
实现说明规范(发布前自检)
本地草稿:docs/frontend/<ISSUE-KEY>/impl-spec.md
基线:multica-platform-confluence/scripts/templates/frontend-impl-template.md
| 章节 | 必填 | 内容要求 |
|---|---|---|
| 文档头部 | 是 | 创建者、时间、版本、状态、JIRA、PRD、架构、UI、API 链接 |
| 页面与路由 | 是 | 页面 · 路由 · 入口 · AC- |
| 交互与状态 | 是 | 操作/反馈;空态/加载/异常/无权限 |
| 组件映射 | 是 | UI 区域 · 组件 · 复用/新建 |
| API 对接 | 涉及时 | API-ID · 调用时机 · 错误 UX |
| 表单与校验 | 涉及时 | 规则 · 提示文案 · BR- |
| 体验与无障碍 | 按需 | 响应式、键盘、性能感知 |
| Mock 策略 | 后端未就绪时 | Mock 位置与切换条件 |
| 验证计划 | 是 | 组件/手动/E2E · AC- |
| 修订记录 | 是 | 版本递增 |
自检 FAIL → 先补文档,不调 platform。
落地(platform skill)
pip install -r multica-platform-confluence/scripts/requirements.txt
python multica-platform-confluence/scripts/publish_design.py \
<ISSUE-KEY> docs/frontend/<ISSUE-KEY>/impl-spec.md \
--append-jira --json
JIRA 追加块:h3. 前端实现说明 (Frontend Implementation)。
用法(角色侧)
按 multica-artifact-frontend 规范写 impl-spec.md,
自检后 platform 发布到 Confluence 并回传链接。
为什么有效
把「交互与状态」从代码里抽成可评审文档,挂需求树下;与后端契约、架构设计同 Hub,下游不迷路。