3.6 KiB
3.6 KiB
Phase 3: Orchestration - Context
Gathered: 2026-03-11 Status: Ready for planning
## Phase Boundary命令路由和双向桥接 — 用户通过聊天发送 GSD slash 命令，系统捕获 tmux 输出并返回，支持审批流程、进度更新和错误处理。这是 gsd-openclaw 技能的"大脑"层，连接 Phase 1 的会话管理、Phase 2 的响应格式化与实际的 GSD 命令执行。
## Implementation Decisions命令路由策略
- 命令解析: 直接解析（正则或字符串分割），由 orchestrator.py 验证命令有效性
- 会话需求: 所有命令需要 tmux 会话（统一流程，简化实现）
- 执行超时: 60 秒（大多数 GSD 命令在合理时间内完成）
- 无会话处理: 自动创建会话并执行命令（参考 Phase 2 CONTEXT.md 的设计）
审批流程集成
- 审批检测: 解析 Claude 工具调用标记（如 AskUserQuestion、ExitPlanMode）
- 回调处理: 使用飞书 Card 按钮回调（value 字段存储上下文）
- 审批超时: 无超时限制（等待用户响应或会话结束）
进度更新机制
- 进度检测: 输出模式匹配（监控百分比、阶段名等进度相关字符串）
- 更新频率: 每 1 分钟发送一次进度更新
- 完成检测: tmux 提示符出现（Claude CLI 输出完成，会话返回到提示符）
错误处理策略
- 错误检测: 关键词匹配（监控输出中的 error、failed、exception 等）
- 错误呈现: 直接展示原始错误（使用 Phase 2 的 format_error() 方法）
- 会话丢失处理: 自动恢复会话并重试命令（CLI 已支持会话恢复）
Claude's Discretion
- 进度匹配的具体正则模式
- 错误关键词的完整列表
- 审批按钮的具体文案和样式
- 进度更新的卡片格式
- 进度更新使用简洁格式（如"正在执行... [2/5 任务]"）
- 审批按钮保持简洁（2-4 个中文字符，与 Phase 2 一致）
- 错误卡片使用红色主题（Phase 2 已定义）
<code_context>
Existing Code Insights
Reusable Assets
- Phase 1 TmuxSessionManager: 会话创建、恢复、销毁 — 所有命令执行的基础
- Phase 1 StateManager: 状态持久化 — 存储当前项目上下文
- Phase 1 CLI (cli.py): 命令解析模式可参考（argparse 结构）
- Phase 2 FeishuResponseFormatter: 卡片格式化 — format_success/format_error/format_info
- Phase 2 Prompt Templates: context_recovery.md、command_mapping.md、error_recovery.md
- Phase 2 SKILL.md: 已定义 /gsd:* 触发模式
Established Patterns
- 会话管理: gsd-{project} 命名前缀，状态持久化到 ~/gsd-workspaces/
- 错误处理: 中文错误消息 + 异常类（TmuxSessionError）
- 卡片布局: 三区结构（标题区 + 内容区 + 操作区）
- 按钮交互: CardButton dataclass，value 字段存储回调数据
Integration Points
- orchestrator.py 是本 phase 的核心产出，将调用：
- TmuxSessionManager（会话管理）
- FeishuResponseFormatter（响应格式化）
- StateManager（状态持久化）
- OpenClaw 通过 SKILL.md 加载技能，调用 orchestrator.py
- 本 phase 产出将被 Phase 4 的完整 GSD 命令支持使用
</code_context>
## Deferred Ideas- 微信/Telegram/Discord 频道支持（Phase 2 已 defer，本 phase 仍仅飞书）
- 多语言支持（中文/英文切换）
- 命令历史记录和搜索
- 批量命令执行
Phase: 03-orchestration Context gathered: 2026-03-11