agents-md-pro

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

AGENTS.md Pro

AGENTS.md Pro

Create token-efficient AGENTS.md files that maximize clarity with minimal tokens.
创建Token高效的AGENTS.md文件,用最少的Token实现最高的清晰度。

Core Principles

核心原则

  1. Token efficiency - Every word justifies its cost
  2. Commands over explanations - Show, don't tell
  3. Reference configs - Point to
    .eslintrc
    , never duplicate
  4. Model-agnostic - Universal terminology only
  5. Condensed default - Always minimal output
  1. Token效率 - 每个字词都物有所值
  2. 命令优先于解释 - 用示例展示,而非文字说明
  3. 引用配置文件 - 指向
    .eslintrc
    等配置,绝不重复内容
  4. 与模型无关 - 仅使用通用术语
  5. 默认精简输出 - 始终生成最精简的内容

Input

输入要求

Required: Project directory path If missing: Request from user
必填项: 项目目录路径 若缺失: 向用户索要

Workflow Router

工作流路由

Map user request to workflow:
  • Create → workflows.md
  • Optimize/condense → workflows.md
  • Update/refresh → workflows.md
  • Validate → workflows.md
将用户请求映射到对应工作流:
  • 新建 → workflows.md
  • 优化/精简 → workflows.md
  • 更新/刷新 → workflows.md
  • 验证 → workflows.md

Quick Reference

快速参考

Output template - Standard repo:
markdown
undefined
输出模板 - 标准代码仓库:
markdown
undefined

[Project] | [Tech Stack]

[Project] | [Tech Stack]

COMMANDS

COMMANDS

  • Dev:
    cmd
    | Build:
    cmd
    | Test:
    cmd
    | Lint:
    cmd --fix
  • Dev:
    cmd
    | Build:
    cmd
    | Test:
    cmd
    | Lint:
    cmd --fix

STRUCTURE

STRUCTURE

  • dir/
    - purpose
  • dir/
    - purpose

PATTERNS

PATTERNS

[1-2 key patterns with minimal code]
[1-2 key patterns with minimal code]

CODE STYLE

CODE STYLE

See
.eslintrc
,
.prettierrc
See
.eslintrc
,
.prettierrc

DOMAIN

DOMAIN

| Term | Definition |
| Term | Definition |

SECURITY

SECURITY

[Auth/validation only]
[Auth/validation only]

GIT

GIT

Format:
convention

**Line limits:**
- Standard: ≤150 lines
- Monorepo root: ≤50 lines
- Sub-project: ≤100 lines

**Target tokens:**
- Standard: 500-800
- Monorepo root: 300-400
- Sub-project: 400-600
Format:
convention

**行数限制:**
- 标准仓库:≤150行
- 单体仓库根目录:≤50行
- 子项目:≤100行

**目标Token数:**
- 标准仓库:500-800
- 单体仓库根目录:300-400
- 子项目:400-600

Resources

参考资源

Load as needed:
  • Workflows: workflows.md - All 4 workflows with step-by-step procedures
  • Optimization: optimization-patterns.md - Token reduction techniques
  • Validation: validation-rules.md - Quality checklist and scoring
  • Anti-patterns: anti-patterns.md - Common bloat patterns to avoid
根据需要加载:
  • 工作流workflows.md - 包含4种工作流的分步流程
  • 优化方案optimization-patterns.md - Token缩减技巧
  • 验证规则validation-rules.md - 质量检查清单和评分标准
  • 反模式anti-patterns.md - 需要避免的常见冗余模式