Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/yuque/yuque-mcp-server/agents-mdgit clone --depth 1 https://github.com/yuque/yuque-mcp-serverWrote 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/yuque/yuque-mcp-server/agents-md)<a href="https://agentmods.dev/instructions/yuque/yuque-mcp-server/agents-md"><img src="https://agentmods.dev/badge/instructions/yuque/yuque-mcp-server/agents-md.svg" alt="Measured on agentmods" 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 | $0.00714 | $0.00714 |
| Opus 5 | $0.00357 | $0.00357 |
| Sonnet 5 | $0.00143 | $0.00143 |
| Haiku 4.5 | $0.00071 | $0.00071 |
Grade A, and why
yuque-mcp-server 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 3d 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.
What it actually says
AGENTS.md
本文件提供当前仓库的协作约定。更通用的个人偏好仍遵循上层或全局 AGENTS.md。
项目定位
这是 yuque-mcp，一个把语雀 API 暴露为 MCP tools 的 Node.js / TypeScript 项目。MCP client 通过 tools/list 发现能力，通过 tools/call 调用语雀相关操作。
项目文档入口
维护或理解项目边界时，优先阅读 docs/ 下的文档：
- docs/README.md: 文档索引和维护约定。
- docs/technical-stack.md: 技术栈、配置、测试和发布链路。
- docs/core-architecture.md: 入口、分层、数据流和核心设计边界。
- docs/capability-scope.md: 当前 MCP public surface 和能力范围。
维护要求
- 改 MCP tool surface 时，同步更新
docs/capability-scope.md和tests/mcp/tool-registry-contract.test.ts。 - 改 CLI、transport、认证、host/base URL 解析或发布配置时，同步更新
docs/technical-stack.md。 - 改 server 分层、tool 注册、service API wrapper 或文档读写路径时，同步更新
docs/core-architecture.md。 - 当前代码和 contract tests 是 authoritative source（权威来源）；文档要跟随真实实现更新。
环境自举
- Fresh clone 后先执行
npm ci，再跑任何命令。 - 任何命令报
command not found，先跑npm ci再重试。 - Node 版本以
.nvmrc为准（CI 会覆盖 18/20/22/24）。
常用命令
npm run check # 质量门：lint + format:check + typecheck + test + build
npm run lint # 单跑 ESLint（src 和 tests）
npm run typecheck # 单跑 tsc --noEmit
npm test # 单跑全量测试，单次运行（watch 用 npm run test:watch）
- 完成的定义：
npm run check退出码为 0。提交前必须跑通，CI 跑的是同一条命令。 - 迭代期间跑单个测试文件更快：
npx vitest run tests/tools/doc.test.ts。 - CI 额外跑两个 dist smoke tests（
smoke:dist、smoke:pack-install）。 - Real API smoke tests 默认跳过，开启所需的环境变量见
docs/technical-stack.md。
标准工作流
执行常见变更前，先读 docs/workflows/ 下对应的步骤文档：
- 新增 MCP tool:
docs/workflows/add-tool.md（可先跑npm run new:tool -- <domain> <yuque_tool_name>生成骨架） - 修改现有 tool 参数或行为:
docs/workflows/modify-tool.md - 修复 bug:
docs/workflows/fix-bug.md
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.
- 3d ago First seen · 52 lines · 714 tokens per session scan A 7e87efed4cfb
yuque-mcp-server AGENTS.md is an instructions file published in the GitHub repository yuque/yuque-mcp-server (232 stars, last pushed 1mo ago), licensed MIT. It adds 714 tokens to every session, about $0.0036 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
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).
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.
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.
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.
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).
next.js AGENTS.md
Instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.