← Back to Skills Marketplace
82
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install trouble-shooting
Description
问题排查与上下文隔离。用户说报错了/遇到问题时，创建隔离环境（worktree/subagent）专门排查，当前主线上下文保持不变。解决后回到主线继续。触发词：报错了、有问题、排查。
Usage Guidance
Before installing or running this skill: 1) Be aware it expects git to be available (scripts call git commands) though git is not declared; install git if needed. 2) The scripts will create a .trouble-shooting directory, temporary worktree folders, and temporary git branches (named trouble/<id>), and may merge changes into your current branch or delete branches — back up or commit/uncommitted-work stash before using. 3) Review the three included Python scripts (start/finish/list) — they run local subprocesses and modify the repo; ensure you trust them in your environment. 4) During 'apply' the tool attempts an automatic merge (git merge --no-edit) and will fail if conflicts exist; be prepared to resolve conflicts manually. 5) If you need stricter safety, run start_troubleshoot.py in 'subagent' mode (no worktree) or run the scripts in a disposable clone first. If you want higher assurance, ask the author to declare git as a required binary and to add explicit confirmation prompts before destructive operations.
Capability Analysis
Type: OpenClaw Skill
Name: trouble-shooting
Version: 1.0.0
The 'trouble-shooting' skill is a developer productivity tool designed to isolate debugging tasks using Git worktrees or sub-agents. The Python scripts (start_troubleshoot.py, finish_troubleshoot.py) use safe subprocess calls with list-based arguments to manage Git operations, and the SKILL.md instructions clearly define a helpful workflow for context isolation without any signs of malicious intent, data exfiltration, or prompt injection attacks.
Capability Assessment
Purpose & Capability
The skill's name/description match what the included scripts do: create isolated troubleshooting environments, save snapshots, apply/discard changes, and archive results. However, the package metadata declares no required binaries while the scripts call git heavily (git worktree, git merge, git branch, git checkout). Git is a legitimate dependency for this purpose but is not declared.
Instruction Scope
SKILL.md stays on-topic describing worktree vs subagent flows. The runtime scripts operate on the local repository and filesystem: writing .trouble-shooting/active.json and archive files, creating/removing worktrees, merging branches, and deleting temporary branches. There are no network endpoints or secret exfiltration steps. The instructions give the agent discretion to create and apply changes in the repo, so user consent/confirmation before applying merges is important.
Install Mechanism
This is instruction-only with bundled scripts and no install spec; nothing is downloaded or executed from remote URLs. That is a low-risk install profile.
Credentials
The skill requests no environment variables or external credentials and the scripts do not attempt to read secrets or external configs. The local file writes are limited to a .trouble-shooting directory and git operations on the repository.
Persistence & Privilege
always is false and the skill does not request system-wide persistent privileges. It creates local state (.trouble-shooting) inside the working directory and manipulates git branches, which is appropriate for a troubleshooting helper but does modify repository state.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install trouble-shooting - After installation, invoke the skill by name or use
/trouble-shooting - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the trouble-shooting skill.
- Provides problem isolation using worktree or subagent for error investigation.
- Main conversation context remains unchanged during troubleshooting.
- Supports switching in and out of isolated environments seamlessly.
- Trigger phrases include: 报错了、有问题、排查.
Metadata
Frequently Asked Questions
What is trouble-shooting?
问题排查与上下文隔离。用户说报错了/遇到问题时，创建隔离环境（worktree/subagent）专门排查，当前主线上下文保持不变。解决后回到主线继续。触发词：报错了、有问题、排查。 It is an AI Agent Skill for Claude Code / OpenClaw, with 82 downloads so far.
How do I install trouble-shooting?
Run "/install trouble-shooting" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is trouble-shooting free?
Yes, trouble-shooting is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does trouble-shooting support?
trouble-shooting is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created trouble-shooting?
It is built and maintained by Gracie ♡ (@graceqx); the current version is v1.0.0.
More Skills