Claude Playbook CLI

Claude CLI 脚手架工具，用于快速初始化和管理 Claude 配置（.claude 目录）。

特性

• 🚀 快速初始化：一键拉取标准化的 Claude 配置模板
• 🔄 智能合并：支持向现有配置中增量添加新功能，而不覆盖原有文件
• 💾 自动备份：每次更新配置前自动创建备份
• 🔧 配置还原：支持从备份中恢复配置
• 🛡️ 安全保护：从不删除用户的 .claude 目录，确保数据安全
• 📦 跨平台：支持 Windows, macOS 和 Linux

安装

npm install -g @qiuhao7/claude-playbook-init

使用

初始化配置

在任意目录下运行：

claude-playbook init

该命令会自动检测用户主目录下的 .claude 文件夹：

• 如果不存在：自动从远程仓库克隆标准模板。
• 如果已存在：
  • 自动创建当前配置的备份
  • 询问是否合并新配置
  • 确认后，会将远程模板中的文件合并到本地，同名文件将被更新，.git 目录会被自动过滤

还原配置

如果需要恢复到之前的配置版本：

claude-playbook restore

该命令会：

• 列出所有可用的备份（按时间倒序）
• 支持选择并还原到指定备份
• 支持删除不需要的备份
• 自动保留最近 5 个备份，清理旧备份

备份位置：~/.claude/.claude-backups/

开发

本地调试

# 安装依赖
npm install

# 链接到全局
npm link

# 运行
claude-playbook init
claude-playbook restore

测试

npm test

技术栈

• Node.js
• Commander (CLI 框架)
• Inquirer (交互式命令行)
• fs-extra (文件操作)
• Jest (测试框架)