optimize codex skills

skills/codex/SKILL.md

@@ -18,9 +18,21 @@ Execute Codex CLI commands and parse structured JSON responses. Supports file re
 
 ## Usage
 
-通过 Bash tool 调用:
+**推荐方式**（使用 uv run，自动管理 Python 环境）：
 ```bash
-node ~/.claude/skills/codex/scripts/codex.js "<task>" [model] [working_dir]
+uv run ~/.claude/skills/codex/scripts/codex.py "<task>" [model] [working_dir]
+```
+
+**备选方式**（直接执行或使用 Python）：
+```bash
+~/.claude/skills/codex/scripts/codex.py "<task>" [model] [working_dir]
+# 或
+python3 ~/.claude/skills/codex/scripts/codex.py "<task>" [model] [working_dir]
+```
+
+恢复会话:
+```bash
+uv run ~/.claude/skills/codex/scripts/codex.py resume <session_id> "<task>" [model] [working_dir]
 ```
 
 ## Timeout Control
@@ -37,19 +49,19 @@ node ~/.claude/skills/codex/scripts/codex.js "<task>" [model] [working_dir]
 - `model` (optional): Model to use (default: gpt-5-codex)
   - `gpt-5-codex`: Default, optimized for code
   - `gpt-5`: Fast general purpose
-  - `o3`: Deep reasoning
-  - `o4-mini`: Quick tasks
-  - `codex-1`: Software engineering
 - `working_dir` (optional): Working directory (default: current)
 
 ### Return Format
 
-Extracts `agent_message` from Codex JSON stream:
+Extracts `agent_message` from Codex JSON stream and appends session ID:
 ```
 Agent response text here...
+
+---
+SESSION_ID: 019a7247-ac9d-71f3-89e2-a823dbd8fd14
 ```
 
-Error format:
+Error format (stderr):
 ```
 ERROR: Error message
 ```
@@ -59,41 +71,69 @@ ERROR: Error message
 When calling via Bash tool, always include the timeout parameter:
 ```
 Bash tool parameters:
-- command: node ~/.claude/skills/codex/scripts/codex.js "<task>" [model] [working_dir]
+- command: uv run ~/.claude/skills/codex/scripts/codex.py "<task>" [model] [working_dir]
 - timeout: 7200000
 - description: <brief description of the task>
 ```
 
+Alternatives:
+```
+# Direct execution (simplest)
+- command: ~/.claude/skills/codex/scripts/codex.py "<task>" [model] [working_dir]
+
+# Using python3
+- command: python3 ~/.claude/skills/codex/scripts/codex.py "<task>" [model] [working_dir]
+```
+
 ### Examples
 
 **Basic code analysis:**
 ```bash
-# Via Bash tool with timeout parameter
-node ~/.claude/skills/codex/scripts/codex.js "explain @src/main.ts"
+# Recommended: via uv run (auto-manages Python environment)
+uv run ~/.claude/skills/codex/scripts/codex.py "explain @src/main.ts"
 # timeout: 7200000
+
+# Alternative: direct execution
+~/.claude/skills/codex/scripts/codex.py "explain @src/main.ts"
 ```
 
 **Refactoring with specific model:**
 ```bash
-node ~/.claude/skills/codex/scripts/codex.js "refactor @src/utils for performance" "gpt-5"
+uv run ~/.claude/skills/codex/scripts/codex.py "refactor @src/utils for performance" "gpt-5"
 # timeout: 7200000
 ```
 
 **Multi-file analysis:**
 ```bash
-node ~/.claude/skills/codex/scripts/codex.js "analyze @. and find security issues" "gpt-5-codex" "/path/to/project"
+uv run ~/.claude/skills/codex/scripts/codex.py "analyze @. and find security issues" "gpt-5-codex" "/path/to/project"
 # timeout: 7200000
 ```
 
-**Quick task:**
+**Resume previous session:**
 ```bash
-node ~/.claude/skills/codex/scripts/codex.js "add comments to @utils.js" "gpt-5-codex"
+# First session
+uv run ~/.claude/skills/codex/scripts/codex.py "add comments to @utils.js" "gpt-5-codex"
+# Output includes: SESSION_ID: 019a7247-ac9d-71f3-89e2-a823dbd8fd14
+
+# Continue the conversation
+uv run ~/.claude/skills/codex/scripts/codex.py resume 019a7247-ac9d-71f3-89e2-a823dbd8fd14 "now add type hints"
 # timeout: 7200000
 ```
 
+**Using python3 directly (alternative):**
+```bash
+python3 ~/.claude/skills/codex/scripts/codex.py "your task here"
+```
+
 ## Notes
 
-- Runs with `--dangerously-bypass-approvals-and-sandbox` for automation
+- **Recommended**: Use `uv run` for automatic Python environment management (requires uv installed)
+- **Alternative**: Direct execution `./codex.py` (uses system Python via shebang)
+- Python implementation using standard library (zero dependencies)
+- Cross-platform compatible (Windows/macOS/Linux)
+- PEP 723 compliant (inline script metadata)
+- Runs with `--dangerously-bypass-approvals-and-sandbox` for automation (new sessions only)
 - Uses `--skip-git-repo-check` to work in any directory
 - Streams progress, returns only final agent message
+- Every execution returns a session ID for resuming conversations
 - Requires Codex CLI installed and authenticated