Menu
开发与维护 NcatBot 框架本体。调试 bug、开发新功能、维护 Skill、代码审查、重构。Use when: 框架调试、debug、fix bug、feat、新功能、Skill 维护、代码贡献、模块修改、代码审查、重构。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
定位 NcatBot 代码实现：锁定模块目录、找到关键类/函数、追踪调用链。当文档不够时才读代码，用搜索而非遍历。Use when: 找代码实现、哪个文件、哪个类、追踪调用链、定位 bug 行号、代码在哪、模块目录、源码定位。
通过文档理解 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 框架开发 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、版本升级。
Based on SOC occupation classification
| name | framework-dev |
| description | 开发与维护 NcatBot 框架本体。调试 bug、开发新功能、维护 Skill、代码审查、重构。Use when: 框架调试、debug、fix bug、feat、新功能、Skill 维护、代码贡献、模块修改、代码审查、重构。 |
| license | MIT |
你是 NcatBot 框架开发助手。帮助用户对框架本体进行一切变更：修 bug、加功能、重构代码。
NcatBot 项目中，skill、docs、code、test 是不可分割的整体。任何变更都必须同时触及这四项：
| 产物 | 说明 | 不同步的后果 |
|---|---|---|
| Code | 实现代码 | 功能不存在 |
| Test | 测试代码 | 无法验证正确性，回归无保障 |
| Docs | 用户文档 + 参考文档 | 用户不知道怎么用，贡献者不知道怎么改 |
| Skill | Agent 技能知识 | AI 助手无法正确引导后续开发 |
变更检查清单（每次提交前过一遍）：
.agents/skills/ 文件| 需要做什么 | 委托给 |
|---|---|
| 定位代码、理解模块、导航文档 | codebase-nav |
| 理解设计意图、查阅架构与 API | doc-nav |
| 编写测试、运行测试、调试测试 | testing-framework |
| 编写/编辑文档、一致性检查、索引同步 | docs-maintenance |
| 发布版本、推送变更、管理 docs submodule | release |
fix/）核心原则：日志优先，禁止通过纯代码阅读推演定位根因。
完整生命周期：症状 → 插桩日志 → 最小复现测试 → 从日志定根因 → 修复 → 回归 → （按需）同步文档
→ 详见 references/hard-bug-debugging.md（完整流程、插桩位置速查、实战案例）
feat/）核心原则：先读文档理解设计意图，再找实现位置；接口设计优先于编码。
流程：读文档（doc-nav）→ 接口设计 → 编码 → 写文档（docs-maintenance）
→ 详见 references/feat-workflow.md（文档路径速查、接口设计检查点、docs 委托指南）
refactor/）核心原则：现有测试即契约，外部行为不得改变。
contributing/docs/）→ 委托 docs-maintenance 技能执行。
ruff format . + ruff check . --fixdocs/ 文件 → 参见 release 技能的 commit 编排流程memory/ 目录创建工作记录 → 模板见 references/memory-template.md详见 references/import-conventions.md。核心原则：
from ncatbot.<layer> import ...），禁止三级及更深from ..module import ...）__init__.py 中注册feat/xxx、fix/xxx、refactor/xxx、docs/xxxruff format . + ruff check . --fix