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.
mdr add avarce/codex-china-guide/templates/AGENTS.md@git:20260924.86b013ePins 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
mdr add avarce/codex-china-guide/templates/AGENTS.md@sha256:4588b82e282a8dfeThe 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.
[](https://markdownregistry.com/a/art_rwiwptlkdogc2shj)
1 badge image fetches in 30 days. What the badge shows.
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)
Installed this file, say at AGENTS.md? Drop it here to learn which saved version you have and what changed since. Your browser works out its SHA-256 fingerprint and sends only that; the file itself never leaves your computer.
Or paste its contents
Your agent can run this same check on the agent markdown files you have installed, up to 50 in one ask. Add the registry once:
claude mcp add --transport http markdownregistry https://markdownregistry.com/mcp/registry
Then ask it to check the files you have installed. No key and no account.
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
- 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
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.