AGENTS.mdA

AGENTS.md from lizhiyao/oh-my-knowledge is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add lizhiyao/oh-my-knowledge/AGENTS.md@git:20261013.3658fc9

Pins git:20261013.3658fc9 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
lizhiyao/oh-my-knowledge
Path
AGENTS.md
Versions recorded
21
Latest version
git:20261013.3658fc9, committed Oct 13, 2026
First version recorded
Sep 2, 2026
Size
12,100 bytes
Repository stars
23
License
MIT

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 - OMK 项目约定

本文件与各目录的领域 `AGENTS.md` 只维护中文:它们是被 Agent 按路径加载的指令来源,不存在英文版,也不做双语副本(GitHub 与各工具都只认 `AGENTS.md` 这一个文件名)。人类贡献者的流程入口是 [CONTRIBUTING.md](./CONTRIBUTING.md),其正文在文档站,中英两版都有。

OMK(Observe. Measure. Know.)通过固定模型、改变知识载体,观测和测量 prompt、RAG、skill、agent、workflow 的版本差异。所有改动优先保护测量可比性、证据完整性和用户数据。

本文件是工具中立的项目入场清单。Claude Code 通过 CLAUDE.md import;不为不同工具复制维护第二份项目规则。

## 开工与交付

- 涉及 commit、PR、分支或发版时,读取 CONTRIBUTING.md 的相关流程;同一任务已读且未变化时复用。
- 修改子目录前,检查从仓库根到目标文件路径上的 AGENTS.md,最近的文件补充或覆盖上层项目约定;普通局部任务不遍历全仓规则。
- 开工简述需求、非目标、受影响边界和风险,低风险改动一两句即可;当前任务已明确方向即按已有授权连续推进,不在实现、验证、自主 CR 等常规步骤间反复询问下一步。
- 用户已授权 OMK 改造的默认交付链:自主完成实现、验证、自主 CR、提交、推送、创建 PR,并在相关门禁和远端 CI 通过、审查问题按完成定义处理后合并到 main,无需逐次确认提交、PR 或合并。此授权适用于当前及后续改造任务;用户对具体任务的只读、仅本地、不提交或不合并等明确限制优先。
- 发版仍需单独授权,不将合并等同于发布授权。默认交付授权不扩大需求范围,也不绕过公共契约/存量数据变更的确认要求、平台审批、仓库保护或其他高影响操作的授权边界。
- 默认直接替换旧实现,不为没有明确需求的旧入口、旧字段或旧行为保留兼容层、别名和双轨分支。涉及已发布的公共契约或存量数据时,先说明影响与替换/迁移方案,向用户确认后执行,不自行决定兼容,也不直接做破坏性替换;当前任务已有明确决定时不重复确认。必要的破坏性变更仍须遵守下述版本化与迁移要求。
- 长任务及时更新对应 Issue/PR 的已有执行清单,状态以实际完成情况为准。
- 测试维护同时做加法和减法:新增或迁移测试时,审视受影响的既有用例,删除失效或仅绑定已替换实现细节的断言,合并重复覆盖,优先复用、改写现有测试;不以用例数量增长代表质量提升,也不为减少数量牺牲关键行为与失败路径的覆盖。
- clean-room 验收只在发布、打包/安装契约变化、真实用户入口变化或风险审查明确要求时执行;触发条件、被测边界与证据未变化时不重复执行。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add lizhiyao/oh-my-knowledge/AGENTS.md@sha256:3e7f846f43e5552d

The line at the top of this page pins the label git:20261013.3658fc9, 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_673oio5xn4e6rtbx.svg)](https://markdownregistry.com/a/art_673oio5xn4e6rtbx)

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

Versions

The registry has recorded 21 versions of this file, between Sep 2, 2026 and Oct 13, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20261013.3658fc9 latest2026-10-13 3658fc9 12,100 BA view · diff
git:20260922.f8b3ea62026-09-22 f8b3ea6 12,093 BA view · diff
git:20260922.fd5280b2026-09-22 fd5280b 11,749 BA view · diff
git:20260921.04086f02026-09-21 04086f0 11,709 BA view · diff
git:20260921.791cb572026-09-21 791cb57 11,219 BA view · diff
git:20260921.64265672026-09-21 6426567 10,953 BA view · diff
git:20260919.cc8fc492026-09-19 cc8fc49 9,713 BA view · diff
git:20260919.712979b2026-09-19 712979b 9,510 BA view · diff
git:20260915.6b39ada2026-09-15 6b39ada 9,401 BA view · diff
git:20260914.f6dc5552026-09-14 f6dc555 9,241 BA view · diff
git:20260914.8826e8a2026-09-14 8826e8a 9,020 BA view · diff
git:20260913.7b88b622026-09-13 7b88b62 7,947 BA view · diff
git:20260912.03eb64d2026-09-12 03eb64d 7,706 BA view · diff
git:20260910.256ad8e2026-09-10 256ad8e 7,152 BA view · diff
git:20260909.7a703fe2026-09-09 7a703fe 6,825 BA view · diff
git:20260908.724d6b62026-09-08 724d6b6 6,003 BA view · diff
git:20260905.397eab12026-09-05 397eab1 9,218 BA view · diff
git:20260904.2b88c8f2026-09-04 2b88c8f 9,048 BA view · diff
git:20260904.782bc512026-09-04 782bc51 8,081 BA view · diff
git:20260903.08c59f32026-09-03 08c59f3 7,060 BA view · diff
git:20260902.05d1a1c2026-09-02 05d1a1c 7,270 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 (12100 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

lizhiyao/oh-my-knowledge · 23 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_673oio5xn4e6rtbx
GET https://markdownregistry.com/api/v1/resolve?ref=lizhiyao/oh-my-knowledge/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/3e7f846f43e5552dbe099ec857a490ed784f78a787d8a9a03d128eec8ac43582

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 lizhiyao/oh-my-knowledge

omk SKILL.md skill
lizhiyao/oh-my-knowledge · .agents/skills/omk/SKILL.md · OMK(Observe. Measure. Know.)让 AI 应用的知识改动有据可依。观测真实表现,受控测量 prompt / RAG / skill / agent / workflow…
git:20261015.c1b712b · audit A · 23 stars
CLAUDE.md CLAUDE.md file
lizhiyao/oh-my-knowledge · CLAUDE.md
git:20260516.8539e80 · audit A · 23 stars
DESIGN.md DESIGN.md file
lizhiyao/oh-my-knowledge · DESIGN.md · Studio 当前实现的设计基线;品牌紫与专注阅读贯通外壳、观测列表、知识工作台和有明确证据边界的评测报告。
git:20261014.fed88aa · audit B · 23 stars
repo-answerer SKILL.md skill
lizhiyao/oh-my-knowledge · examples/agent-runtime/skills/repo-answerer/SKILL.md · Minimal repository answerer used as the control variant.
git:20260902.c0ab3ed · audit A · 23 stars
repo-navigator SKILL.md skill
lizhiyao/oh-my-knowledge · examples/agent-runtime/skills/repo-navigator/SKILL.md · Repository navigation skill for project-level runtime context.
git:20260619.dd3bb69 · audit A · 23 stars
echo-assistant SKILL.md skill
lizhiyao/oh-my-knowledge · examples/custom-executor/skills/echo-assistant/SKILL.md · Minimal skill used to demonstrate the custom executor protocol.
git:20260619.dd3bb69 · audit B · 23 stars
context-answerer SKILL.md skill
lizhiyao/oh-my-knowledge · examples/rag-eval/skills/context-answerer/SKILL.md · Minimal context answerer used as the control variant.
git:20260902.c0ab3ed · audit B · 23 stars
rag-answerer SKILL.md skill
lizhiyao/oh-my-knowledge · examples/rag-eval/skills/rag-answerer/SKILL.md · RAG answerer that only answers from supplied context.
git:20260619.dd3bb69 · audit A · 23 stars
release-checklist SKILL.md skill
lizhiyao/oh-my-knowledge · examples/skill-map-showcase/skills/release-checklist/SKILL.md · Minimal release checklist used as the control variant.
git:20260902.c0ab3ed · audit A · 23 stars
release-readiness SKILL.md skill
lizhiyao/oh-my-knowledge · examples/skill-map-showcase/skills/release-readiness/SKILL.md · Release readiness reviewer that turns a skill folder into a visible Skill Map.
git:20260619.dd3bb69 · audit A · 23 stars
AGENTS.md@src/cli AGENTS.md file
lizhiyao/oh-my-knowledge · src/cli/AGENTS.md
git:20260903.08c59f3 · audit A · 23 stars
AGENTS.md@src/eval-core AGENTS.md file
lizhiyao/oh-my-knowledge · src/eval-core/AGENTS.md
git:20260903.08c59f3 · audit A · 23 stars

Every file in lizhiyao/oh-my-knowledge

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261015.0e1f0bf · audit A · 352,890 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 302,424 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261011.412347a · audit A · 284,510 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 193,096 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 170,980 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261011.5d64745 · audit A · 136,966 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 129,649 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 113,780 stars

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