AGENTS.md@templatesA

AGENTS.md@templates from avarce/codex-china-guide is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add avarce/codex-china-guide/templates/AGENTS.md@git:20260924.86b013e

Pins git:20260924.86b013e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
avarce/codex-china-guide
Path
templates/AGENTS.md
Versions recorded
1
Latest version
git:20260924.86b013e, committed Sep 24, 2026
Size
2,605 bytes
Repository stars
68
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

# AGENTS.md

<!--
放在项目根目录。Codex 每次开工前会先读这个文件。
把尖括号 <> 里的内容换成你项目的实际情况;用不上的段落直接删掉。
写短一点、写具体一点:合起来默认最多读 32 KiB,超出部分会被截掉。
写好后验证:codex --ask-for-approval never "总结一下你当前加载了哪些说明"
-->

## 项目是做什么的

<一两句话:这是什么项目,给谁用。>

主要目录:

- `<src/>`:<业务代码>
- `<tests/>`:<测试>
- `<scripts/>`:<部署、数据处理脚本>

## 怎么跑起来

```bash
<安装依赖,例如:npm install>
<本地启动,例如:npm run dev>
```

- 装依赖用 `<npm / pnpm / uv / poetry>`,不要换成别的包管理器。
- 需要的环境变量写在 `<.env.example>` 里。**不要读取、打印或修改 `.env`。**

## 改完怎么检查

每次改完代码,按顺序跑下面的命令,全部通过再说「改好了」:

```bash
<格式和静态检查,例如:npm run lint>
<类型检查,例如:npm run typecheck>
<测试,例如:npm test>
```

- 没跑或跑不了,就直接说没跑,不要写「应该没问题」。
- 修 bug 先写一个能复现的测试,看它失败,再改代码让它通过。

## 写代码的规矩

- 只改和任务有关的文件。顺手看到的问题,列在最后告诉我,不要一起改。
- 跟着项目现有的写法走:命名、目录结构、错误处理方式和周围代码保持一致。
- 不要为了「以后可能用到」加抽象、配置项或新依赖。
- <项目特有的约定,例如:接口统一返回 { code, data, message }。>

## 先问我再做

下面这些事,先说明理由,等我确认:

- 安装新的依赖,或升级大版本
- 删除文件、目录
- 修改数据库结构、迁移文件
- 修改 CI、部署配置
- 任何会调用线上服务、发请求、花钱的操作

## 不要碰

- `<migrations/ 里已经上线的迁移文件>`
- `<自动生成的文件,例如 dist/、*.generated.ts>`
- `<第三方代码,例如 vendor/>`

## 回复方式

- 用简体中文回复;代码、命令、报错保留英文原文。
- 开工前用几句话说清楚打算改哪些文件、为什么。
- 做完列出:改了什么、怎么验证的、还有什么没做。

## Code Review Rules

<!-- 给 GitHub 上的 Codex 代码审查用。只写 CI 查不出来的问题。 -->

- <例如:金额一律用分(整数)计算,看到用浮点数算钱要指出来。>
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add avarce/codex-china-guide/templates/AGENTS.md@sha256:4588b82e282a8dfe

The line at the top of this page pins the label git:20260924.86b013e, 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_rwiwptlkdogc2shj.svg)](https://markdownregistry.com/a/art_rwiwptlkdogc2shj)

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

Ask from your agent
claude mcp add --transport http markdownregistry https://markdownregistry.com/mcp/registry

Then ask it: what changed in avarce/codex-china-guide/templates/AGENTS.md since the version I have? It reads every saved version here, no key and no account. Any agent that speaks MCP can add it.

Got a copy of AGENTS.md from somewhere else? Ask it: where did my AGENTS.md come from, and what was changed? It names the public original, the version yours is closest to and every changed line. The text is not kept.

Versions

The registry has recorded 1 version of this file, committed on Sep 24, 2026.

Watch this file (sign in, one email per new version)

versioncommittedcommitsizeaudit
git:20260924.86b013e latest2026-09-24 86b013e 2,605 BA view
Check a whole project

From the root of your project, one line hashes each installed skill's SKILL.md, your AGENTS.md and your CLAUDE.md, and asks the registry once. Only the fingerprints and paths are sent.

sha256sum .claude/skills/*/SKILL.md AGENTS.md CLAUDE.md | curl -s --data-binary @- https://markdownregistry.com/api/v1/check-copies

In CI, add --fail-with-body: the answer is 409 when any file is behind, so the step fails and still prints which files.

sha256sum .claude/skills/*/SKILL.md AGENTS.md CLAUDE.md | curl -s --fail-with-body --data-binary @- https://markdownregistry.com/api/v1/check-copies

No sha256sum on your machine? shasum -a 256 prints the same lines.

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 (2605 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

avarce/codex-china-guide · 68 stars · license a license file GitHub does not identify · pushed 2026-11-17 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_rwiwptlkdogc2shj
GET https://markdownregistry.com/api/v1/resolve?ref=avarce/codex-china-guide/templates/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/4588b82e282a8dfe529acb4b1370c06e76fe1e2937b8bb8eeffe2edf8abfc2b2

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.

Other files named AGENTS.md@templates

AGENTS.md@templates AGENTS.md file
rohitg00/pro-workflow · templates/AGENTS.md
git:20260328.7a5d201 · audit A · 2,964 stars
AGENTS.md@templates AGENTS.md file
mex-memory/mex · templates/AGENTS.md · Always-loaded project anchor. Read this first. Contains project identity, non-negotiables, commands, and pointer to…
git:20261011.bf46084 · audit A · 1,795 stars
AGENTS.md@templates AGENTS.md file
modoojunko/awesome-novel-agent · templates/AGENTS.md
git:20260828.0827fb7 · audit A · 880 stars
AGENTS.md@templates AGENTS.md file
niaka3dayo/agent-skills-vrc-udon · templates/AGENTS.md
git:20261110.1a52a0c · audit A · 369 stars
AGENTS.md@templates AGENTS.md file
ivanmurzak/godot-mcp · templates/AGENTS.md
git:20261017.26864a9 · audit A · 351 stars
AGENTS.md@templates AGENTS.md file
saksham10arora-dotcom/everything-claude-codex · templates/AGENTS.md
git:20261110.33c38ae · audit A · 96 stars
AGENTS.md@templates AGENTS.md file
crisandrews/clawcode · templates/AGENTS.md
git:20260913.24ad02a · audit A · 64 stars
AGENTS.md@templates AGENTS.md file
metaspartan/cybara · templates/AGENTS.md
git:20260131.fc29eb0 · audit A · 38 stars

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