parallel-debugging skill
✓ 検証済み競合する仮説を生成し、エビデンスに基づいた根本原因の裁定と並行調査を行うことで、複雑な問題をデバッグします。
- GitHubスター
- 42,413
- ファイル
- 2
- 最終コミット
- 2026年11月9日
- ライセンス
- MIT
- 許可されたツール
- —
parallel-debugging skillは何をしますか
競合する仮説を生成し、エビデンスに基づいた根本原因の裁定と並行調査を行うことで、複雑な問題をデバッグします。
skillのSKILL.mdから生成された要約。
parallel-debugging skill について
競合する仮説を生成し、並行調査を行うことで、複雑なソフトウェアのバグを解決することがこのSKILLの主な機能です。複数の考えられる根本原因がある問題、複数のモジュールにまたがる問題、または初期のデバッグ試行が失敗した状況に直面している開発者向けに設計されています。競合仮説分析(Analysis of Competing Hypotheses)の手法を適用することで、エージェントは論理エラー、データの問題、状態の問題、統合の失敗、リソースの問題、環境の不一致を含む6つの故障モードカテゴリを体系的に調査できます。
確証バイアスを避けるために、体系的な根本原因分析を行う際は、エージェントはこのSKILLをロードする必要があります。このプロセスでは、直接的、相関的、証言的、またはデータの欠如といった、強度別に分類された構造化されたエビデンスが生成されます。このSKILLは、高い信頼性を維持するために、ファイル名と行番号を使用した厳格な引用形式に依存しています。調査が完了すると、ツールは結果裁定プロトコルを使用して、調査結果を「確定(confirmed)」、「妥当(plausible)」、「反証(falsified)」、または「結論不能(inconclusive)」に分類し、最終的に単一の根本原因が存在するのか、あるいは複合的な問題が存在するのかを判断するのに役立ちます。
エージェントができること
- 1マルチモジュールシステムの障害調査さまざまな故障カテゴリにわたって仮説を生成し、異なるコンポーネントにまたがるバグを分析します。
- 2開発者の確証バイアスの軽減バグのさまざまな潜在的な原因を体系的に評価し、調査の客観性を確保します。
- 3エビデンスに基づいた根本原因の裁定複数の確定した仮説を比較して、システムエラーの最も可能性の高い原因を特定します。
- 4ソフトウェア修正の検証提案された解決策が、新しい問題を引き起こすことなく、特定された根本原因を実際に解決していることを確認します。
skill の SKILL.md から作成されています。すべてのユースケースは、その引用と照合されています。
parallel-debugging skillのインストール方法
各コマンドはskillフォルダをクライアントのskillsディレクトリにコピーします。読み込むには、クライアントを再起動するか新しいセッションを開始してください。プラグインにparallel-debugging skillをインストールする
/plugin marketplace add wshobson/agents /plugin install agent-teams@claude-code-workflows
Claude Codeにparallel-debugging skillをインストールする
~/.claude/skills/parallel-debugging/SKILL.md
$ npx degit wshobson/agents/plugins/agent-teams/skills/parallel-debugging ~/.claude/skills/parallel-debuggingClaude Code (project)にparallel-debugging skillをインストールする
.claude/skills/parallel-debugging/SKILL.md
$ npx degit wshobson/agents/plugins/agent-teams/skills/parallel-debugging .claude/skills/parallel-debuggingCodexにparallel-debugging skillをインストールする
~/.agents/skills/parallel-debugging/SKILL.md
$ npx degit wshobson/agents/plugins/agent-teams/skills/parallel-debugging ~/.agents/skills/parallel-debuggingGemini CLIにparallel-debugging skillをインストールする
~/.gemini/skills/parallel-debugging/SKILL.md
$ npx degit wshobson/agents/plugins/agent-teams/skills/parallel-debugging ~/.gemini/skills/parallel-debuggingClaude.aiにparallel-debugging skillをインストールする
npx degit wshobson/agents/plugins/agent-teams/skills/parallel-debugging parallel-debugging && zip -r parallel-debugging.zip parallel-debugging # claude.ai → Customize → Skills → + → Create skill → Upload a skill → parallel-debugging.zip
自動チェック
実行日 2026年11月15日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。エージェントに実行させる前にスクリプトを読んでください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能wshobson/agents/plugins/agent-teams/skills/parallel-debugging is public and reachablegithub.com/wshobson/agents/tree/HEAD/plugins/agent-teams/ski ↗合格
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit 2026-11-09github.com/wshobson/agents/commits ↗合格
- スクリプトにダウンロード実行や認証情報の窃取がないNo scripts in the skill folder合格
- SKILL.md に隠れた指示がないNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/wshobson/agents/blob/HEAD/plugins/agent-teams/ski ↗合格
- 事前許可ツールが限定されているNo pre-approved tools; the agent asks before using onegithub.com/wshobson/agents/blob/HEAD/plugins/agent-teams/ski ↗合格
- SKILL.md が Agent Skills の形式に従っているValid name and description; says when to use it; 134 linesgithub.com/wshobson/agents/blob/HEAD/plugins/agent-teams/ski ↗合格
SKILL.md
GitHubで表示Parallel Debugging
Framework for debugging complex issues using the Analysis of Competing Hypotheses (ACH) methodology with parallel agent investigation.
When to Use This Skill
- Bug has multiple plausible root causes
- Initial debugging attempts haven't identified the issue
- Issue spans multiple modules or components
- Need systematic root cause analysis with evidence
- Want to avoid confirmation bias in debugging
Hypothesis Generation Framework
Generate hypotheses across 6 failure mode categories:
1. Logic Error
- Incorrect conditional logic (wrong operator, missing case)
- Off-by-one errors in loops or array access
- Missing edge case handling
- Incorrect algorithm implementation
2. Data Issue
- Invalid or unexpected input data
- Type mismatch or coercion error
- Null/undefined/None where value expected
- Encoding or serialization problem
- Data truncation or overflow
3. State Problem
- Race condition between concurrent operations
- Stale cache returning outdated data
- Incorrect initialization or default values
- Unintended mutation of shared state
- State machine transition error
4. Integration Failure
- API contract violation (request/response mismatch)
- Version incompatibility between components
- Configuration mismatch between environments
- Missing or incorrect environment variables
- Network timeout or connection failure
5. Resource Issue
- Memory leak causing gradual degradation
- Connection pool exhaustion
- File descriptor or handle leak
- Disk space or quota exceeded
- CPU saturation from inefficient processing
6. Environment
- Missing runtime dependency
- Wrong library or framework version
- Platform-specific behavior difference
- Permission or access control issue
- Timezone or locale-related behavior
Evidence Collection Standards
What Constitutes Evidence
| Evidence Type | Strength | Example |
|---|---|---|
| Direct | Strong | Code at file.ts:42 shows if (x > 0) should be if (x >= 0) |
| Correlational | Medium | Error rate increased after commit abc123 |
| Testimonial | Weak | "It works on my machine" |
| Absence | Variable | No null check found in the code path |
Citation Format
Always cite evidence with file:line references:
**Evidence**: The validation function at `src/validators/user.ts:87`
does not check for empty strings, only null/undefined. This allows
empty email addresses to pass validation.
Confidence Levels
| Level | Criteria |
|---|---|
| High (>80%) | Multiple direct evidence pieces, clear causal chain, no contradicting evidence |
| Medium (50-80%) | Some direct evidence, plausible causal chain, minor ambiguities |
| Low (<50%) | Mostly correlational evidence, incomplete causal chain, some contradicting evidence |
Result Arbitration Protocol
After all investigators report:
Step 1: Categorize Results
- Confirmed: High confidence, strong evidence, clear causal chain
- Plausible: Medium confidence, some evidence, reasonable causal chain
- Falsified: Evidence contradicts the hypothesis
- Inconclusive: Insufficient evidence to confirm or falsify
Step 2: Compare Confirmed Hypotheses
If multiple hypotheses are confirmed, rank by:
- Confidence level
- Number of supporting evidence pieces
- Strength of causal chain
- Absence of contradicting evidence
Step 3: Determine Root Cause
- If one hypothesis clearly dominates: declare as root cause
- If multiple hypotheses are equally likely: may be compound issue (multiple contributing causes)
- If no hypotheses confirmed: generate new hypotheses based on evidence gathered
Step 4: Validate Fix
Before declaring the bug fixed:
- Fix addresses the identified root cause
- Fix doesn't introduce new issues
- Original reproduction case no longer fails
- Related edge cases are covered
- Relevant tests are added or updated
このスキルのファイル
2parallel-debugging skillに関する質問
Claude Codeにparallel-debugging skillをインストールするには
npx degit wshobson/agents/plugins/agent-teams/skills/parallel-debugging ~/.claude/skills/parallel-debuggingを実行してください。Claude Codeは~/.claude/skills(すべてのプロジェクト)または.claude/skills(単一プロジェクト)からskillsを読み込み、説明がタスクに一致する場合にskillを使用します。
parallel-debugging skillはどのクライアントで使用できますか
Agent Skills形式を読み込むすべてのクライアントで使用できます: Claude Code、Codex、Gemini CLI、claude.ai(ZIPとしてアップロード)。skill内のスクリプトは、クライアントがコード実行を許可した場合にのみ実行されます。
並行デバッグのSKILLはどのような時に使用すべきですか?
バグに複数の考えられる根本原因がある場合、初期のデバッグに失敗した場合、問題が複数のコンポーネントにまたがっている場合、または体系的な根本原因分析が必要な場合に使用してください。
エビデンスの強度はどのように分類されますか?
エビデンスは、Direct(強)、Correlational(中)、Testimonial(弱)、Absence(可変)に分類されます。