adapter-tool-flow-debugging
CommunityTrace and fix Claude runtime tool-flow bugs
Software Engineering#debugging#trace#async#tool execution#prompt construction#claudecode#mathematica
Authortransreal
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Adapter-path ClaudeEval in runtime mode can silently fail or loop, producing missing tool results, hallucinated answers, or no final notebook output, leaving users unable to understand where the turn pipeline broke.
Core Features & Use Cases
- Symptom-driven fault isolation: Maps common runtime anomalies (tool_call text leaking, repeated web search, “過去の検索結果が見えない”, missing final text, stuck phases) to the most likely internal responsibility area.
- Turn and event trace triage: Guides users to inspect ClaudeTurnTrace for the correct lifecycle sequence and detect abnormal endings (e.g., tool loops, budget exhaustion, finalize/text skip patterns).
- ConversationState and tool-result verification: Helps verify whether tool calls/results were recorded, whether prompts include rich results, and whether the final proposal text exists even when notebook rendering fails.
- AsyncToolExec pipeline diagnosis: Provides targeted checks for polling tick registration, AsyncToolExec progress, finalize/continuation scheduling, and lingering polling-tick residues.
Quick Start
Run the skill by asking your AI to diagnose a “ClaudeRuntime adapter tool-flow malfunction” using ClaudeRateLimitStatus[], ClaudeTurnTrace[$ClaudeLastRuntimeId], and ConversationState.Messages to pinpoint the failing stage.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: adapter-tool-flow-debugging Download link: https://github.com/transreal/claudecode/archive/main.zip#adapter-tool-flow-debugging Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.