Preqstation

核心用法

preqstation 是一个面向 PREQSTATION 项目的智能编码代理调度技能，专为需要真实代码执行的场景设计。它通过标准化的 Git worktree 隔离机制，将用户的自然语言需求转化为可在本地 CLI 引擎（Claude Code、Codex CLI、Gemini CLI）中执行的具体任务。

典型触发方式

• /skill preqstation: 实现 PROJ-284 的需求
• preqstation plan PROJ-76 using Claude Code
• preq: 重构登录模块

执行流程

1. 项目解析：从 MEMORY.md 或用户输入解析项目 key 与绝对路径
2. Worktree 创建：为每个任务创建隔离的 Git worktree（路径：/tmp/openclaw-worktrees/<project_key>/<branch>）
3. 引擎渲染：将用户目标封装为结构化 prompt，注入工作目录约束
4. 后台执行：以 pty:true + background:true 模式启动编码代理
5. 状态监控：支持 sparse（默认）或 live 两种进度更新模式

显著优点

• 执行隔离性：强制使用 Git worktree，杜绝直接在主仓库或 OpenClaw 系统目录运行代码
• 引擎灵活性：支持 Claude/Code/Gemini 三大主流 CLI 编码代理，用户可指定或默认使用 Claude
• 后台友好：默认后台运行，不阻塞用户会话，支持 poll/log/kill 等进程管理操作
• 安全守门：多重预检（git/引擎可用性、路径合法性），dangerously-* 标志仅在通过安全门后用于可信本地 CLI
• 分支规范：自动强制执行 preqstation/<project_key>/ 前缀的分支命名约定

潜在局限

• 依赖前置：要求本地预装 git 及至少一个引擎二进制（claude/codex/gemini）
• 非交互限制：明确排除单行编辑、纯读查看等轻量场景，过度使用可能显得笨重
• 环境敏感：dangerously-skip-permissions 等标志依赖特定 CLI 版本，环境不支持时会快速失败
• 上下文管理：长任务需主动 compact，否则线程膨胀；sparse 模式可能让用户产生"黑盒"体感

适合人群

• 需要批量、长时间编码任务（重构、功能实现、代码审查）的开发者
• 追求主仓库零污染、严格隔离的协作型团队
• 已本地部署 Claude Code/Codex/Gemini CLI 的进阶用户
• 需要并行处理多个 Jira/Linear 任务的技术负责人

常规风险

• 权限绕过风险：--dangerously-bypass-approvals-and-sandbox 标志会跳过 AI 编码代理的内置确认，需在可信本地环境使用
• Worktree 残留：大量后台任务可能堆积临时 worktree，需定期清理 /tmp/openclaw-worktrees
• 路径注入：虽有过滤（..、前导 / 等），但用户提供的绝对路径仍需人工确认
• 引擎行为差异：Claude/Codex/Gemini 的 sandbox 机制不同，同一 prompt 表现可能不一致