[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6XC0XAMF6GZFXJ895TKCP52":3,"skill-same:01M6XC0XAMF6GZFXJ895TKCP52":70},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":27,"publishedAt":39,"linkOnly":40,"markdownContent":41,"markdownBody":42,"frontMatter":43,"refName":44,"commitSha":45,"skillDirectory":46,"forksCount":13,"repositoryHtmlUrl":47,"repositoryHomepageUrl":6,"ownerHtmlUrl":48,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":49,"install":50,"resources":63},"01M6XC0XAMF6GZFXJ895TKCP52","shell-error-debug-workflow",null,"Systematic workflow for diagnosing and resolving unknown errors from run_shell commands","UF-gzj\u002Fopenspace-claude-evolution","UF-gzj","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F272393507?v=4","01M6XBCZB755P01VVYGQWPYZY3","01M6XBCZFJA5AREA17WGETA3FW",0,"MIT","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fshell-error-debug-workflow\u002FSKILL.md",[17,22],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",{"categoryNo":23,"categoryName":24,"taxonomyType":25,"taxonomyTypeDesc":26},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[28,29,30,31,32,33,34,35,36,37,38],"workflow","debug","shell","error","shell error debug workflow","run","commands","systematic","errors","for","unknown","2026-11-10 10:12:30",false,"---\nname: shell-error-debug-workflow\ndescription: Systematic workflow for diagnosing and resolving unknown errors from run_shell commands\n---\n\n# Shell Error Debug Workflow\n\nWhen `run_shell` returns an 'unknown error' or ambiguous failure, apply this systematic troubleshooting workflow to diagnose and resolve the issue.\n\n## When to Use This Skill\n\n- `run_shell` returns an 'unknown error' message\n- Shell command fails without clear error output\n- Command works locally but fails in the agent environment\n- Intermittent or unexplained shell failures\n\n## Step-by-Step Troubleshooting Workflow\n\n### Step 1: Capture Explicit Stderr\n\nRedirect stderr to stdout to capture all error output:\n\n```bash\n# Instead of:\nrun_shell command=\"some-command\"\n\n# Use:\nrun_shell command=\"some-command 2>&1\"\n```\n\nThis ensures error messages are captured in the output rather than being lost.\n\n### Step 2: Verify Working Directory\n\nConfirm the current working directory and its contents:\n\n```bash\nrun_shell command=\"pwd && ls -la\"\n```\n\nCheck that:\n- You're in the expected directory\n- Required files\u002Fdirectories exist\n- Permissions are correct\n\n### Step 3: Check Tool\u002FCommand Availability\n\nVerify the required command or tool exists and is accessible:\n\n```bash\nrun_shell command=\"which some-command || command -v some-command || type some-command\"\n```\n\nIf the tool is not found, check PATH or install the required package.\n\n### Step 4: Use Absolute Paths\n\nReplace relative paths with absolute paths to avoid directory-related issues:\n\n```bash\n# Instead of:\nrun_shell command=\"python script.py\"\n\n# Use:\nrun_shell command=\"$(pwd)\u002Fscript.py\"\n# or\nrun_shell command=\"\u002Fabsolute\u002Fpath\u002Fto\u002Fscript.py\"\n```\n\n### Step 5: Test with Minimal Command\n\nIsolate the issue by running a minimal version of the command:\n\n```bash\n# Test basic functionality first\nrun_shell command=\"echo 'test'\"\n\n# Then gradually add complexity\nrun_shell command=\"some-command --version\"\nrun_shell command=\"some-command --help\"\n```\n\n### Step 6: Check Environment Variables\n\nSome commands depend on specific environment variables:\n\n```bash\nrun_shell command=\"env | grep -i relevant_var\"\n```\n\n## Complete Diagnostic Sequence\n\nFor persistent unknown errors, run this complete diagnostic:\n\n```bash\n# 1. Capture full environment\nrun_shell command=\"pwd && echo '---' && ls -la && echo '---' && env\"\n\n# 2. Test command with full error capture\nrun_shell command=\"your-command 2>&1 | head -50\"\n\n# 3. Check command availability\nrun_shell command=\"which your-command || echo 'Command not found in PATH'\"\n\n# 4. Try with absolute path\nrun_shell command=\"\u002Ffull\u002Fpath\u002Fto\u002Fyour-command 2>&1\"\n```\n\n## Common Causes and Solutions\n\n| Symptom | Likely Cause | Solution |\n|---------|-------------|----------|\n| No output, unknown error | stderr not captured | Add `2>&1` to command |\n| File not found | Wrong working directory | Use `pwd` to verify, use absolute paths |\n| Permission denied | File\u002Fdirectory permissions | Check with `ls -la`, adjust permissions |\n| Command not found | Tool not installed or not in PATH | Use `which` to check, install or specify full path |\n| Intermittent failures | Race conditions or timing | Add delays, check for file locks |\n\n## Example: Troubleshooting a Python Script Failure\n\n```bash\n# Initial failing command\nrun_shell command=\"python process.py\"\n# Returns: unknown error\n\n# Apply diagnostic workflow:\n# Step 1: Capture stderr\nrun_shell command=\"python process.py 2>&1\"\n\n# Step 2: Verify directory\nrun_shell command=\"pwd && ls -la\"\n\n# Step 3: Check Python availability\nrun_shell command=\"which python && python --version\"\n\n# Step 4: Use absolute path\nrun_shell command=\"$(pwd)\u002Fprocess.py 2>&1\"\n# or\nrun_shell command=\"\u002Fusr\u002Fbin\u002Fpython3 $(pwd)\u002Fprocess.py 2>&1\"\n```\n\n## Best Practices\n\n1. **Always capture stderr** when debugging: `2>&1`\n2. **Verify assumptions** about working directory and file locations\n3. **Start simple** before running complex commands\n4. **Use absolute paths** in production\u002Frepeatable scripts\n5. **Check tool versions** when behavior seems inconsistent\n6. **Document environment** when errors are hard to reproduce\n\n## When to Escalate\n\nIf this workflow does not resolve the issue:\n- The error may be environmental (container\u002Fruntime specific)\n- Consider using `shell_agent` for complex shell tasks that require autonomous error handling\n- Check for resource constraints (disk space, memory, timeouts)","# Shell Error Debug Workflow\n\nWhen `run_shell` returns an 'unknown error' or ambiguous failure, apply this systematic troubleshooting workflow to diagnose and resolve the issue.\n\n## When to Use This Skill\n\n- `run_shell` returns an 'unknown error' message\n- Shell command fails without clear error output\n- Command works locally but fails in the agent environment\n- Intermittent or unexplained shell failures\n\n## Step-by-Step Troubleshooting Workflow\n\n### Step 1: Capture Explicit Stderr\n\nRedirect stderr to stdout to capture all error output:\n\n```bash\n# Instead of:\nrun_shell command=\"some-command\"\n\n# Use:\nrun_shell command=\"some-command 2>&1\"\n```\n\nThis ensures error messages are captured in the output rather than being lost.\n\n### Step 2: Verify Working Directory\n\nConfirm the current working directory and its contents:\n\n```bash\nrun_shell command=\"pwd && ls -la\"\n```\n\nCheck that:\n- You're in the expected directory\n- Required files\u002Fdirectories exist\n- Permissions are correct\n\n### Step 3: Check Tool\u002FCommand Availability\n\nVerify the required command or tool exists and is accessible:\n\n```bash\nrun_shell command=\"which some-command || command -v some-command || type some-command\"\n```\n\nIf the tool is not found, check PATH or install the required package.\n\n### Step 4: Use Absolute Paths\n\nReplace relative paths with absolute paths to avoid directory-related issues:\n\n```bash\n# Instead of:\nrun_shell command=\"python script.py\"\n\n# Use:\nrun_shell command=\"$(pwd)\u002Fscript.py\"\n# or\nrun_shell command=\"\u002Fabsolute\u002Fpath\u002Fto\u002Fscript.py\"\n```\n\n### Step 5: Test with Minimal Command\n\nIsolate the issue by running a minimal version of the command:\n\n```bash\n# Test basic functionality first\nrun_shell command=\"echo 'test'\"\n\n# Then gradually add complexity\nrun_shell command=\"some-command --version\"\nrun_shell command=\"some-command --help\"\n```\n\n### Step 6: Check Environment Variables\n\nSome commands depend on specific environment variables:\n\n```bash\nrun_shell command=\"env | grep -i relevant_var\"\n```\n\n## Complete Diagnostic Sequence\n\nFor persistent unknown errors, run this complete diagnostic:\n\n```bash\n# 1. Capture full environment\nrun_shell command=\"pwd && echo '---' && ls -la && echo '---' && env\"\n\n# 2. Test command with full error capture\nrun_shell command=\"your-command 2>&1 | head -50\"\n\n# 3. Check command availability\nrun_shell command=\"which your-command || echo 'Command not found in PATH'\"\n\n# 4. Try with absolute path\nrun_shell command=\"\u002Ffull\u002Fpath\u002Fto\u002Fyour-command 2>&1\"\n```\n\n## Common Causes and Solutions\n\n| Symptom | Likely Cause | Solution |\n|---------|-------------|----------|\n| No output, unknown error | stderr not captured | Add `2>&1` to command |\n| File not found | Wrong working directory | Use `pwd` to verify, use absolute paths |\n| Permission denied | File\u002Fdirectory permissions | Check with `ls -la`, adjust permissions |\n| Command not found | Tool not installed or not in PATH | Use `which` to check, install or specify full path |\n| Intermittent failures | Race conditions or timing | Add delays, check for file locks |\n\n## Example: Troubleshooting a Python Script Failure\n\n```bash\n# Initial failing command\nrun_shell command=\"python process.py\"\n# Returns: unknown error\n\n# Apply diagnostic workflow:\n# Step 1: Capture stderr\nrun_shell command=\"python process.py 2>&1\"\n\n# Step 2: Verify directory\nrun_shell command=\"pwd && ls -la\"\n\n# Step 3: Check Python availability\nrun_shell command=\"which python && python --version\"\n\n# Step 4: Use absolute path\nrun_shell command=\"$(pwd)\u002Fprocess.py 2>&1\"\n# or\nrun_shell command=\"\u002Fusr\u002Fbin\u002Fpython3 $(pwd)\u002Fprocess.py 2>&1\"\n```\n\n## Best Practices\n\n1. **Always capture stderr** when debugging: `2>&1`\n2. **Verify assumptions** about working directory and file locations\n3. **Start simple** before running complex commands\n4. **Use absolute paths** in production\u002Frepeatable scripts\n5. **Check tool versions** when behavior seems inconsistent\n6. **Document environment** when errors are hard to reproduce\n\n## When to Escalate\n\nIf this workflow does not resolve the issue:\n- The error may be environmental (container\u002Fruntime specific)\n- Consider using `shell_agent` for complex shell tasks that require autonomous error handling\n- Check for resource constraints (disk space, memory, timeouts)",{"name":5,"description":7},"main","0650921d63895de3997bc81f1ff1d0ac67032072","gdpval_bench\u002Fskills\u002Fshell-error-debug-workflow","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution","https:\u002F\u002Fgithub.com\u002FUF-gzj","2026-04-16 09:31:03",{"source":8,"skillName":5,"commands":51,"prompt":61,"zipAvailable":62},[52,55,58],{"tool":53,"command":54},"npx","npx skills add UF-gzj\u002Fopenspace-claude-evolution --skill shell-error-debug-workflow",{"tool":56,"command":57},"bunx","bunx skills add UF-gzj\u002Fopenspace-claude-evolution --skill shell-error-debug-workflow",{"tool":59,"command":60},"pnpm","pnpm dlx skills add UF-gzj\u002Fopenspace-claude-evolution --skill shell-error-debug-workflow","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fshell-error-debug-workflow\u002FSKILL.md",true,[64],{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},".skill_id","OTHER","其他",40,"https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fshell-error-debug-workflow\u002F.skill_id",[71,94,111,119,147,163],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":39},"01M6XCCXD3NCM2YKR3WNGBASPC","write-special-chars-ts-check","Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, plus a reliable TypeScript type-checking step that filters output to only the newly-written files to avoid being misled by pre-existing errors.","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fwrite-special-chars-ts-check\u002FSKILL.md",[],[78,79,80,81,82,83,84,85,37,36,86,87,88,89,90,91,92,93],"check","write","write special chars ts check","typescript","filters","characters","Existing","type-checking","script","output","type","files","only","template","file","python",{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":39},"01M6XCCT7E3J922Q345PBGSHPN","write-special-chars-readback","Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, with mandatory post-write verification via read_file and cleanup of \u002Ftmp helper scripts.","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fwrite-special-chars-readback\u002FSKILL.md",[],[101,102,79,92,103,93,104,105,106,107,108,91,109,110,83,37,86],"readback","write special chars readback","helper","post","via","scripts","cleanup","read","verification","with",{"skillNo":112,"name":113,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":39},"01M6XCCMQX1R8B6FECWB3P63T7","write-special-chars-heredoc","Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) by using a Python heredoc script executed via shell.","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fwrite-special-chars-heredoc\u002FSKILL.md",[],[118,79,83,30,86,105,91,92,93,37],"write special chars heredoc",{"skillNo":120,"name":121,"nameZh":6,"description":122,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":123,"categories":124,"keywords":128,"publishedAt":39},"01M6XCCG41M994JJEX6VN52PEP","worldmonitor-reference","Curated architecture index of the WorldMonitor open-source dashboard. Reference for extracting patterns — vanilla TypeScript, Panel class hierarchy, service layer, CSS grid, API edge functions, refresh scheduler, and 60+ data source integrations.","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fworldmonitor-reference\u002FSKILL.md",[125],{"categoryNo":126,"categoryName":127,"taxonomyType":25,"taxonomyTypeDesc":26},"01JBSEEDCAT000000000000033","数据分析师",[129,130,131,132,133,81,134,135,136,137,138,37,139,140,141,142,143,144,145,146],"reference","worldmonitor","worldmonitor reference","architecture","dashboard","css","scheduler","layer","hierarchy","source","extracting","panel","patterns","edge functions","integrations","open","api","data",{"skillNo":148,"name":149,"nameZh":6,"description":150,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":151,"categories":152,"keywords":153,"publishedAt":39},"01M6XCCCHWNKG2W4VH9E6A10HF","virtual-list","Implement efficient virtual scrolling for rendering large lists with DOM recycling, chunk-based rendering, and performance optimizations","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fvirtual-list\u002FSKILL.md",[],[154,155,156,157,37,158,110,159,160,161,162],"virtual list","list","virtual","chunk","dom","rendering","recycling","implement","performance",{"skillNo":164,"name":165,"nameZh":6,"description":166,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":167,"categories":168,"keywords":169,"publishedAt":39},"01M6XCC7X8PKMR2DEW91XGHYSV","verify-directory-structure","Diagnose and resolve file access issues by first verifying the directory structure.","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fverify-directory-structure\u002FSKILL.md",[],[170,171,172,173,174,175,92,176,177,178],"directory","verify directory structure","structure","verify","access","first","issues","diagnose","file access"]