القائمة
文档更新技能，用于批量更新文档和修复路径别名
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | docs-updater |
| description | 文档更新技能，用于批量更新文档和修复路径别名 |
我是一个文档更新专家，专门批量更新现有文档内容并修复路径别名问题。
当你需要更新现有文档时，我会：
使用格式：/docs-update [更新类型] [目标]
示例：
/docs-update path-aliases - 批量修复所有文档的路径别名/docs-update path-aliases development/docker-build.mdx - 修复特定文件/docs-update path-aliases usage/ - 修复整个目录/docs-update code-examples typescript - 优化 TypeScript 代码示例/docs-update format-fix getting-started/quickstart.mdx - 修复格式问题/docs-update links-update internal - 更新内部链接作用范围：
docs/ 下的 .mdx 和 .md 文件修复内容：
../ 和 ./ 替换为 @/xxx 格式typescript、javascript、bashinternal、external、images基于 xiaozhi-client 项目的路径别名系统：
// xiaozhi-client 项目别名映射（单体架构，统一 @/ 路径别名体系）
{
"@/types": ["./src/types"], // 共享类型定义
"@/config": ["./src/config"], // 配置管理
"@/mcp-core": ["./src/mcp-core"], // MCP 协议核心
"@/endpoint": ["./src/endpoint"], // 端点处理
"@/esp32": ["./src/esp32"], // ESP32 硬件相关
"@/cli": ["./src/cli"], // CLI 命令行工具
"@/utils": ["./src/utils"], // 通用工具
"@/server": ["./src/server"] // 后端服务（含 handlers、services、routes 等）
}
// ❌ 需要修复的相对路径
import { Service } from "../services/file";
import { Command } from "./commands/help";
import { Type } from "../../types/interface";
import { util } from "./utils/helper";
// ✅ 修复后的别名路径（xiaozhi-client @/ 路径别名体系）
import { Service } from "@/server/services/file";
import { Command } from "@/cli/commands/start";
import { Type } from "@/types/interface";
import { util } from "@/utils/helper";
# 本地验证流程
pnpm dev:docs
# 等待服务启动后检查状态
curl -s -o /dev/null -w "%{http_code}" http://localhost:3000
# 运行代码质量检查
pnpm spellcheck
pnpm lint
pnpm typecheck
以下相对路径使用是合理的，不会被自动修复：
对于复杂或不确定的修复：
提交、推送并创建 PR
自动发现项目中的代码问题并提交 GitHub Issue
安全审计技能，用于检查和修复依赖安全问题
文档自动生成
CI检查验证和质量保障
生成代码评审友好的 commit 信息