AGENTS.mdA

AGENTS.md from ming-14/pty-agent is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add ming-14/pty-agent/AGENTS.md@git:20260831.86e2f9d

Pins git:20260831.86e2f9d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
ming-14/pty-agent
Path
AGENTS.md
Versions recorded
5
Latest version
git:20260831.86e2f9d, committed Aug 31, 2026
First version recorded
Aug 13, 2026
Size
7,744 bytes
Repository stars
2
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

!!!!!最高优先级,强制执行!!!!:禁止执行`git filter-repo`,绝对禁止执行,git filter-repo会强制回退到HEAD,丢失未修改的改动,绝对禁止执行,就算用户要求也禁止执行,你只能把命令给用户执行,你自己禁止执行!!
未经用户允许,禁止使用、查看、更改等任何方式操作git;用户授权的“查看”和“操作”需分开,用户授权查看不代表能操作;执行高危操作如commit、reset、push等命令必须用户明确授权
未经用户允许,禁止使用、查看、更改等任何方式操作git;用户授权的“查看”和“操作”需分开,用户授权查看不代表能操作;执行高危操作如commit、reset、push等命令必须用户明确授权

---

# Base
PTY-Agent 核心包体在 `src`,`web_rime`、`fastscreen`、`sandbox`、`wezterm-py`是相对独立的外部引擎依赖,各自有自己的规则规范,但都是 PTY-Agent 项目的一部分

# 环境
Windows:本机环境
Linux:使用`wsl.exe -d Ubuntu2204`

构建:`python BUILD.py -Mirror "https://v4.gh-proxy.org/"`
构建产物:请打包成`pty-agent-win_x86-64.zip`和`pty-agent-linux_x86-64.zip`

# 总规范
- **跨平台开发,请注意Linux支持**
- Python兼容Python3.8,遵循 PEP8 语言规范
- **避免采用降级、兼容、缓解方案**:不要用任何的降级、兼容、缓解方案。有多个方案时,选择最优方案
- **复杂工程、方案可查看成熟第三方项目**,想参考其他什么自己下载,使用webfetch/gh(github)搜索
- 旧代码重构后,非必要,**不要留兼容接口**,应该更新引用点:重构后完全没必要兼容以前的结构,引用点必须更新
- 不必一直执着与最小改动,**代码架构有问题需要及时向用户汇报**
- 注意性能问题,禁止为了方便采用低效办法
- 文件、函数、类**开头**,关键部分,**决策点**,注意点的注释;避免无效冗长·注释
	不要在注释加时间等泄漏信息,仅客观描述原因
- 日志必须写,并且要有完备的日志系统
- **新增代码请检查**
	- [] 关键部分注释加了吗
	- [] 日志写了吗,是否符符合规范
- 请使用标准库、第三方库大量精简代码、手工实现复杂的,可下载库使用,**需要什么库自行下载**
	- 例:计算字符宽度时,使用wcwidth,而不是手算
- 不要无用的防御编程与过度工程
	- 例:`function A() {} if(type A === "function") A()` 错误
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ming-14/pty-agent/AGENTS.md@sha256:a42b8309fc638710

The line at the top of this page pins the label git:20260831.86e2f9d, 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_c3u3iotmhwlwnoux.svg)](https://markdownregistry.com/a/art_c3u3iotmhwlwnoux)

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

Versions

The registry has recorded 5 versions of this file, between Aug 13, 2026 and Aug 31, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
git:20260831.86e2f9d latest2026-08-31 86e2f9d 7,744 BA view · diff
git:20260817.52eb6092026-08-17 52eb609 7,464 BA view · diff
git:20260816.19a70b32026-08-16 19a70b3 7,214 BA view · diff
git:20260814.15c7f512026-08-14 15c7f51 10,090 BA view · diff
git:20260813.27ac01b2026-08-13 27ac01b 10,025 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 (7744 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

ming-14/pty-agent · 2 stars · license MIT · pushed 2026-10-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_c3u3iotmhwlwnoux
GET https://markdownregistry.com/api/v1/resolve?ref=ming-14/pty-agent/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/a42b8309fc6387104b7435a5c24ecaf19073ecf2cd79c5f51774d24231a3e87e

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 ming-14/pty-agent

doc-expert SKILL.md skill
ming-14/pty-agent · .agents/skills/doc-expert/SKILL.md · Professional technical documentation expert for creating PRDs, BRDs, HLDs, LLDs, TDDs, and technical solution…
git:20260813.54394c9 · audit A · 2 stars
download-by-mirror SKILL.md skill
ming-14/pty-agent · .agents/skills/download-by-mirror/SKILL.md · Used when downloading resources from **GitHub**, **npm/pnpm**, **pip**, **WinGet**, **apt**, **DockerHub**, **Maven**…
git:20260730.661123e · audit A · 2 stars
python-win32api SKILL.md skill
ming-14/pty-agent · .agents/skills/python-win32api/SKILL.md · When calling complex Win32 APIs from Python, you should first write the corresponding C++ program, verify it step by…
git:20260730.661123e · audit A · 2 stars
windows-debugging SKILL.md skill
ming-14/pty-agent · .agents/skills/windows-debugging/SKILL.md · Use the local Windows Debugging Tools (cdb / kd / adplus / umdh / dumpchk) bundled under…
git:20260813.54394c9 · audit A · 2 stars
pty-agent SKILL.md skill
ming-14/pty-agent · SKILL.md · Interactive CLI program proxy via pseudo-terminal (PTY). Use when: (1) must maintain ongoing dialog with interactive…
git:20260831.edadd30 · audit F · 2 stars
AGENTS.md@config/plugins AGENTS.md file
ming-14/pty-agent · config/plugins/AGENTS.md
git:20260831.86e2f9d · audit A · 2 stars
AGENTS.md@src/web AGENTS.md file
ming-14/pty-agent · src/web/AGENTS.md
git:20260825.a54da80 · audit B · 2 stars

Every file in ming-14/pty-agent

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.