메뉴
定位 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）