From 9d4d728ee772e39cc45bd83d7a157354add6f6f8 Mon Sep 17 00:00:00 2001 From: catlog22 Date: Sun, 12 Oct 2025 17:19:47 +0800 Subject: [PATCH] docs: add bash execution rules and Windows path conversion guide MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add rule to prevent run_in_background parameter in bash() calls - Add Windows path conversion guidelines for Git Bash compatibility - Simplify path handling: C:\path → /c/path, relative paths unchanged --- .claude/commands/update-memory-full.md | 1 + .claude/commands/update-memory-related.md | 1 + CLAUDE.md | 5 +++++ 3 files changed, 7 insertions(+) diff --git a/.claude/commands/update-memory-full.md b/.claude/commands/update-memory-full.md index b41fe106..1bc8647b 100644 --- a/.claude/commands/update-memory-full.md +++ b/.claude/commands/update-memory-full.md @@ -36,6 +36,7 @@ argument-hint: "[--tool gemini|qwen|codex] [--path ]" 4. **Depth-Parallel**: Same depth runs parallel (max 4 jobs), different depths sequential 5. **Safety Check**: Verify only CLAUDE.md files modified, revert if source files touched 6. **Independent Commands**: Each update is a separate bash() call +7. **No Background Bash Tool**: Never use `run_in_background` parameter in bash() calls; use shell `&` for parallelism ## Execution Workflow diff --git a/.claude/commands/update-memory-related.md b/.claude/commands/update-memory-related.md index d0aaf8b3..31ee036c 100644 --- a/.claude/commands/update-memory-related.md +++ b/.claude/commands/update-memory-related.md @@ -30,6 +30,7 @@ argument-hint: "[--tool gemini|qwen|codex]" 3. **Related Mode**: Update only changed modules and their parent contexts 4. **Depth-Parallel**: Same depth runs parallel (max 4 jobs), different depths sequential 5. **Safety Check**: Verify only CLAUDE.md files modified, revert if source files touched +6. **No Background Bash Tool**: Never use `run_in_background` parameter in bash() calls; use shell `&` for parallelism ## Execution Workflow diff --git a/CLAUDE.md b/CLAUDE.md index 1d951867..e9481241 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -70,6 +70,11 @@ For all CLI tool usage, command syntax, and integration guidelines: - Learn from existing implementations - Stop after 3 failed attempts and reassess +## Platform-Specific Guidelines + +### Windows Path Conversion for Bash Commands +- **Windows paths** must convert to Git Bash format: `C:\path` → `/c/path`, `D:\path` → `/d/path`, `\` → `/` +- **Relative paths** (starting with `.` or `..`) require no conversion #### **Content Uniqueness Rules**