mirror of
https://github.com/cexll/myclaude.git
synced 2026-02-05 02:30:26 +08:00
docs: improve codex skill parameter best practices
Add best practices for task id and workdir parameters: - id: recommend <feature>_<timestamp> format for uniqueness - workdir: recommend absolute paths to avoid ambiguity Update parallel execution example to demonstrate recommended format 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -185,26 +185,32 @@ For multiple independent or dependent tasks, use `--parallel` mode with delimite
|
|||||||
```bash
|
```bash
|
||||||
codex-wrapper --parallel - <<'EOF'
|
codex-wrapper --parallel - <<'EOF'
|
||||||
---TASK---
|
---TASK---
|
||||||
id: T1
|
id: analyze_1732876800
|
||||||
workdir: .
|
workdir: /home/user/project
|
||||||
---CONTENT---
|
---CONTENT---
|
||||||
analyze requirements @spec.md
|
analyze requirements @spec.md
|
||||||
---TASK---
|
---TASK---
|
||||||
id: T2
|
id: implement_1732876801
|
||||||
dependencies: T1
|
workdir: /home/user/project
|
||||||
|
dependencies: analyze_1732876800
|
||||||
---CONTENT---
|
---CONTENT---
|
||||||
implement feature based on T1 analysis
|
implement feature based on analyze_1732876800 analysis
|
||||||
---TASK---
|
---TASK---
|
||||||
id: T3
|
id: docs_1732876802
|
||||||
|
workdir: /home/user/project/docs
|
||||||
---CONTENT---
|
---CONTENT---
|
||||||
independent task runs in parallel with T1
|
independent task runs in parallel with analyze_1732876800
|
||||||
EOF
|
EOF
|
||||||
```
|
```
|
||||||
|
|
||||||
**Delimiter Format**:
|
**Delimiter Format**:
|
||||||
- `---TASK---`: Starts a new task block
|
- `---TASK---`: Starts a new task block
|
||||||
- `id: <task-id>`: Required, unique task identifier
|
- `id: <task-id>`: Required, unique task identifier
|
||||||
|
- Best practice: use `<feature>_<timestamp>` format (e.g., `auth_1732876800`, `api_test_1732876801`)
|
||||||
|
- Ensures uniqueness across runs and makes tasks traceable
|
||||||
- `workdir: <path>`: Optional, working directory (default: `.`)
|
- `workdir: <path>`: Optional, working directory (default: `.`)
|
||||||
|
- Best practice: use absolute paths (e.g., `/home/user/project/backend`)
|
||||||
|
- Avoids ambiguity and ensures consistent behavior across environments
|
||||||
- `dependencies: <id1>, <id2>`: Optional, comma-separated task IDs
|
- `dependencies: <id1>, <id2>`: Optional, comma-separated task IDs
|
||||||
- `session_id: <uuid>`: Optional, resume a previous session
|
- `session_id: <uuid>`: Optional, resume a previous session
|
||||||
- `---CONTENT---`: Separates metadata from task content
|
- `---CONTENT---`: Separates metadata from task content
|
||||||
|
|||||||
Reference in New Issue
Block a user