31823ba582
- Add Orchestrator to __init__.py exports - Update SKILL.md with "How It Works" section explaining orchestrator.py entry point - Document command routing and approval workflow Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
60 lines
2.1 KiB
Markdown
60 lines
2.1 KiB
Markdown
---
|
|
name: gsd-openclaw
|
|
description: GSD project management via /gsd:* commands. Triggers on /gsd:new-project, /gsd:plan, /gsd:status, /gsd:use and other GSD slash commands.
|
|
---
|
|
|
|
# GSD-OpenClaw Skill
|
|
|
|
This skill enables GSD (Get Shit Done) project management through chat interfaces via OpenClaw.
|
|
|
|
## How It Works
|
|
|
|
This skill uses the `Orchestrator` class from `orchestrator.py` as its main entry point. When a user sends a message starting with `/gsd:`:
|
|
|
|
1. **Command Parsing**: The orchestrator parses the `/gsd:*` pattern to extract the command and arguments
|
|
2. **Session Management**: Auto-creates a tmux session if one doesn't exist for the project
|
|
3. **Command Execution**: Executes the GSD command via the tmux session
|
|
4. **Response Formatting**: Returns a formatted Feishu card with the result
|
|
|
|
For interactive operations that require user confirmation (e.g., approvals), the orchestrator:
|
|
- Detects approval requests in Claude CLI output
|
|
- Returns an interactive card with confirm/reject buttons
|
|
- Handles button callbacks to continue or cancel the operation
|
|
|
|
## When to Use
|
|
|
|
This skill triggers when users send messages starting with `/gsd:` in any channel where OpenClaw is configured. Use this skill to:
|
|
|
|
- Create and manage GSD projects
|
|
- Switch between project contexts
|
|
- Check project status
|
|
- Execute planning and shipping workflows
|
|
|
|
## Commands
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `/gsd:new-project <name>` | Create a new GSD project |
|
|
| `/gsd:use <project>` | Switch to a project context |
|
|
| `/gsd:status` | Show current project status |
|
|
| `/gsd:plan` | Run planning phase |
|
|
| `/gsd:ship` | Ship the current phase |
|
|
| `/gsd:help` | Show available commands |
|
|
|
|
## Project Context
|
|
|
|
GSD manages multiple projects, each with its own workspace and state. Use `/gsd:use <project>` to switch the active project context before running other commands.
|
|
|
|
Example:
|
|
```
|
|
/gsd:new-project my-auth-service
|
|
/gsd:use my-auth-service
|
|
/gsd:status
|
|
```
|
|
|
|
## Integration Notes
|
|
|
|
- Sessions persist in tmux for long-running operations
|
|
- State is checkpointed to JSON for recovery
|
|
- Multiple projects can run concurrently without interference
|