cesium-mvt: Instructions file for Codex

AGENTS.md

cesium-mvt AGENTS.md is an instructions file for Codex, OpenCode from xiankq/cesium-mvt. It costs 685 tokens per session, scanned A, original, MIT.

A repository guide for the Cesium MVT project, which displays map data using Cesium and MapLibre concepts. It requires test-first development, also called TDD, where tests are written before implementation.

In plain words
What is it for?
Use it when implementing or fixing map-tile features, changing public APIs or data models, managing caches and GPU resources, or running the required checks.
Why use it?
It sets shared expectations for communication, project structure, naming, debugging, API changes, and verification.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md.

This is xiankq/cesium-mvt's own configuration. It tells Codex and OpenCode how to work on cesium-mvt 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 cesium-mvt configures →

Reuse

Borrowing it

Nothing to install: this file belongs to xiankq/cesium-mvt. 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/xiankq/cesium-mvt/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/xiankq/cesium-mvt

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 cesium-mvt AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/xiankq/cesium-mvt/agents-md.svg)](https://agentmods.dev/instructions/xiankq/cesium-mvt/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/xiankq/cesium-mvt/agents-md"><img src="https://agentmods.dev/badge/instructions/xiankq/cesium-mvt/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 685 This file is loaded in full into every session.
When invoked 685 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.00685 $0.00685
Opus 5 $0.00342 $0.00342
Sonnet 5 $0.00137 $0.00137
Haiku 4.5 $0.00068 $0.00068

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

Security

Grade A, and why

cesium-mvt 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 8d 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 · 49 lines

What it actually says

协作约定

1. 基本要求

  • 始终使用中文交流。
  • 任何实现都必须走 TDD 流程:先补会失败的测试,再改实现,最后补齐回归验证。
  • 文件、目录命名统一使用小写烤串式。
  • 优先使用仓库现有的技能、脚本和工具链,不重复造轮子。

2. 设计原则

  • 以生产标准为目标,不要为了迁就旧实现而新增兼容层。
  • 先确认根因,再做结构性修复,不要靠不断叠加判断兜底。
  • 不要把逻辑持续堆进单个大文件,优先拆成职责清晰的小模块。
  • 命名要语义清晰,避免过多定语修饰。
  • 对复杂代码补中文注释,说明原因、约束或关键思路,不解释显而易见的动作。
  • 不编写无意义的桥接函数、桥接类、桥接文件。
  • 一旦确认正确模型,就收敛到单一实现,不保留新旧双轨逻辑。
  • 优先复用 Cesium、MapLibre 及其子模块已经提供的能力、状态和语义,不重复实现已有机制。
  • CesiumVectorTile 的整体设计应尽量贴近 Cesium3DTileset 的 API 形态,同时参考 MapLibre 的 MVT 渲染流程。
  • 例如:
    • fromUrl 优先接收 Resource | string
    • 缓存策略既要参考 Cesium3DTileset,也要参考 MapLibre 的瓦片缓存与替换思路。
    • 分层渲染可以参考 MapLibre,但实现方式优先采用 Cesium 的语义和生命周期。
    • 具体行为上,先判断哪一边的语义更贴近当前目标,再决定,不要机械照搬其中任何一方。

3. 修改策略

  • 修复问题时优先解决根因,不要只修现场症状。
  • 不要盲改;如果无法稳定复现,先补测试或日志定位,再改实现。
  • 涉及缓存、生命周期、GPU 资源时,必须同时检查性能影响和内存泄漏风险。
  • 对外 API、数据模型和缓存语义的变更,必须同步更新测试和文档。

4. 测试与校验

  • 编写测试时,引用 src 目录必须使用 @/ 别名。
  • 新功能必须补测试。
  • 修复 bug 必须补对应回归测试,确保问题不会再次出现。
  • 修改代码后必须运行:
    • pnpm lint:eslint --fix
    • pnpm lint:tsc

5. 禁止事项

  • 不要为了“先跑起来”引入临时兼容代码。
  • 不要保留已经确认错误的数据模型。
  • 不要在没有验证的前提下持续叠加补丁。
  • 不要为了局部方便牺牲整体设计一致性。
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. 8d ago First seen · 49 lines · 685 tokens per session scan A d64d501280ae

Subscribe to this mod's changes

cesium-mvt AGENTS.md is an instructions file published in the GitHub repository xiankq/cesium-mvt (10 stars, last pushed 4mo ago), licensed MIT. It adds 685 tokens to every session, about $0.0034 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-31.

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