multica-technical-design SKILL.md skillA

multica-technical-design from it235/multica-best-practices is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add it235/multica-best-practices/multica-technical-design@git:20260910.699a593

Pins git:20260910.699a593 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
it235/multica-best-practices
Path
templates/zh_CN/skills/architect/multica-technical-design/SKILL.md
Versions recorded
2
Latest version
git:20260910.699a593, committed Sep 10, 2026
First version recorded
Sep 10, 2026
Size
6,211 bytes
Repository stars
237
License
MIT

基于 PRD 与现有代码产出最小技术方案。用于 @Architect 架构分析、影响评估、实现方案设计;含文档元数据与复审修订规范;草稿就绪后交 multica-artifact-architect 落地。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Technical Design

## Purpose

基于 PRD(或 Issue)与现有代码库,产出**最小可行**的技术设计(只管「写什么」,不管「落到哪个平台」)。

> 与 `multica-artifact-architect` 分工:**technical-design 产出结构与内容;artifact-architect 校验产物并调用 Confluence/JIRA platform skills 落地**。  
> 与 `multica-review-architect` 配合:**初稿 → 评审 → 修订 → 复审**(最多 3 轮),每轮修订须递增版本并填写「评审回应」。

## Platform 协作

| Platform skill | 本 skill 用途 |
| --- | --- |
| `multica-platform-jira` / `multica-platform-confluence` | 读 PRD / Issue(开工前);**写**由 `multica-artifact-architect` 编排 |

本 skill 只产出本地 `design.md`;凭据与发布 CLI 见 platform skill。

## Process

1. 读 PRD / Issue 与验收标准(AC-/FR-/BR-)。
2. 检查当前实现(优先 codegraph / 现有模式,不大面积扫库)。
3. 识别相关模块与现有模式。
4. 确定最小可行改动;**非目标**写清楚。
5. 识别数据/接口/非功能影响与依赖(RISK-、DECISION-)。
6. 定义验证方式(对齐 AC-);填**需求追溯**表。
7. 写文档**头部元数据**(创建者、创建时间、版本、状态)。
8. 信息不足 → BLOCKED,写入「待决事项」,不猜。

## Principles

```text
现有模式 > 新抽象
小改动   > 大重构
复用     > 新依赖
可验证   > 不可验证的设想
可回滚   > 一次性不可逆改动
```

## 本地草稿路径

```text
docs/design/<ISSUE-KEY>/design.md
```

章节基线见 `multica-platform-confluence/scripts/templates/design-template.md`。

## 文档头部(必须,置于 H1 标题下)

设计正文**第一块**必须是元数据表,便于 ArchReviewer 追踪版本与责任人:

| 字段 | 规则 |
| --- | --- |
| **创建者** | `Architect-<member-id>`(与 Squad member 一致) |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add it235/multica-best-practices/multica-technical-design@sha256:bc5e8e98e1ca95b6

The line at the top of this page pins the label git:20260910.699a593, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_7nr7ywhi242bjapo.svg)](https://markdownregistry.com/a/art_7nr7ywhi242bjapo)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, all committed on Sep 10, 2026.

versioncommittedcommitsizeaudit
git:20260910.699a593 latest2026-09-10 699a593 6,211 BA view · diff
git:20260910.8db057c2026-09-10 8db057c 6,221 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6211 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

it235/multica-best-practices · 237 stars · license MIT · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_7nr7ywhi242bjapo
GET https://markdownregistry.com/api/v1/resolve?ref=it235/multica-best-practices/multica-technical-design
GET https://markdownregistry.com/api/v1/blob/bc5e8e98e1ca95b6e76d7649f4591db6ab2f11b5a695476089bd06654c3af8a2

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from it235/multica-best-practices

AGENTS.md AGENTS.md file
it235/multica-best-practices · AGENTS.md
git:20260910.5cb31cc · audit A · 237 stars
multica-artifact-architect SKILL.md skill
it235/multica-best-practices · templates/en_US/skills/architect/multica-artifact-architect/SKILL.md · Land technical design artifacts to the code repo or knowledge platform (default Git repo / Confluence). Used by…
git:20260910.699a593 · audit A · 237 stars
multica-technical-design SKILL.md skill
it235/multica-best-practices · templates/en_US/skills/architect/multica-technical-design/SKILL.md · Produce a minimal technical plan based on the existing code. Used for architecture analysis, impact assessment, and…
git:20260910.8db057c · audit A · 237 stars
multica-artifact-backend SKILL.md skill
it235/multica-best-practices · templates/en_US/skills/backend/multica-artifact-backend/SKILL.md · Land API contract artifacts to the API collaboration platform (default Apifox). Used by @BackendDev to upload API…
git:20260910.699a593 · audit A · 237 stars
multica-backend-impl SKILL.md skill
it235/multica-best-practices · templates/en_US/skills/backend/multica-backend-impl/SKILL.md · Backend implementation skill—API / data model / business logic coding conventions and acceptance checklist; the…
v1.0.0 · audit A · 237 stars
multica-design-ui-impl SKILL.md skill
it235/multica-best-practices · templates/en_US/skills/designer/multica-design-ui-impl/SKILL.md · Land UI / interaction design artifacts to the design collaboration platform (default Figma). Used by @Designer to…
git:20260910.699a593 · audit A · 237 stars
multica-artifact-cicd-sync SKILL.md skill
it235/multica-best-practices · templates/en_US/skills/devops/multica-artifact-cicd-sync/SKILL.md · CI/CD artifact-orchestration skill (placeholder shell): after G2 PASS and code push, call the underlying CI/CD platform…
git:20260910.8db057c · audit A · 237 stars
multica-artifact-frontend SKILL.md skill
it235/multica-best-practices · templates/en_US/skills/frontend/multica-artifact-frontend/SKILL.md · Frontend artifact sync—push the frontend deliverable set (page/component/state/style) and run-url to Multica…
v1.0.0 · audit A · 237 stars
multica-frontend-impl SKILL.md skill
it235/multica-best-practices · templates/en_US/skills/frontend/multica-frontend-impl/SKILL.md · Frontend implementation skill—page/component/state/style coding conventions and acceptance checklist; the preferred…
v1.0.0 · audit A · 237 stars
multica-verification SKILL.md skill
it235/multica-best-practices · templates/en_US/skills/leader/multica-verification/SKILL.md · Gatekeeping function: objectively check whether an artifact satisfies the acceptance criteria. Triggered by the Leader…
git:20260910.699a593 · audit A · 237 stars
multica-platform-apifox SKILL.md skill
it235/multica-best-practices · templates/en_US/skills/platform/multica-platform-apifox/SKILL.md · Apifox integration—read API contracts/scenarios, and run/supplement test scenarios. Credentials and CLI are only looked…
v1.1.0 · audit A · 237 stars
multica-platform-confluence SKILL.md skill
it235/multica-best-practices · templates/en_US/skills/platform/multica-platform-confluence/SKILL.md · Platform-layer skill (placeholder shell): read/write capability for Confluence / Wiki-class systems — pull existing…
git:20260910.5cb31cc · audit A · 237 stars

Every file in it235/multica-best-practices

Other files named multica-technical-design

multica-technical-design SKILL.md skill
it235/multica-best-practices · templates/en_US/skills/architect/multica-technical-design/SKILL.md · Produce a minimal technical plan based on the existing code. Used for architecture analysis, impact assessment, and…
git:20260910.8db057c · audit A · 237 stars

Browse by kind, by grade A, or by owner.