nanzi-ai-agent-platform: Instructions file for Codex

AGENTS.md

nanzi-ai-agent-platform AGENTS.md is an instructions file for Codex, OpenCode from RandyChen1985/nanzi-ai-agent-platform. It costs 831 tokens per session, scanned A, original, MIT.

Repository instructions for nanzi-ai-agent-platform, an AI application platform built with Python, Vue, databases, Redis, and AgentScope. They also define project communication, testing, permissions, deployment, and Git rules.

In plain words
What is it for?
Implementing backend and frontend changes, handling database migrations, running approved tests, managing skills and permissions, and keeping development branches synchronized.
Why use it?
They clarify the platform's technical boundaries and prevent an AI assistant from using the wrong tools, changing databases directly, or performing restricted operations.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: built for openclaw.

This is RandyChen1985/nanzi-ai-agent-platform's own configuration. It tells Codex and OpenCode how to work on nanzi-ai-agent-platform itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything nanzi-ai-agent-platform configures →

Reuse

Borrowing it

Nothing to install: this file belongs to RandyChen1985/nanzi-ai-agent-platform. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/RandyChen1985/nanzi-ai-agent-platform/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/RandyChen1985/nanzi-ai-agent-platform

Made for: Codex, OpenCode.

Wrote 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.

agentmods badge for nanzi-ai-agent-platform AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/randychen1985/nanzi-ai-agent-platform/agents-md.svg)](https://agentmods.dev/instructions/randychen1985/nanzi-ai-agent-platform/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/randychen1985/nanzi-ai-agent-platform/agents-md"><img src="https://agentmods.dev/badge/instructions/randychen1985/nanzi-ai-agent-platform/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 831 This file is loaded in full into every session.
When invoked 831 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00831 $0.00831
Opus 5 $0.00415 $0.00415
Sonnet 5 $0.00166 $0.00166
Haiku 4.5 $0.00083 $0.00083

Measured 4d ago against content hash 46261821c934, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

nanzi-ai-agent-platform 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 4d 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.

AGENTS.md · 38 lines

What it actually says

交流语言

  • 始终使用中文交流,包括中间过程中的推理与思考,以及所有回复、汇报与文档说明。所有说明请优先用中文。与用户沟通、解释、总结时一律使用中文。

项目技术栈与关键边界

  • 运行时:Python 3.11;Docker 基础镜像为 python:3.11-slim。禁止使用仅 Python 3.12+ 支持的语法。
  • 后端:FastAPI + Uvicorn + SQLAlchemy 2.x 异步 ORM + Pydantic 2。
  • 前端:Vue 3 + TypeScript + Vite 7 + Tailwind CSS 3,按现有 Vue 工程实现,不引入 React 方向的方案。
  • AI 编排:AgentScope 2.x 是主运行时;OpenClaw、RAGFlow、MCP 是独立集成边界。修改路由或执行链前,先追踪 router、dispatcher、runner、tool 和权限预检。
  • 数据库:平台主库默认 MySQL,也支持 PostgreSQL。MySQL 使用 db-prod/,PostgreSQL 使用 db-prod-pg/,两套迁移不可混用;平台主库与外部数据源支持必须分开处理。
  • Redis:Redis Stack/RediSearch 是平台运行依赖。
  • 权限menu:* 控制菜单显示,element:* 控制具体功能。平台技能管理和待审核使用 element:skills:admin
  • 测试:后端使用 pytest;纯前端契约测试使用 pytest --confcutdir=tests/frontend,前端类型检查使用 vue-tsc --noEmit
  • 数据库变更:只新增对应版本的迁移 SQL,不直接修改本地或线上数据库。
  • 执行边界:Agent 不主动执行 ./dev.sh、部署脚本或生产数据库操作;服务启停和部署由用户在控制台执行。

Git 协作:用户说「代码已合」

用户表示 PR/代码已合并后,必须立即执行本地 git 同步,不要只口头确认:

  1. git fetch origin
  2. git checkout main && git pull origin main
  3. git checkout dev-agentscope && git merge main(或 git rebase main,以 DEVELOPMENT.md 为准)
  4. git push origin dev-agentscope(若本地领先远程)
  5. 汇报:main / dev-agentscope 最新 commit、是否与远程一致
  6. 提醒用户自行在控制台执行 ./dev.sh(Agent 代跑)

不要在用户未要求时擅自创建 PR 或 force push。

Git 协作:创建 / 更新 Pull Request

用户要求创建或更新 PR 时,必须按仓库根目录 PULL_REQUEST_TEMPLATE.md 填写标题与正文(概要、核心变更、表结构变更清单、Commit Log、测试覆盖、备注),不要使用默认的 Summary/Test plan 两段式。提交前同步更新 tests/CHECKLIST.md,并在 PR 中注明。

开发环境服务启停

任何场景下均严禁主动或自动运行 ./dev.sh 等编译、部署与启动脚本(包括用户说「代码已合」时)。所有的服务编译、启停和重启测试均需交由用户在控制台手动操作。修改完毕或同步完成后,Agent 仅负责通知用户代码/分支已就绪,并提醒用户自行执行 ./dev.sh

Changes

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.

  1. 4d ago Changed · +7 tokens per session 46261821c934
  2. 8d ago First seen · 38 lines · 824 tokens per session scan A 2ca55a5b9274

Subscribe to this mod's changes

nanzi-ai-agent-platform AGENTS.md is an instructions file published in the GitHub repository RandyChen1985/nanzi-ai-agent-platform (164 stars, last pushed today), licensed MIT. It adds 831 tokens to every session, about $0.0042 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.

Related

Other instructions, from other repositories

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.

openai/codex · 5,153 tokens

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).

microsoft/vscode · 6,785 tokens

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.

vercel/next.js · 7,296 tokens

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.

langchain-ai/langchain · 4,469 tokens

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).

microsoft/vscode · 5,001 tokens

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,104 tokens