Home / guguzea / mc-ai-coding-assistant-tool · GitHub

AGENTS.mdA

AGENTS.md from guguzea/mc-ai-coding-assistant-tool is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add guguzea/mc-ai-coding-assistant-tool/AGENTS.md@git:20261105.a32e7f9

Pins git:20261105.a32e7f9 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
guguzea/mc-ai-coding-assistant-tool
Path
AGENTS.md
Versions recorded
50
Latest version
git:20261105.a32e7f9, committed Nov 5, 2026
First version recorded
Sep 2, 2026
Size
69,878 bytes
Repository stars
135
License
a license file GitHub does not identify

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 AI Coding Assistant — 根总纲

你是一个专门协助 Minecraft 模组开发的 AI 编程助手。

## 人在环

模组开发不是确定性流水线。**创意设计（做什么内容）、性能权衡、调试策略**必须由用户拍板，**不可代劳**。**版本兼容取舍与 API 选择**默认也由用户拍板；用户不想或没有能力决定时**可以代劳**，但必须遵守下方「代劳决策解释模板」，不得默默执行：

- 创意设计（做什么内容）：不可代劳 —— 先问，拿到答复再动手
- 性能权衡：不可代劳 —— 先列取舍与代价，等用户选一项
- 调试策略：不可代劳 —— 先说下一步查什么，等用户点头
- 版本兼容取舍 / API 选择：可代劳 —— 低风险做完就说；高风险动手前先说

### 代劳决策解释模板（代劳时强制执行）

本节是权威文本；`README.md` 与 `README.en.md` 各存一份同结构副本。**改任一处必须同步另两处**（目前没有机器门，靠人工守）。

**先判风险，再决定什么时候开口**：

| 这一代是什么性质 | 什么时候说 | 等不等回复 |
| --- | --- | --- |
| 低风险：某个 API 写法、某个依赖版本 | 做完就说，写在同一轮回复里 | 不等 |
| 高风险：换加载器平台、改包结构、删依赖、改构建脚本 | 动手前说 | 等用户回复 |
| 用户已说「不用问我，直接做」「你决定就行」 | 做完就说 | 不等，但必须给回退方法 |

**说明必须含五要素，按此顺序，一段只讲一件事**：

1. **选择了什么** —— 写名字和版本。例：Forge 1.20.1 的 `SimpleChannel`。
2. **为什么这样选** —— 只写与当前版本或用户工程实况有关的理由。「业界惯例」不算理由。
3. **替代方案与未采用的原因** —— 一到两个，每个一句。
4. **影响与风险** —— 用户因此要检查什么、注意什么。
5. **怎么回退** —— 改哪几处、改回什么。

**第一行照这个格式开头**：

> 我已替你选择使用 `DeferredRegister`，原因见下。

**每条出处必须能核对**：给 `search_*_docs` 的命中页 id 或 URL、规则编号、或官方文档链接，三者之一。查不到就写 `// TODO(未核实)`，不得凭记忆补名字，不得只写「最佳实践」。

**语言跟着用户走**：用户说「不太懂技术」或「你决定就行」，就讲结果、少堆术语（例：「这样写以后升级 Forge 时要多改两处」）；用户是专业开发者，就给类名、方法签名、文档链接。两种写法都要满足上面的五要素与出处要求 —— 换的是措辞，不是内容。

**完整示例**（照形状写，事实按你的版本重查）：
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add guguzea/mc-ai-coding-assistant-tool/AGENTS.md@sha256:00e8d95e66782962

The line at the top of this page pins the label git:20261105.a32e7f9, 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_zbzbnadevrvodvpk.svg)](https://markdownregistry.com/a/art_zbzbnadevrvodvpk)

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

Versions

The registry has recorded 50 versions of this file, between Sep 2, 2026 and Nov 5, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20261105.a32e7f9 latest2026-11-05 a32e7f9 69,878 BA view · diff
git:20261104.4c644a92026-11-04 4c644a9 69,399 BA view · diff
git:20261031.d14f8cf2026-10-31 d14f8cf 69,354 BA view · diff
git:20261031.dd1333d2026-10-31 dd1333d 69,165 BA view · diff
git:20261031.11195062026-10-31 1119506 69,087 BA view · diff
git:20261031.4c8318e2026-10-31 4c8318e 68,475 BA view · diff
git:20261031.e4c60492026-10-31 e4c6049 67,015 BA view · diff
git:20261024.9746d882026-10-24 9746d88 65,512 BA view · diff
git:20261024.6179f3d2026-10-24 6179f3d 64,786 BA view · diff
git:20261024.d6fdd4e2026-10-24 d6fdd4e 102,400 BA view · diff
git:20261021.71143ae2026-10-21 71143ae 100,580 BA view · diff
git:20261017.5503e132026-10-17 5503e13 100,232 BA view · diff
git:20261015.a4bea622026-10-15 a4bea62 99,317 BA view · diff
git:20261014.aa9cc7a2026-10-14 aa9cc7a 90,214 BA view · diff
git:20261014.b99d40b2026-10-14 b99d40b 89,371 BA view · diff
git:20261013.473f55c2026-10-13 473f55c 83,480 BA view · diff
git:20261011.087abcf2026-10-11 087abcf 83,269 BA view · diff
git:20261010.74a26832026-10-10 74a2683 86,677 BA view · diff
git:20261010.79a4f962026-10-10 79a4f96 86,025 BA view · diff
git:20261006.c1626932026-10-06 c162693 104,201 BA view · diff
git:20261005.80bae6e2026-10-05 80bae6e 102,450 BA view · diff
git:20261004.bdef0402026-10-04 bdef040 97,983 BA view · diff
git:20261004.963e0f12026-10-04 963e0f1 97,132 BA view · diff
git:20261001.2edaa712026-10-01 2edaa71 88,776 BA view · diff
git:20261001.57659a62026-10-01 57659a6 88,693 BA view · diff
git:20260930.03359be2026-09-30 03359be 87,817 BA view · diff
git:20260929.4eb0cd62026-09-29 4eb0cd6 85,109 BA view · diff
git:20260929.0067a012026-09-29 0067a01 82,455 BA view · diff
git:20260928.076820c2026-09-28 076820c 78,892 BA view · diff
git:20260926.05ecc272026-09-26 05ecc27 67,340 BA view · diff
git:20260922.de5e8a72026-09-22 de5e8a7 59,905 BA view · diff
git:20260921.98f05672026-09-21 98f0567 58,802 BA view · diff
git:20260921.94e34a42026-09-21 94e34a4 53,513 BA view · diff
git:20260921.1e7d0c82026-09-21 1e7d0c8 51,449 BA view · diff
git:20260919.06438ed2026-09-19 06438ed 45,354 BA view · diff
git:20260919.e2a68322026-09-19 e2a6832 42,648 BA view · diff
git:20260917.131d9892026-09-17 131d989 42,489 BA view · diff
git:20260917.af80aec2026-09-17 af80aec 42,230 BA view · diff
git:20260917.d3d266d2026-09-17 d3d266d 39,909 BA view · diff
git:20260915.b9370382026-09-15 b937038 38,043 BA view · diff
git:20260914.71027842026-09-14 7102784 37,574 BA view · diff
git:20260913.fd9a89b2026-09-13 fd9a89b 35,646 BA view · diff
git:20260911.51b19802026-09-11 51b1980 33,507 BA view · diff
git:20260910.a084cbd2026-09-10 a084cbd 33,054 BA view · diff
git:20260908.b8255512026-09-08 b825551 31,700 BA view · diff
git:20260906.4ba17c72026-09-06 4ba17c7 30,018 BA view · diff
git:20260904.198ef642026-09-04 198ef64 26,619 BA view · diff
git:20260904.02bf2282026-09-04 02bf228 26,406 BA view · diff
git:20260904.bac959a2026-09-04 bac959a 26,152 BA view · diff
git:20260902.6f855a32026-09-02 6f855a3 24,900 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (69878 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_zbzbnadevrvodvpk
GET https://markdownregistry.com/api/v1/resolve?ref=guguzea/mc-ai-coding-assistant-tool/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/00e8d95e6678296266c7316c24df9b1c3c318904c8680314284bd7ae9e6c0ea1

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: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from guguzea/mc-ai-coding-assistant-tool

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
mc-addon-setup SKILL.md skill
guguzea/mc-ai-coding-assistant-tool · bedrock/.continue/skills/mc-addon-setup/SKILL.md · 基岩 Add-On 工程结构。触发词：com.mojang、development_behavior_packs、RP/BP、Add-On 从零
git:20260814.76af98c · audit A · 135 stars

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

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261102.920d634 · audit A · 433,876 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 314,583 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 299,696 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 199,595 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 185,249 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 144,492 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261107.ef99eb5 · audit A · 140,694 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20261106.e45976c · audit A · 118,366 stars

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