AI 辅助开发

约 1571 字大约 5 分钟

2026-03-21

用 AI 编程工具大幅加速 Bot 开发 — 新手快速上手，资深用户利用 Skills 系统全流程提效。

选择你的 AI 编程工具

	Trae	VSCode + Copilot
官网	https://trae.cn	https://code.visualstudio.com
价格	免费	免费版可用 / 付费版更强
网络要求	🟢 中国大陆直连	🟡 需要稳定的国际网络
中文支持	原生中文界面	完整中文语言包
AI 能力	内置免费 AI 模型	GitHub Copilot 扩展
NcatBot Skills	❌ 需配置	✅ 完整支持
适合人群	新手、无科学上网条件	有网络条件的开发者

建议

新手 / 无科学上网：选 Trae，开箱即用
有网络条件 / 想用 NcatBot Skills：选 VSCode + Copilot
Cursor 也是不错的选择，功能与 VSCode + Copilot 类似，有独立付费计划

前置准备：获取用户参考手册

无论使用哪种 AI 编程工具，都必须先下载 用户参考手册，它包含示例代码、使用指南、领域技能和 API 参考。没有它，AI 无法正确理解 NcatBot 的架构和开发规范，也无法辅助开发。

ncatbot ref              # 交互式选择 IDE
ncatbot ref --vscode     # VSCode + Copilot
ncatbot ref --trae       # Trae（自动将 .agents 重命名为 .trae）
ncatbot ref --cursor     # Cursor

一键从 GitHub Releases 下载最新版用户参考手册并自动解压到当前目录（自动使用 GitHub 代理加速）。

也可以手动前往 GitHub Releases 页面，在最新版本的 Assets 中下载 ncatbot5-X.Y.Z-user-reference.zip，解压到你的项目根目录（与 config.yaml、plugins/ 同级）。

也可以从 QQ 交流群获取

加入 NcatBot 官方 QQ 交流群，在群文件中也可以下载最新的用户参考手册。群内还有开发者和活跃用户可以实时解答问题。

Trae 快速上手

安装

访问 https://trae.cn，下载安装包
安装后打开，界面与 VSCode 类似，原生中文
打开你的 NcatBot 项目文件夹（确保已解压用户参考手册）

使用 AI 对话

在右侧 AI 面板中直接用中文描述需求：

帮我写一个 NcatBot 插件，当收到群消息"天气"时，回复今天的天气信息

Trae 内置的 AI 会自动生成代码、创建文件、安装依赖。

模型	特点	推荐场景
Doubao-Seed-2.0-Code	代码专精	写代码、调试（推荐）
DeepSeek-V3.1-Terminus	综合能力强	需要分析、规划时
Qwen3-Coder-Next	阿里云代码模型	代码生成
GLM-5	智谱最新模型	中文理解
Kimi-K2.5	月之暗面模型	长文本分析

VSCode + GitHub Copilot

安装

下载 VSCode：https://code.visualstudio.com
安装中文语言包：扩展市场搜索 "Chinese (Simplified)"
安装 GitHub Copilot：扩展市场搜索 "GitHub Copilot"
登录 GitHub 账号激活

学生免费

GitHub 学生包（https://education.github.com）包含 Copilot Pro，凭学生邮箱即可申请。

Agent 模式

Copilot 的 Agent 模式可以像 Trae 一样自动执行多步操作：编辑文件、运行命令、安装依赖。在聊天面板中切换到 Agent 模式，用自然语言描述任务即可。

层级	推荐模型	说明
付费用户	Claude Opus 4.6	当前最强编程模型，复杂任务首选
免费用户	Claude Haiku 4.5	性价比高，日常开发够用

面向资深用户：NcatBot Skills 系统

什么是 Skills？

NcatBot 项目内置了一套 Skills 系统（.agents/skills/），这是专为 VSCode + Copilot 设计的领域知识包。Skills 让 AI 助手深度理解 NcatBot 的架构、API、开发规范，从而给出远比通用 AI 更精准的回答。

获取 Skills：下载用户参考手册

Skills 文件不随 pip 安装自动分发，你需要手动下载用户参考手册并解压到项目根目录

解压后你将获得以下目录结构：

your-project/
├── .agents/skills/          ← AI Agent 技能文件（Skills）
├── docs/
│   └── docs/
│       ├── examples/        ← 示例代码
│       └── notes/
│           ├── guide/       ← 使用指南
│           └── reference/   ← API 参考
├── config.yaml
└── plugins/

有了这些文件，VSCode 中的 Copilot Chat 就能自动识别 Skills，为你提供精准的代码建议。

VSCode：必须先解压再打开项目

必须先将用户参考手册解压到项目根目录（确保 .agents/skills/ 目录已就位），再用 VSCode 打开该项目，Skills 才会被自动加载。若先打开 VSCode 再解压，Skills 不会被识别，需关闭并重新打开项目窗口。

Trae：需将 .agents 重命名为 .trae

Trae 不识别 .agents 目录，使用 Skills 前须将项目根目录下的 .agents 重命名为 .trae，Trae 才能正确加载其中的技能文件。

可用 Skills 清单

Skill	功能	典型提问
framework-usage	用框架开发 Bot	"帮我写一个群消息回复插件"
testing-framework	写插件测试	"帮这个插件写单元测试"
docs-maintenance	维护文档	"更新这个 API 的文档"
plugin-migration	插件升级 4→5	"把这个旧插件迁移到 v5"
code-nav	定位代码实现	"Dispatcher 的代码在哪？"
codebase-nav	导航代码库	"这个报错是哪个模块的问题？"
doc-nav	查阅文档	"Hook 系统怎么用？"
testing-design	设计测试策略	"这个功能应该写什么测试？"

如何触发 Skills

在 VSCode 中使用 Copilot 聊天时，Skills 会根据你的提问自动匹配。你也可以显式引用：

用 framework-usage 技能帮我写一个定时任务插件

Skills 快速开发流程

资深用户的典型开发循环：

1. 需求 → framework-usage 生成插件骨架
2. 编码 → Copilot Agent 模式辅助实现
3. 测试 → testing-framework 自动生成测试
4. 文档 → docs-maintenance 同步更新文档

这个流程可以将一个完整插件的开发时间从数小时缩短到几十分钟。

版权所有

版权归属：MI

许可证：署名 4.0 国际 (CC-BY-4.0)

通用

QQ

Bilibili

GitHub

通用

QQ