القائمة
开发与维护 NcatBot 框架本体。调试 bug、开发新功能、维护 Skill、代码审查、重构。Use when: 框架调试、debug、fix bug、feat、新功能、Skill 维护、代码贡献、模块修改、代码审查、重构。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
定位 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、版本升级。
استنادا إلى تصنيف SOC المهني
| 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