메뉴
检查、报告、修复 Skills 间链接内容不同步，以及 Skills↔Docs 内容链接不同步。逐文件检查，最大化并发 subagent。Use when: skill 同步、skill 断链、skill 引用、skill 过时、skill audit、skills 一致性、skill 检查、skill↔docs。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | skills-sync |
| description | 检查、报告、修复 Skills 间链接内容不同步，以及 Skills↔Docs 内容链接不同步。逐文件检查，最大化并发 subagent。Use when: skill 同步、skill 断链、skill 引用、skill 过时、skill audit、skills 一致性、skill 检查、skill↔docs。 |
检查所有 .agents/skills/ 下的 Skill 文件（SKILL.md + references/*.md），确保：
**skill-name** 格式引用的 skill 存在且文本准确）1. 枚举 → 2. Phase A（per-skill 链接检查）→ 3. Phase B（skill 对内容一致）→ 4. 汇总 → 5. 修复
list_dir .agents/skills/ 获取所有 skill 目录名。
当前 skill 清单：code-nav · codebase-nav · doc-nav · docs-maintenance · docs-sync · framework-dev · framework-usage · plugin-migration · release · skills-sync · testing-design · testing-framework
为每个 skill 目录启动 1 个 Explore subagent，逐文件扫描 SKILL.md + references/*.md：
2a. 内部 references 断链
[text](path) 链接./references/ 或 ../scripts/ 开头的 → 验证目标文件存在2b. 协作技能引用有效性
**xxx** 格式的技能引用.agents/skills/<xxx>/SKILL.md 是否存在2c. Docs 引用有效性
docs/guide/...、docs/reference/... 等）docs/docs/notes/<path> 或 docs/docs/examples/<path> 是否存在2d. Docs 内容对比（仅对有效 docs 引用）
互相引用的 skill 对，检查对同一概念的描述是否矛盾：
| Skill 对 | 检查点 |
|---|---|
testing ↔ testing-design | 测试层级划分、规范编号体系 |
testing ↔ testing-framework | TestHarness API、Scenario 用法 |
docs-maintenance ↔ framework-dev | 四位一体变更清单、协作出口 |
doc-nav ↔ codebase-nav ↔ code-nav | 导航链路、委托关系 |
framework-usage ↔ plugin-migration | API 映射表 vs 当前 API 速查 |
每个 subagent 读取两端 SKILL.md + references，对比同名概念描述，标记矛盾为 P1。
聚合 Phase A + B 全部 subagent 输出，按 severity 排序生成报告，格式参见 references/report-template.md。
按以下策略执行修复：
| 问题类型 | 修复方式 |
|---|---|
| P0 内部断链 | 修正链接路径或删除失效引用 |
| P0 skill 不存在 | 修正为正确 skill 名或删除引用 |
| P0 docs 路径不存在 | 修正路径或标记待创建 |
| P1 API 不一致 | 以 Code 为权威，更新 Skill references |
| P1 skill 对矛盾 | 以较新/更详细的一方为准，同步另一方 |
| P2 措辞差异 | 仅报告，不自动修复 |
可为每个需修复的 skill 并发启动修复操作。
| 级别 | 问题类型 | 处理 |
|---|---|---|
| P0 | 内部文件断链、docs 路径不存在、引用不存在的 skill | 必须修复 |
| P1 | skill 描述的 API 与 docs 签名明显不一致、skill 对间矛盾 | 应当修复 |
| P2 | 措辞轻微过时，不影响功能理解 | 仅报告 |
| 需要做什么 | 委托给 |
|---|---|
| 发现 docs 内部有问题 | docs-sync |
| 需要修复 docs 内容 | docs-maintenance |
| 需要理解代码以核对 API | codebase-nav |
定位 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 框架本体。调试 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。