Multica Artifact Backend

后端产物薄编排:API 契约文档规范,落地调 multica-platform-confluence + multica-platform-jira。用于 @BackendDev 发布契约供前端/测试消费。

279 stars 33 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add it235/multica-best-practices --skill multica-artifact-backend
Manual install
git clone --depth 1 https://github.com/it235/multica-best-practices.git /tmp/multica-best-practices
mkdir -p ~/.claude/skills
cp -r /tmp/multica-best-practices/templates/zh_CN/skills/backend/multica-artifact-backend ~/.claude/skills/multica-artifact-backend

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Artifact · Backend(薄编排)

## Purpose

**只规定 API 契约写什么、发布前怎么自检**;Confluence 发布、Apifox 同步由 platform skill 封装。

> 本 skill **不含脚本**;实现编码见 `multica-backend-impl`(TDD)。

## Platform 协作

| Platform skill | 本 skill 用途 |
| --- | --- |
| `multica-platform-confluence` | 发布 `api-contract.md` 到 Issue Hub 子页 |
| `multica-platform-jira` | 解析父 pageId;`append-artifact-link` 回写契约链接 |
| `multica-platform-apifox` | `sync_openapi.js` 同步 OpenAPI + Issue tag |

凭据与 CLI 细节**只查 platform skill**;矩阵见 [`docs/platform-collaboration.md`](../../../../../docs/zh_CN/platform-collaboration.md)。

## @BackendDev 标准流程

```text
1. multica-backend-impl        — 读上游 + TDD 实现
2. 写 docs/backend/<ISSUE-KEY>/api-contract.md
3. 自检(见下表)
4. multica-platform-confluence — publish_design.py --append-jira
5. multica-platform-apifox — sync_openapi.js(OpenAPI 增/改/删 + Issue tag;**每次新建 AI 分支**,见 platform-apifox `openapi-branch-workflow.md`)
6. 回传 Confluence + Apifox 同步摘要(含 AI 分支名)给 Leader
```

## 父页面(Issue Hub)

与 `multica-artifact-architect` 相同:JIRA 描述中 **Confluence 需求页** 为父页面;API 契约发布为其**子页面**。

## API 契约规范(发布前自检)

本地草稿:`docs/backend/<ISSUE-KEY>/api-contract.md`  
基线:`multica-platform-confluence/scripts/templates/backend-api-template.md`

| 章节 | 必填 | 内容要求 |
| --- | --- | --- |
| **文档头部** | 是 | 创建者、时间、版本、状态、JIRA、上游 PRD、架构设计链接 |
| **概述** | 是 | 范围;与架构实现步骤对应 |
| **端点清单** | 是 | API-ID · 方法 · 路径 · 对应 BR-/AC- |
| **端点详情** | 是 | 请求/响应 schema、错误码、鉴权 |
| **通用约定** | 推荐 | 分页、幂等、时间格式等 |
| **数据模型** | 涉及时 | 实体/字段变更 |
Read the full skill on GitHub

Details

Skill name
multica-artifact-backend
Path
templates/zh_CN/skills/backend/multica-artifact-backend/SKILL.md
License
MIT
Repo updated
4 November 2026

FAQ

What does the Multica Artifact Backend skill do?

后端产物薄编排:API 契约文档规范,落地调 multica-platform-confluence + multica-platform-jira。用于 @BackendDev 发布契约供前端/测试消费。

How do I install the Multica Artifact Backend skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add it235/multica-best-practices --skill multica-artifact-backend. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Multica Artifact Backend popular?

It lives in it235/multica-best-practices, which has 279 GitHub stars and 33 forks.

Related skills

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.