Back to Details

setup

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Setup

安装设置

Install Claude behavioral skills with one command.
通过一条命令安装Claude行为技能。

When to Use

适用场景

  • Fresh Claude Code installation
  • New machine setup
  • After cloning trousse for the first time
  • When 
    /open
    or 
    /close
    commands don't work
  • 全新安装Claude Code后
  • 新设备初始化时
  • 首次克隆trousse仓库后
  • 当
    /open
    或
    /close
    命令无法正常工作时

When NOT to Use

不适用场景

  • Skills are already installed and working
  • Just want to update existing skills (use 
    git pull
    instead)
  • Installing a single skill (manually symlink it)
  • 技能已安装且可正常使用
  • 仅需更新现有技能（请使用
    git pull
    命令）
  • 仅安装单个技能（手动创建符号链接即可）

Quick Start

快速开始

/setup           # Interactive — installs all behavioral skills, offers tool repos
/setup --verify  # Check existing setup
/setup           # 交互式安装 — 安装所有行为技能，并提供工具仓库选项
/setup --verify  # 检查现有安装情况

What Gets Installed

安装内容

Behavioral skills (all installed together):
  • Session lifecycle: 
    /open
    , 
    /close
  • Utilities: diagram, screenshot, filing, github-cleanup, picture, server-checkup, skill-check, sprite, dbt
Optional tool repos (offered after core install):
  • todoist-gtd
    — GTD-flavored Todoist integration
  • garde-manger
    — Searchable memory across sessions
行为技能（全部一同安装）：
  • 会话生命周期：
    /open
    , 
    /close
  • 实用工具：diagram, screenshot, filing, github-cleanup, picture, server-checkup, skill-check, sprite, dbt
可选工具仓库（核心技能安装完成后提供）：
  • todoist-gtd
    — 符合GTD理念的Todoist集成工具
  • garde-manger
    — 跨会话可搜索的记忆工具

Workflow

工作流程

Phase 1: Check Prerequisites

阶段1：检查前置条件

bash
undefined
bash
undefined

Check for required tools

检查所需工具

command -v gh &>/dev/null || echo "MISSING: GitHub CLI (brew install gh)" command -v uv &>/dev/null || echo "MISSING: uv (brew install uv)"
command -v gh &>/dev/null || echo "缺失：GitHub CLI (brew install gh)" command -v uv &>/dev/null || echo "缺失：uv (brew install uv)"

Create directories

创建目录

mkdir -p ~/.claude/skills mkdir -p ~/.claude/scripts mkdir -p ~/.claude/hooks
undefined
mkdir -p ~/.claude/skills mkdir -p ~/.claude/scripts mkdir -p ~/.claude/hooks
undefined

Phase 2: Clone and Symlink

阶段2：克隆仓库并创建符号链接

bash
undefined
bash
undefined

Clone trousse if not present

若未存在则克隆trousse仓库

if [ ! -d ~/Repos/trousse ]; then gh repo clone spm1001/trousse ~/Repos/trousse fi
SUITE="$HOME/Repos/trousse"
if [ ! -d ~/Repos/trousse ]; then gh repo clone spm1001/trousse ~/Repos/trousse fi
SUITE="$HOME/Repos/trousse"

Symlink all skills

为所有技能创建符号链接

for skill in "$SUITE/skills/"*/; do name=$(basename "$skill") ln -sf "$skill" ~/.claude/skills/"$name" done
undefined
for skill in "$SUITE/skills/"*/; do name=$(basename "$skill") ln -sf "$skill" ~/.claude/skills/"$name" done
undefined

Phase 3: Symlink Scripts and Hooks

阶段3：为脚本和钩子创建符号链接

bash
undefined
bash
undefined

Scripts (if present)

脚本（若存在）

if [ -d "$SUITE/scripts" ]; then for script in "$SUITE/scripts/"*.sh; do [ -f "$script" ] && ln -sf "$script" ~/.claude/scripts/ done fi
if [ -d "$SUITE/scripts" ]; then for script in "$SUITE/scripts/"*.sh; do [ -f "$script" ] && ln -sf "$script" ~/.claude/scripts/ done fi

Hooks (if present)

钩子（若存在）

if [ -d "$SUITE/hooks" ]; then for hook in "$SUITE/hooks/"*.sh; do [ -f "$hook" ] && ln -sf "$hook" ~/.claude/hooks/ done fi
undefined
if [ -d "$SUITE/hooks" ]; then for hook in "$SUITE/hooks/"*.sh; do [ -f "$hook" ] && ln -sf "$hook" ~/.claude/hooks/ done fi
undefined

Phase 4: Offer Tool Repos

阶段4：提供工具仓库选项

Use AskUserQuestion:
Core skills installed. Want to add tool integrations?

[ ] todoist-gtd — GTD task management with Todoist
[ ] garde-manger — Search past sessions
If todoist-gtd selected:
bash
gh repo clone spm1001/todoist-gtd ~/Repos/todoist-gtd
ln -sf ~/Repos/todoist-gtd/skills/todoist-gtd ~/.claude/skills/todoist-gtd
使用AskUserQuestion交互：
核心技能已安装。是否添加工具集成？

[ ] todoist-gtd — 基于GTD的Todoist任务管理
[ ] garde-manger — 搜索过往会话内容
若选择todoist-gtd：
bash
gh repo clone spm1001/todoist-gtd ~/Repos/todoist-gtd
ln -sf ~/Repos/todoist-gtd/skills/todoist-gtd ~/.claude/skills/todoist-gtd

Run OAuth

运行OAuth认证

todoist auth

**If garde-manger selected:**
```bash
gh repo clone spm1001/garde-manger ~/Repos/garde-manger
cd ~/Repos/garde-manger && uv sync
ln -sf ~/Repos/garde-manger/skill ~/.claude/skills/garde
todoist auth

**若选择garde-manger：**
```bash
gh repo clone spm1001/garde-manger ~/Repos/garde-manger
cd ~/Repos/garde-manger && uv sync
ln -sf ~/Repos/garde-manger/skill ~/.claude/skills/garde

Initial scan

初始扫描

cd ~/Repos/garde-manger && uv run garde scan
undefined
cd ~/Repos/garde-manger && uv run garde scan
undefined

Phase 5: Verify

阶段5：验证安装

bash
undefined
bash
undefined

List installed skills

列出已安装的技能

ls ~/.claude/skills/
ls ~/.claude/skills/

Test key skills

测试关键技能

ls -la ~/.claude/skills/open

Tell user to restart Claude (`/exit` then `claude`) to load new skills.
ls -la ~/.claude/skills/open

告知用户重启Claude（执行`/exit`后再输入`claude`）以加载新技能。

Verification

验证步骤

CheckCommandExpected
Skills directory
ls ~/.claude/skills/
13+ skill symlinks
Session skills
ls -la ~/.claude/skills/open
Points to trousse
检查项命令预期结果
技能目录
ls ~/.claude/skills/
13个以上技能符号链接
会话技能
ls -la ~/.claude/skills/open
指向trousse仓库

Updating

技能更新

bash
cd ~/Repos/trousse && git pull
bash
cd ~/Repos/trousse && git pull

Symlinks automatically point to updated content

符号链接会自动指向更新后的内容

undefined
undefined

Anti-Patterns

反模式

PatternProblemFix
Running setup when skills existOverwrites custom symlinksUse 
--verify
first
Skipping OAuth for todoist-gtdSkill fails silentlyComplete auth flow
Not restarting Claude after installSkills not loaded
/exit
then 
claude
模式问题解决方法
技能已存在时仍运行安装覆盖自定义符号链接先使用
--verify
选项检查
跳过todoist-gtd的OAuth认证技能静默失效完成完整的认证流程
安装后未重启Claude技能未加载执行
/exit
后再输入
claude