mc-breakdown SKILL.md skillA

mc-breakdown from guguzea/mc-ai-coding-assistant-tool is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add guguzea/mc-ai-coding-assistant-tool/mc-breakdown@git:20261010.79a4f96

Pins git:20261010.79a4f96 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
guguzea/mc-ai-coding-assistant-tool
Path
common_skill/mc-breakdown/SKILL.md
Versions recorded
1
Latest version
git:20261010.79a4f96, committed Oct 10, 2026
Size
4,799 bytes
Repository stars
135
License
a license file GitHub does not identify

任务拆解。当 mc-spec 或 mc-grill 共识清单已有拍板内容、用户说「拆成可执行的步骤 / 排个开发顺序 / 先做哪个 / 这功能切成几块」,或要开始一个多部件大功能(一批方块/物品/机制/维度)时激活:把规格拆成一串独立竖切片,每片声明依赖、最低验收层级(L0–L7)与对应开发工作流模板,首片用曳光弹打通最小可玩链路,产出 docs/breakdown-<主题>.md。只出清单不代实施,执行顺序由用户拍板。需求还没定先走 mc-grill / mc-spec,不拆猜测。.

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

# mc-breakdown — 把已定的事拆成一串能独立验收的切片

一句话目标:把「已拍板的规格」变成「可一条条执行、一条条判红绿的开发顺序」,不让人一次吞下半个系统。

## 第 0 步 · 前置检查

- 有 mc-spec 产物(`docs/spec-*.md`)或 mc-grill 共识清单 → 以其为唯一切片依据。
- 都没有 → **停**,先走 mc-spec / mc-grill。从一句话需求直接拆,等于把没定的东西当已定排进顺序——拆出来的每片都是猜的。

## 第 1 步 · 切竖片,不切横层

- 竖切片 = 一片自己走完「注册 → 资源 → 行为 → 可验收」:例如「会掉特殊物品的方块 X」是一片;「所有方块」「所有纹理」「所有配方」三横层是错的切法——横层片没有独立可演示的玩家行为,红了也定位不到是哪一类内容的问题。
- 首片放**曳光弹**:最小完整链路(一个占位方块进游戏、有模型有掉落),目的是先把工程骨架、构建链、验收链跑通,后面的片不堆在沙上。
- 每片五要素:**编号名 / 玩家可见行为一句话 / 依赖(哪些片必须先行)/ 最低验收层级 / 对应工作流模板**。层级按 AGENTS 游玩测试阶梯写明到 L 几:动玩家可见行为至少 L4+L5,纯数据至少 L2/L3,网络/存档 L6。
- 片大小判据:一片 ≈ 一次会话能做完并验到它自己那级;「这片的红长什么样」写得出来才算切到位。

## 第 2 步 · 排序与冲突

- 按依赖排:被依赖的在前。同片改同一文件 / 注册同一注册表的标「串行冲突」,不得并到两个会话盲改。
- 风险前置:会推翻骨架的片(存档格式、网络协议)排早暴露,不许留到收尾。
- 每个排序给理由(链路验证 / 依赖 / 风险)。**玩法先后与性能取舍由用户拍板**——agent 摆事实和代价,等用户选。

## 第 3 步 · 出清单

- 输出 = 编号切片表 + 每片五要素 + 「未拆进来」清单(spec 里暂时切不进的内容,逐条写明原因与后续走法)。
- 用户过目确认后落盘(默认 `docs/breakdown-<主题>.md`);此后每片单独喂对应开发模板 → mc-review 验收,一片绿才开下一片。
- **多会话地图协议**(大工程超过一次会话装得下时):这份文档就是共享地图——新会话先读它,从依赖前沿挑一片开工;片内冒出不该代劳的决定 → 记进文档的「待决」栏(一条一行:问题 / 选项 / 推荐答案),攒到用户在场时清;待决没清完的片标「阻塞」,不许绕着做。地图只更新状态与追加,改顺序回第 2 步问用户。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add guguzea/mc-ai-coding-assistant-tool/mc-breakdown@sha256:c1de47f5067efa6f

The line at the top of this page pins the label git:20261010.79a4f96, 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_eugsra4ianzrzita.svg)](https://markdownregistry.com/a/art_eugsra4ianzrzita)

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

Versions

The registry has recorded 1 version of this file, committed on Oct 10, 2026.

versioncommittedcommitsizeaudit
git:20261010.79a4f96 latest2026-10-10 79a4f96 4,799 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 (4799 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

guguzea/mc-ai-coding-assistant-tool · 135 stars · license a license file GitHub does not identify · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_eugsra4ianzrzita
GET https://markdownregistry.com/api/v1/resolve?ref=guguzea/mc-ai-coding-assistant-tool/mc-breakdown
GET https://markdownregistry.com/api/v1/blob/c1de47f5067efa6f32235f9b21d4bad8b370885643a78bebfd590d0def79df32

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 guguzea/mc-ai-coding-assistant-tool

AGENTS.md AGENTS.md file
guguzea/mc-ai-coding-assistant-tool · AGENTS.md
git:20261105.a32e7f9 · audit A · 135 stars
mc-addon-manifest SKILL.md skill
guguzea/mc-ai-coding-assistant-tool · bedrock/.agents/skills/mc-addon-manifest/SKILL.md · 基岩 manifest.json。触发词:format_version、min_engine_version、modules、capabilities、uuid
git:20260814.76af98c · audit A · 135 stars
mc-addon-setup SKILL.md skill
guguzea/mc-ai-coding-assistant-tool · bedrock/.agents/skills/mc-addon-setup/SKILL.md · 基岩 Add-On 工程结构。触发词:com.mojang、development_behavior_packs、RP/BP、Add-On 从零
git:20260827.8ccbbc4 · audit A · 135 stars
mc-bedrock-block-item SKILL.md skill
guguzea/mc-ai-coding-assistant-tool · bedrock/.agents/skills/mc-bedrock-block-item/SKILL.md · 基岩方块/物品 JSON。触发词:minecraft:block、minecraft:item、block-components、custom die
git:20260814.76af98c · audit A · 135 stars
mc-bedrock-entity SKILL.md skill
guguzea/mc-ai-coding-assistant-tool · bedrock/.agents/skills/mc-bedrock-entity/SKILL.md · 基岩实体 RP/BP 成对。触发词:client_entity、minecraft:entity、entity-components
git:20260827.8ccbbc4 · audit A · 135 stars
mc-bedrock-worldgen SKILL.md skill
guguzea/mc-ai-coding-assistant-tool · bedrock/.agents/skills/mc-bedrock-worldgen/SKILL.md · 基岩世界生成 JSON。触发词:feature、biome、jigsaw、worldgen
git:20260827.8ccbbc4 · audit A · 135 stars
mc-behavior-pack SKILL.md skill
guguzea/mc-ai-coding-assistant-tool · bedrock/.agents/skills/mc-behavior-pack/SKILL.md · 基岩行为包 BP。触发词:minecraft:block、minecraft:item、minecraft:entity、validate_bp_json
git:20260827.8ccbbc4 · audit A · 135 stars
mc-molang SKILL.md skill
guguzea/mc-ai-coding-assistant-tool · bedrock/.agents/skills/mc-molang/SKILL.md · 基岩 Molang。触发词:Molang、query.last_hit_by_player、q.、math.sin
git:20260814.76af98c · audit A · 135 stars
mc-publish-addon SKILL.md skill
guguzea/mc-ai-coding-assistant-tool · bedrock/.agents/skills/mc-publish-addon/SKILL.md · 基岩发布 mcpack/mcaddon。触发词:.mcpack、.mcaddon、市场、BDS、Preview
git:20260827.8ccbbc4 · audit A · 135 stars
mc-resource-pack SKILL.md skill
guguzea/mc-ai-coding-assistant-tool · bedrock/.agents/skills/mc-resource-pack/SKILL.md · 基岩资源包 RP。触发词:terrain_texture、item_texture、client_entity、attachables、sounds.json
git:20260827.8ccbbc4 · audit A · 135 stars
mc-script-api SKILL.md skill
guguzea/mc-ai-coding-assistant-tool · bedrock/.agents/skills/mc-script-api/SKILL.md · 基岩 Script API。触发词:@minecraft/server、world.afterEvents、Beta APIs
git:20260827.8ccbbc4 · audit A · 135 stars
mc-addon-manifest SKILL.md skill
guguzea/mc-ai-coding-assistant-tool · bedrock/.continue/skills/mc-addon-manifest/SKILL.md · 基岩 manifest.json。触发词:format_version、min_engine_version、modules、capabilities、uuid
git:20260827.8ccbbc4 · audit A · 135 stars

Every file in guguzea/mc-ai-coding-assistant-tool

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