home-mcp: Command for Claude Code

$1 $2

我需要更新现有的文档内容。请帮我完成以下任务：

1. 确定更新范围

根据我提供的参数 <scope> 和 <target>，请：

• 验证更新范围：确认要更新的文档范围
• 确定目标文件：根据参数确定具体要处理的文件
• 制定更新策略：选择合适的更新方法

2. 支持的更新类型

path-aliases - 路径别名修复

• 参数格式：/docs-update path-aliases [file-or-directory]
• 作用范围：
  • 不指定参数：扫描所有 docs/content/ 下的 .mdx 文件
  • 指定文件：更新特定文件（如 development/contributing.mdx）
  • 指定目录：更新整个目录（如 mcp-tools/）
• 修复内容：
  • 将相对路径 ../ 和 ./ 替换为 @/xxx 格式
  • 识别代码块中的 import 语句
  • 确保路径别名符合项目规范

code-examples - 代码示例优化

• 参数格式：/docs-update code-examples [type]
• 支持类型：
  • typescript - TypeScript 代码示例
  • javascript - JavaScript 代码示例
  • bash - 命令行示例
• 优化内容：
  • 统一代码风格
  • 添加类型注解
  • 更新为最佳实践

format-fix - 格式修复

• 参数格式：/docs-update format-fix [file-or-directory]
• 修复内容：
  • MDX 语法错误
  • Markdown 格式问题
  • 代码块语法高亮
  • 表格格式修正

links-update - 链接更新

• 参数格式：/docs-update links-update [type]
• 更新类型：
  • internal - 内部链接
  • external - 外部链接
  • images - 图片链接
• 检查内容：
  • 链接有效性
  • 链接文本准确性
  • 锚点正确性

3. 路径别名映射规则

基于项目的路径别名系统：

// 项目别名映射
{
  "@/*": ["*"],                    // 根目录快速访问
  "@/types/*": ["types/*"],        // 类型定义目录
  "@/utils/*": ["utils/*"],        // 工具函数目录
  "@/services/*": ["services/*"],  // 服务层目录
  "@/mocks/*": ["mocks/*"],        // Mock 数据目录
  "@/test/*": ["test/*"]           // 测试配置目录
}

常见修复模式

// ❌ 需要修复的相对路径
import { Service } from "../services/file";
import { Type } from "../types/interface";
import { util } from "./utils/helper";
import { mock } from "../test/utils/mock";

// ✅ 修复后的别名路径
import { Service } from "@/services/file";
import { Type } from "@/types/interface";
import { util } from "@/utils/helper";
import { mock } from "@/test/utils/mock";

4. 更新流程

4.1 扫描阶段

1. 识别目标文件：根据参数确定要处理的文件范围
2. 内容分析：解析 MDX 文件，提取代码块
3. 问题识别：检测需要修复的问题

4.2 修复阶段

1. 路径别名修复：替换相对路径为别名格式
2. 代码示例优化：改进代码质量和风格
3. 格式修正：修复 MDX 语法和格式问题