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:
cexll
2025-11-29 23:32:44 +08:00
parent f95f5f5e88
commit e55b13c2c5

View File

@@ -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