mcp-server copilot-instructions.md

Development instructions for CloudBase AI, Tencent Cloud’s development platform. They tell an AI agent to identify the project type and consult the matching rule files before coding.

In plain words
What is it for?
They guide work on CloudBase web projects, WeChat mini-programs, database features, and user interfaces. They also cover reading the project instructions, authentication, deployment order, real-time data, and version checks.
Why use it?
They reduce mistakes caused by applying the wrong guidance to web apps, WeChat mini-programs, databases, or interface design. They also define when to confirm the plan and which CloudBase tools to prefer.

Instructions file for GitHub Copilot

Install

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.

agentmods
npx agentmods add instructions/tencentcloudcommunity/mcp-server/copilot-instructions
Clone the repo
git clone --depth 1 https://github.com/TencentCloudCommunity/mcp-server

Made for: GitHub Copilot.

Per session 2,482 This file is loaded in full into every session.
When invoked 2,482 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
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 $0.02482 $0.02482
Opus 5 $0.01241 $0.01241
Sonnet 5 $0.00496 $0.00496
Haiku 4.5 $0.00248 $0.00248

Measured 2d ago against content hash 75ee98cacd57, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

mcp-server copilot-instructions.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 2d 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.

src/CloudBase-AI-ToolKit/config/.github/copilot-instructions.md · 198 lines

How it starts

The opening of the file, as written. The whole thing — 198 lines — stays where its author put it; the contents beside it link to each section on GitHub.


cloudbaseAIVersion:1.8.28 description: CloudBase AI 开发规则指南 - 提供场景化的最佳实践,确保开发质量 globs: * alwaysApply: true

📋 CloudBase AI 开发规则指南

🎯 开发流程规范 - 场景识别与最佳实践

重要:为确保开发质量,AI 需要在开始工作前完成以下步骤:

1. 场景识别

首先需要识别当前的开发场景类型:

  • Web 项目:React/Vue/原生 JS 等前端项目
  • 微信小程序:小程序云开发项目
  • 数据库相关:涉及数据操作的项目
  • UI 设计:需要界面设计的项目

2. 规则文件选择

根据识别的场景,需要参考对应的专业规则文件:

📋 场景规则映射表(必须遵守):

  • Web 项目 → 必读:rules/web-development.mdc + rules/cloudbase-platform.mdc
  • 微信小程序 → 必读:rules/miniprogram-development.mdc + rules/cloudbase-platform.mdc
  • 数据库操作 → 额外读:rules/database.mdc
  • UI 设计 → 额外读:rules/ui-design.mdc

3. 开发确认

在开始工作前建议向用户确认:

  1. "我识别这是一个 [场景类型] 项目"
  2. "我将严格遵循以下规则文件:[具体文件列表]"
  3. "请确认我的理解是否正确"

核心行为规则

  1. 工具优先:关于腾讯云开发的操作,优先使用 cloudbase 的 MCP 工具
  2. 项目理解:首先阅读当前项目的 README.md,遵照项目说明开发
  3. 目录规范:在当前目录下产出项目代码,先检查当前目录文件
  4. 部署顺序:有后端依赖时,优先部署后端再预览前端
  5. 交互确认:需求不明确时使用 interactiveDialog 澄清,执行高风险操作前必须确认
  6. 实时通信:使用云开发的实时数据库 watch 能力
  7. 认证规则:严格区分平台的认证方式
    • Web 项目:必须使用 CloudBase Web SDK 内置认证(如 auth.toDefaultLoginPage()
    • 小程序项目:天然免登录,云函数中获取 wxContext.OPENID

版本检测和升级约束

自动版本检测

  • 当用户使用 CloudBase 相关功能时,AI Agent 应自动检查当前项目的 cloudbaseAIVersion 字段
  • 通过 npm registry API 查询 @cloudbase/cloudbase-mcp 的最新版本
  • 比较版本差异,如果发现新版本可用,主动向用户提示升级建议
  • 首次使用时显示友好的欢迎信息和当前版本

升级指导流程

工作流

Workflow 命令控制

可用命令:

  • 默认 - AI 根据任务复杂度智能判断
  • /spec - 强制使用完整 spec 流程
  • /no_spec - 跳过 spec 流程,直接执行
  • /help - 显示命令帮助

智能判断标准:

  • 使用 spec:新功能开发、复杂架构设计、多模块集成、涉及数据库/UI设计
  • 跳过 spec:简单修复、文档更新、配置修改、代码重构

<spec_workflow> 0. 请注意!必须遵守以下的规则,每个环节完成后都需要由我进行确认后才可进行下一个环节;

  1. 如果你判断我的输入提出的是一个新需求,可以按照下面的标准软件工程的方式独立开展工作,需要时才向我询问,可以采用 interactiveDialog 工具来收集
  2. 每当我输入新的需求的时候,为了规范需求质量和验收标准,你首先会搞清楚问题和需求,然后再进入下一阶段
  3. 需求文档和验收标准设计:首先完成需求的设计,按照 EARS 简易需求语法方法来描述,如果你判断需求涉及到前端页面,也可在需求中提前确定好设计风格和配色等,跟我进行确认需求细节,最终确认清楚后,需求定稿,然后再进入下一阶段,保存在 specs/spec_name/requirements.md 中,参考格式如下

Read the full file on GitHub · 198 lines

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. 2d ago First seen · 198 lines · 2,482 tokens per session scan A 75ee98cacd57

Subscribe to this mod's changes

mcp-server copilot-instructions.md is an instructions file published in the GitHub repository TencentCloudCommunity/mcp-server (28 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 2,482 tokens to every session, about $0.0124 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.