# gsd-openclaw

## What This Is

GSD (Get Shit Done) 到 OpenClaw 的桥接技能。让用户通过通讯软件（微信、飞书、Telegram 等）与 OpenClaw Agent 交互，随时使用 GSD 的完整项目管理能力——创建项目、查看进度、执行计划、审批确认等。

## Core Value

让用户在任何通讯软件中，随时与 AI 代理协作完成软件开发项目。

## Requirements

### Validated

(None yet — ship to validate)

### Active

- [ ] 调研 tmux-Claude CLI 集成方案
- [ ] 实现 tmux 会话管理（创建、持久化、输入输出）
- [ ] 创建 OpenClaw 技能包装层（SKILL.md + orchestrator.py）
- [ ] 支持所有 GSD slash commands 的桥接调用
- [ ] 为每个项目动态创建独立工作空间
- [ ] 持久会话保持上下文
- [ ] 用户认证和项目隔离（多用户场景）

### Out of Scope

- GSD 核心功能的修改或重写 — 只做桥接，不改动 GSD
- OpenClaw 核心框架的修改 — 使用现有扩展机制
- 移动端原生应用 — 通过通讯软件覆盖

## Context

**OpenClaw 架构：**
- Agent 框架 + 网关系统
- 用户通过通讯软件与 AI Agent 沟通
- 技能结构：SKILL.md + orchestrator.py + prompts/ + state_manager.py
- 参考：https://openclaw.ai/

**GSD 架构：**
- Claude CLI 的技能/工作流系统
- 位于 `~/.claude/get-shit-done/`
- 通过 slash commands 触发（如 /gsd:new-project）
- 现有完整源码在 `../gsd/` 目录

**技术路径：**
- 桥接调用优先于移植重构
- tmux 作为 Claude CLI 的会话容器
- 需要调研现有 tmux-Claude 方案并适配

**现有参考：**
- dev-workflow 技能作为 OpenClaw 技能结构参考
- GSD 源码在 `../gsd/` 可直接参考

## Constraints

- **技术栈：** Python（OpenClaw 技能） + Bash/tmux（会话管理） + Claude CLI
- **依赖：** 需要服务器环境支持 tmux 和 Claude CLI
- **调研需求：** tmux-Claude 集成方案需要先调研验证

## Key Decisions

| Decision | Rationale | Outcome |
|----------|-----------|---------|
| 桥接调用而非移植 | 保持 GSD 更新兼容，减少维护负担 | — Pending |
| tmux 会话管理 | 保持 Claude CLI 的持久上下文 | — Pending |
| 动态工作空间 | 支持多项目隔离 | — Pending |
| 分步交付 | 降低风险，快速验证方案 | — Pending |

---
*Last updated: 2026-03-10 after initialization*