القائمة
定位 NcatBot 代码实现：锁定模块目录、找到关键类/函数、追踪调用链。当文档不够时才读代码，用搜索而非遍历。Use when: 找代码实现、哪个文件、哪个类、追踪调用链、定位 bug 行号、代码在哪、模块目录、源码定位。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
通过文档理解 NcatBot 项目：查阅功能说明、API 签名、架构设计、预期行为。文档优先，按优先级分层查阅。Use when: 理解功能、查 API、架构理解、预期行为、怎么用、设计决策、模块职责、文档在哪。
维护 NcatBot 项目文档、示例、Skills 知识资产。编写/编辑文档、修复文档问题、文档结构规范审查。Use when: 写文档、改文档、新增文档、修复断链、修复索引、修复代码块标注、文档规范、文档模板、文档结构设计、docs maintenance。
整体/局部防腐检查：Docs 内部链接断裂、README 索引不同步、guide↔reference 内容不一致、examples 导入过时、Code↔Docs API 对齐。逐文件检查，最大化并发 subagent。Use when: docs 防腐、docs 链接、docs 断链、断链检查、docs 审计、docs audit、code docs 对齐、reference 过时、guide reference 不同步、examples 检查、定期检查。
开发与维护 NcatBot 框架本体。调试 bug、开发新功能、维护 Skill、代码审查、重构。Use when: 框架调试、debug、fix bug、feat、新功能、Skill 维护、代码贡献、模块修改、代码审查、重构。
使用 NcatBot 框架开发 QQ 机器人或跨平台 Bot。当用户需要快速体验、创建插件、注册事件处理、发送消息、调用 Bot API、使用 Mixin/Hook、使用 CLI 工具、编写插件测试、或调试运行问题时触发此技能。Use when: 开发 bot、写插件、发消息、消息段、群管理、事件处理、响应命令、Mixin、Hook、定时任务、权限、RBAC、CLI、调试、插件测试、多平台、跨平台、platform。
将 NcatBot 4.4/4.5 版本插件迁移到 5.0。包括导入路径、注册方式、Config/Data API、事件类型、消息构造的全面映射。Use when: 迁移插件、升级插件、4 转 5、老版本、旧版本、migration、upgrade、plugin migration、版本升级。
| name | code-nav |
| description | 定位 NcatBot 代码实现：锁定模块目录、找到关键类/函数、追踪调用链。当文档不够时才读代码，用搜索而非遍历。Use when: 找代码实现、哪个文件、哪个类、追踪调用链、定位 bug 行号、代码在哪、模块目录、源码定位。 |
根据已知的模块名称或类名，精准定位到 NcatBot 框架中的具体代码文件和关键类/函数。
核心原则：只在文档无法回答时才读代码。用搜索定位，不遍历模块。
如果还不知道涉及哪个模块，先使用 doc-nav 技能通过文档确定。
1. 锁定模块（从模块速查表确定目录）
→ 2. 精准定位（搜索关键类名/函数名）
→ 3. 输出（文件路径 + 类名 + 职责）
通过 doc-nav 或已有信息，你应该已经知道涉及哪个模块。对照速查表锁定到具体目录：
| 模块 | 代码位置 | 核心类/文件 |
|---|---|---|
| 应用编排 | ncatbot/app/ | BotClient |
| 事件分发 | ncatbot/core/dispatcher/ | AsyncEventDispatcher |
| Handler 注册 | ncatbot/core/registry/ | HandlerDispatcher, Registrar |
| 插件基类 | ncatbot/plugin/ | NcatBotPlugin, BasePlugin |
| 插件加载 | ncatbot/plugin/loader/ | PluginLoader, PluginIndexer |
| Bot API | ncatbot/api/ | BotAPIClient, IAPIClient, MiscAPI |
| 事件模型 | ncatbot/event/ | MessageEvent, NoticeEvent, RequestEvent |
| 类型定义 | ncatbot/types/ | Pydantic 数据模型 |
| 服务管理 | ncatbot/service/ | ServiceManager |
| 测试框架 | ncatbot/testing/ | TestHarness |
完整模块映射表（含所有子模块）：references/module-code-map.md
只有当文档无法回答以下问题时，才读源代码：
事件处理入站/出站链路参考：references/event-chains.md
定位完成后，向用户提供：
ncatbot/core/dispatcher/dispatcher.py）