Borrowing it
Nothing to install: this file belongs to liuzhengdongfortest/MA. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/liuzhengdongfortest/MA/main/AGENTS.mdgit clone --depth 1 https://github.com/liuzhengdongfortest/MAWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/liuzhengdongfortest/ma/agents-md)<a href="https://agentmods.dev/instructions/liuzhengdongfortest/ma/agents-md"><img src="https://agentmods.dev/badge/instructions/liuzhengdongfortest/ma/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/liuzhengdongfortest/ma/agents-md"><img src="https://agentmods.dev/badge/instructions/liuzhengdongfortest/ma/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.02228 | $0.02228 |
| Opus 5 | $0.01114 | $0.01114 |
| Sonnet 5 | $0.00446 | $0.00446 |
| Haiku 4.5 | $0.00223 | $0.00223 |
Grade A, and why
MA AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 80 lines — stays where its author put it; the contents beside it link to each section on GitHub.
March — 项目规则
架构中心
codestable/architecture/DESIGN.md 是整个项目的架构权威文档。
- 所有架构决策、模块划分、数据结构设计,必须能从
codestable/architecture/DESIGN.md的核心理念中追溯出来 - 子系统设计(file watcher、context builder、TUI 等)是
codestable/architecture/DESIGN.md思路的延伸,不是独立存在的 - 新增功能或改动方向前,先对照
codestable/architecture/DESIGN.md,确认与核心设计一致;若有冲突,先更新codestable/architecture/DESIGN.md,再动代码 - 子系统若有独立架构文档,放在
codestable/architecture/目录下,并在codestable/architecture/DESIGN.md中引用 - 不要在代码注释或其他文档里另起炉灶地描述架构——架构讨论的落点是
codestable/architecture/ - 注意区分:
codestable/architecture/*.md是项目级架构权威(长期存在,跨 feature 共享);codestable/features/{name}/design.md是单个 feature 的方案 doc(由 cs-feature 工作流产出,和同目录下的prd.md/acceptance.md聚合在一个 feature 目录,生命周期跟随这个 feature)。两者不是同一类文档,不要混 - 代码实现应保持较丰富的注释,优先解释设计意图、关键流程和不直观的实现细节。
UI 约定
- 按钮类功能在不影响可理解性的前提下,优先使用 Icon 实现,避免用文字按钮破坏界面密度与整体观感
UI 克制原则
界面默认要克制,不要往用户脸上堆说明文字。 具体落到几件事:
- 页面 / 区块的标题下面不要默认配一段解释性小字("这里放的是……"、"xx 用来管理……")。标题自己够说明白就不写;一定要说明的,优先用空状态文案、tooltip、或文档承接,不要塞在永久可见位置
- 已有配置项只渲染"能让用户认出这一项是谁"的最少信息,不要把协议 / URL / Key / 附加元数据全部铺在列表上。详情留给编辑态
- 列表项的右侧操作区优先用"整行 hover + 点击进入编辑"代替显式"编辑"按钮;只保留破坏性或次级动作(删除、复制等)
- 新增一个永久可见的文字块、badge、hint 前先问:没有它用户会不会真的用不明白?如果不会,就不加
- 同一页面里不要出现两段语义高度重叠的描述(比如面包屑级标题旁 + 侧栏顶部各写一句介绍)
视觉 Token 三层体系
样式走 primitive → semantic → component 三层 token,详见 codestable/architecture/design-system.md。写样式前先对照此文档,硬性规则:
- 组件 / utility class 里不准写 hex、rgb、rgba、
#xxx颜色字面量,也不准裸写除0以外的 px 间距 - 消费端(Vue 组件、Tailwind class、
@utility)只能引用 semantic 或 component 层 token,不能直接用 primitive(--color-gray-*、--color-error这类原子色) - 主题切换只重写 semantic 层;看到硬编码深色/浅色值(如
rgba(20,20,19,0.94)、border-white/8)就是 bug,要改成 semantic token - component 层 token 只在"semantic 组合不出来"时才新增,不要随手造
代码质量
- 前后端代码都要持续关注可维护性,避免把过多视图、状态、交互逻辑、业务流程、数据转换或基础设施细节堆进单个文件
- 当单个前端 Vue SFC / 模块,或后端 Rust 模块开始同时承担壳层、业务状态、弹窗流程、应用服务编排、provider 适配、存储读写、数据转换等多种职责时,应主动按职责边界拆分为组件、composable 或独立模块
- 拆分时优先按职责边界组织代码,避免只为”切文件”而切文件;拆出来的模块命名要清晰,接口要收敛
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 9d ago First seen · 80 lines · 2,228 tokens per session scan A 4e608fa52339
MA AGENTS.md is an instructions file published in the GitHub repository liuzhengdongfortest/MA (88 stars, last pushed 4mo ago), licensed MIT. It adds 2,228 tokens to every session, about $0.0111 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
codex AGENTS.md
AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
deepseek-harness AGENTS.md
AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.