[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6H3HTF4CYKQBTWYNEP9PW7R":3,"skill-same:01M6H3HTF4CYKQBTWYNEP9PW7R":101},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":28,"publishedAt":43,"linkOnly":44,"markdownContent":45,"markdownBody":46,"frontMatter":47,"refName":48,"commitSha":49,"skillDirectory":50,"forksCount":51,"repositoryHtmlUrl":52,"repositoryHomepageUrl":6,"ownerHtmlUrl":53,"ownerBlogUrl":54,"ownerDescription":55,"updatedAt":56,"install":57,"resources":70},"01M6H3HTF4CYKQBTWYNEP9PW7R","oma-debug",null,"Bug diagnosis and fixing specialist - analyzes errors, identifies root causes, provides fixes, and writes regression tests. Use for bug, debug, error, crash, traceback, exception, and regression work.","first-fluke\u002Fmapple","first-fluke","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F245837028?v=4","01M6H3H0BFDYMTTET3QPVDG1BZ","First Fluke","01M6H3H0FHPW2AZF69J06PS57T",1,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002Ffirst-fluke\u002Fmapple\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Foma-debug\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[29,30,31,32,33,34,35,36,37,38,39,40,41,42],"debug","oma debug","regression","work","use","crash","bug","tests","diagnosis","error","errors","root","for","fixes","2026-11-10 10:12:30",false,"---\nname: oma-debug\ndescription: Bug diagnosis and fixing specialist - analyzes errors, identifies root causes, provides fixes, and writes regression tests. Use for bug, debug, error, crash, traceback, exception, and regression work.\n---\n\n# Debug Agent - Bug Fixing Specialist\n\n## Scheduling\n\n### Goal\nReproduce, diagnose, minimally fix, and regression-test bugs while preserving scope discipline and documenting root cause.\n\n### Intent signature\n- User reports a bug, crash, traceback, exception, error message, performance issue, intermittent failure, or regression.\n- User needs root cause analysis plus a minimal code fix and regression test.\n\n### When to use\n- User reports a bug with error messages\n- Something is broken and needs fixing\n- Performance issues or slowdowns\n- Intermittent failures or race conditions\n- Regression bugs\n\n### When NOT to use\n- Building new features -> use Frontend\u002FBackend\u002FMobile agents\n- General code review -> use QA Agent\n\n### Expected inputs\n- Error message, failing behavior, reproduction steps, logs, test failure, or affected code path\n- Existing tests, stack traces, environment notes, and suspected regression boundary\n\n### Expected outputs\n- Root cause explanation\n- Minimal fix scoped to the failing behavior\n- Regression test or explicit reason it cannot be added\n- Bug documentation under `.agents\u002Fresults\u002Fbugs\u002F` when appropriate\n\n### Dependencies\n- `resources\u002Fexecution-protocol.md`, examples, checklist, common patterns, and debugging checklist\n- Local codebase search and symbol\u002Freference tools\n- Project test, lint, typecheck, and runtime commands\n\n### Control-flow features\n- Branches by reproduction success, error class, suspected layer, and verification outcome\n- Reads logs\u002Fcode\u002Ftests and writes code\u002Ftests\u002Fdocs\n- Must search for similar patterns after fixing\n\n## Structural Flow\n\n### Entry\n1. Capture the reported symptom and suspected scope.\n2. Reproduce or establish the closest reliable failing signal.\n3. Identify affected files, tests, and related patterns.\n\n### Scenes\n1. **PREPARE**: Gather symptoms, logs, reproduction path, and verification command.\n2. **ACQUIRE**: Read failing code, tests, references, and similar patterns.\n3. **REASON**: Isolate root cause and reject unsupported hypotheses.\n4. **ACT**: Apply minimal fix and regression test.\n5. **VERIFY**: Re-run failing and related checks.\n6. **FINALIZE**: Document root cause, fix, test, and residual risk.\n\n### Transitions\n- If reproduction fails, use logs\u002Ftests to establish a weaker but explicit diagnostic signal.\n- If the first fix fails verification, return to root-cause analysis.\n- If similar patterns exist, inspect and patch only affected cases.\n- If the request is actually feature work, route to the relevant implementation skill.\n\n### Failure and recovery\n- If environment is missing, document the blocker and provide the closest static diagnosis.\n- If no regression test is feasible, explain why and include manual verification.\n- If fix scope grows, stop and call out the broader design issue.\n\n### Exit\n- Success: bug is fixed, regression coverage exists, and checks pass.\n- Partial success: root cause or verification blocker is explicit.\n\n## Logical Operations\n\n### Actions\n| Action | SSL primitive | Evidence |\n|--------|---------------|----------|\n| Reproduce failure | `CALL_TOOL` | Test\u002Fruntime\u002Flog command |\n| Search affected code | `READ` | Code, tests, symbols, references |\n| Compare similar patterns | `COMPARE` | Pattern search |\n| Infer root cause | `INFER` | Diagnostic reasoning |\n| Write minimal fix | `WRITE` | Code patch |\n| Write regression test | `WRITE` | Test patch |\n| Verify behavior | `VALIDATE` | Tests\u002Fchecks |\n| Report result | `NOTIFY` | Root-cause summary |\n\n### Tools and instruments\n- Project test, lint, typecheck, runtime, and logging commands\n- Serena MCP symbol\u002Freference\u002Fpattern search when available\n- Debugging checklist and bug report template\n\n### Canonical workflow path\n```bash\nrg \"\u003Cerror-message-or-symbol>\"\nrg --files\n```\n\nThen run the smallest reproduction command first, add a regression test, and re-run the failing check plus related tests.\n\n### Resource scope\n| Scope | Resource target |\n|-------|-----------------|\n| `CODEBASE` | Failing source, tests, and related patterns |\n| `LOCAL_FS` | Bug reports and result artifacts |\n| `PROCESS` | Reproduction and verification commands |\n| `MEMORY` | Hypotheses, root-cause notes, verification evidence |\n\n### Preconditions\n- A bug signal, symptom, or failing behavior is available.\n- Relevant code and verification path can be inspected or the blocker is stated.\n\n### Effects and side effects\n- Mutates source\u002Ftests only as needed for the fix.\n- May create bug documentation under `.agents\u002Fresults\u002Fbugs\u002F`.\n\n### Guardrails\n1. Reproduce first, then diagnose - never guess at fixes\n2. Identify root cause, not just symptoms\n3. Minimal fix: change only what's necessary\n4. Every fix gets a regression test\n5. Search for similar patterns elsewhere after fixing\n6. Document in `.agents\u002Fresults\u002Fbugs\u002F`\n\n### Serena MCP\n- `find_symbol(\"functionName\")`: Locate the function\n- `find_referencing_symbols(\"Component\")`: Find all usages\n- `search_for_pattern(\"error pattern\")`: Find similar issues\n\n## References\nFollow `resources\u002Fexecution-protocol.md` step by step.\nSee `resources\u002Fexamples.md` for input\u002Foutput examples.\nBefore submitting, run `resources\u002Fchecklist.md`.\nVendor-specific execution protocols are injected automatically by `oma agent:spawn`.\nSource files live under `..\u002F_shared\u002Fruntime\u002Fexecution-protocols\u002F{vendor}.md`.\n- Execution steps: `resources\u002Fexecution-protocol.md`\n- Code examples: `resources\u002Fexamples.md`\n- Checklist: `resources\u002Fchecklist.md`\n- Error recovery: `resources\u002Ferror-playbook.md`\n- Bug report template: `resources\u002Fbug-report-template.md`\n- Common patterns: `resources\u002Fcommon-patterns.md`\n- Debugging checklist: `resources\u002Fdebugging-checklist.md`\n- Context loading: `..\u002F_shared\u002Fcore\u002Fcontext-loading.md`\n- Reasoning templates: `..\u002F_shared\u002Fcore\u002Freasoning-templates.md`\n- Context budget: `..\u002F_shared\u002Fcore\u002Fcontext-budget.md`\n- Lessons learned: `..\u002F_shared\u002Fcore\u002Flessons-learned.md`\n- Observability handoff: `..\u002Foma-observability\u002FSKILL.md` §Integrations — traces\u002Flogs by `trace_id`, 6-dim forensics\n","# Debug Agent - Bug Fixing Specialist\n\n## Scheduling\n\n### Goal\nReproduce, diagnose, minimally fix, and regression-test bugs while preserving scope discipline and documenting root cause.\n\n### Intent signature\n- User reports a bug, crash, traceback, exception, error message, performance issue, intermittent failure, or regression.\n- User needs root cause analysis plus a minimal code fix and regression test.\n\n### When to use\n- User reports a bug with error messages\n- Something is broken and needs fixing\n- Performance issues or slowdowns\n- Intermittent failures or race conditions\n- Regression bugs\n\n### When NOT to use\n- Building new features -> use Frontend\u002FBackend\u002FMobile agents\n- General code review -> use QA Agent\n\n### Expected inputs\n- Error message, failing behavior, reproduction steps, logs, test failure, or affected code path\n- Existing tests, stack traces, environment notes, and suspected regression boundary\n\n### Expected outputs\n- Root cause explanation\n- Minimal fix scoped to the failing behavior\n- Regression test or explicit reason it cannot be added\n- Bug documentation under `.agents\u002Fresults\u002Fbugs\u002F` when appropriate\n\n### Dependencies\n- `resources\u002Fexecution-protocol.md`, examples, checklist, common patterns, and debugging checklist\n- Local codebase search and symbol\u002Freference tools\n- Project test, lint, typecheck, and runtime commands\n\n### Control-flow features\n- Branches by reproduction success, error class, suspected layer, and verification outcome\n- Reads logs\u002Fcode\u002Ftests and writes code\u002Ftests\u002Fdocs\n- Must search for similar patterns after fixing\n\n## Structural Flow\n\n### Entry\n1. Capture the reported symptom and suspected scope.\n2. Reproduce or establish the closest reliable failing signal.\n3. Identify affected files, tests, and related patterns.\n\n### Scenes\n1. **PREPARE**: Gather symptoms, logs, reproduction path, and verification command.\n2. **ACQUIRE**: Read failing code, tests, references, and similar patterns.\n3. **REASON**: Isolate root cause and reject unsupported hypotheses.\n4. **ACT**: Apply minimal fix and regression test.\n5. **VERIFY**: Re-run failing and related checks.\n6. **FINALIZE**: Document root cause, fix, test, and residual risk.\n\n### Transitions\n- If reproduction fails, use logs\u002Ftests to establish a weaker but explicit diagnostic signal.\n- If the first fix fails verification, return to root-cause analysis.\n- If similar patterns exist, inspect and patch only affected cases.\n- If the request is actually feature work, route to the relevant implementation skill.\n\n### Failure and recovery\n- If environment is missing, document the blocker and provide the closest static diagnosis.\n- If no regression test is feasible, explain why and include manual verification.\n- If fix scope grows, stop and call out the broader design issue.\n\n### Exit\n- Success: bug is fixed, regression coverage exists, and checks pass.\n- Partial success: root cause or verification blocker is explicit.\n\n## Logical Operations\n\n### Actions\n| Action | SSL primitive | Evidence |\n|--------|---------------|----------|\n| Reproduce failure | `CALL_TOOL` | Test\u002Fruntime\u002Flog command |\n| Search affected code | `READ` | Code, tests, symbols, references |\n| Compare similar patterns | `COMPARE` | Pattern search |\n| Infer root cause | `INFER` | Diagnostic reasoning |\n| Write minimal fix | `WRITE` | Code patch |\n| Write regression test | `WRITE` | Test patch |\n| Verify behavior | `VALIDATE` | Tests\u002Fchecks |\n| Report result | `NOTIFY` | Root-cause summary |\n\n### Tools and instruments\n- Project test, lint, typecheck, runtime, and logging commands\n- Serena MCP symbol\u002Freference\u002Fpattern search when available\n- Debugging checklist and bug report template\n\n### Canonical workflow path\n```bash\nrg \"\u003Cerror-message-or-symbol>\"\nrg --files\n```\n\nThen run the smallest reproduction command first, add a regression test, and re-run the failing check plus related tests.\n\n### Resource scope\n| Scope | Resource target |\n|-------|-----------------|\n| `CODEBASE` | Failing source, tests, and related patterns |\n| `LOCAL_FS` | Bug reports and result artifacts |\n| `PROCESS` | Reproduction and verification commands |\n| `MEMORY` | Hypotheses, root-cause notes, verification evidence |\n\n### Preconditions\n- A bug signal, symptom, or failing behavior is available.\n- Relevant code and verification path can be inspected or the blocker is stated.\n\n### Effects and side effects\n- Mutates source\u002Ftests only as needed for the fix.\n- May create bug documentation under `.agents\u002Fresults\u002Fbugs\u002F`.\n\n### Guardrails\n1. Reproduce first, then diagnose - never guess at fixes\n2. Identify root cause, not just symptoms\n3. Minimal fix: change only what's necessary\n4. Every fix gets a regression test\n5. Search for similar patterns elsewhere after fixing\n6. Document in `.agents\u002Fresults\u002Fbugs\u002F`\n\n### Serena MCP\n- `find_symbol(\"functionName\")`: Locate the function\n- `find_referencing_symbols(\"Component\")`: Find all usages\n- `search_for_pattern(\"error pattern\")`: Find similar issues\n\n## References\nFollow `resources\u002Fexecution-protocol.md` step by step.\nSee `resources\u002Fexamples.md` for input\u002Foutput examples.\nBefore submitting, run `resources\u002Fchecklist.md`.\nVendor-specific execution protocols are injected automatically by `oma agent:spawn`.\nSource files live under `..\u002F_shared\u002Fruntime\u002Fexecution-protocols\u002F{vendor}.md`.\n- Execution steps: `resources\u002Fexecution-protocol.md`\n- Code examples: `resources\u002Fexamples.md`\n- Checklist: `resources\u002Fchecklist.md`\n- Error recovery: `resources\u002Ferror-playbook.md`\n- Bug report template: `resources\u002Fbug-report-template.md`\n- Common patterns: `resources\u002Fcommon-patterns.md`\n- Debugging checklist: `resources\u002Fdebugging-checklist.md`\n- Context loading: `..\u002F_shared\u002Fcore\u002Fcontext-loading.md`\n- Reasoning templates: `..\u002F_shared\u002Fcore\u002Freasoning-templates.md`\n- Context budget: `..\u002F_shared\u002Fcore\u002Fcontext-budget.md`\n- Lessons learned: `..\u002F_shared\u002Fcore\u002Flessons-learned.md`\n- Observability handoff: `..\u002Foma-observability\u002FSKILL.md` §Integrations — traces\u002Flogs by `trace_id`, 6-dim forensics\n",{"name":5,"description":7},"main","faa5b71f133b677d6ce9fda180c32274524b8be8",".agents\u002Fskills\u002Foma-debug",0,"https:\u002F\u002Fgithub.com\u002Ffirst-fluke\u002Fmapple","https:\u002F\u002Fgithub.com\u002Ffirst-fluke","https:\u002F\u002Ffirstfluke.com","An engineering-first collective building scalable, AI-native software and infrastructure.","2026-06-20 23:18:56",{"source":8,"skillName":5,"commands":58,"prompt":68,"zipAvailable":69},[59,62,65],{"tool":60,"command":61},"npx","npx skills add first-fluke\u002Fmapple --skill oma-debug",{"tool":63,"command":64},"bunx","bunx skills add first-fluke\u002Fmapple --skill oma-debug",{"tool":66,"command":67},"pnpm","pnpm dlx skills add first-fluke\u002Fmapple --skill oma-debug","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Ffirst-fluke\u002Fmapple\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Foma-debug\u002FSKILL.md",true,[71,77,81,85,89,93,97],{"path":72,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":75,"sourceHtmlUrl":76},"resources\u002Fbug-report-template.md","REFERENCE","参考文档",7373,"https:\u002F\u002Fgithub.com\u002Ffirst-fluke\u002Fmapple\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Foma-debug\u002Fresources\u002Fbug-report-template.md",{"path":78,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":79,"sourceHtmlUrl":80},"resources\u002Fchecklist.md",1063,"https:\u002F\u002Fgithub.com\u002Ffirst-fluke\u002Fmapple\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Foma-debug\u002Fresources\u002Fchecklist.md",{"path":82,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":83,"sourceHtmlUrl":84},"resources\u002Fcommon-patterns.md",14982,"https:\u002F\u002Fgithub.com\u002Ffirst-fluke\u002Fmapple\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Foma-debug\u002Fresources\u002Fcommon-patterns.md",{"path":86,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":87,"sourceHtmlUrl":88},"resources\u002Fdebugging-checklist.md",9935,"https:\u002F\u002Fgithub.com\u002Ffirst-fluke\u002Fmapple\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Foma-debug\u002Fresources\u002Fdebugging-checklist.md",{"path":90,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":91,"sourceHtmlUrl":92},"resources\u002Ferror-playbook.md",3449,"https:\u002F\u002Fgithub.com\u002Ffirst-fluke\u002Fmapple\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Foma-debug\u002Fresources\u002Ferror-playbook.md",{"path":94,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":95,"sourceHtmlUrl":96},"resources\u002Fexamples.md",2261,"https:\u002F\u002Fgithub.com\u002Ffirst-fluke\u002Fmapple\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Foma-debug\u002Fresources\u002Fexamples.md",{"path":98,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":99,"sourceHtmlUrl":100},"resources\u002Fexecution-protocol.md",2371,"https:\u002F\u002Fgithub.com\u002Ffirst-fluke\u002Fmapple\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Foma-debug\u002Fresources\u002Fexecution-protocol.md",[102,107,117,123,130,139],{"skillNo":103,"name":32,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":43},"01M6H3TQ55F8DE50S0AR3J44MG","https:\u002F\u002Fgithub.com\u002Ffirst-fluke\u002Fmapple\u002Fblob\u002Fmain\u002F.qwen\u002Fskills\u002Fwork\u002FSKILL.md",[],[32],{"skillNo":108,"name":109,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":110,"categories":111,"keywords":115,"publishedAt":43},"01M6H3TMBRRDMJMRENBJH8P4V9","video","https:\u002F\u002Fgithub.com\u002Ffirst-fluke\u002Fmapple\u002Fblob\u002Fmain\u002F.qwen\u002Fskills\u002Fvideo\u002FSKILL.md",[112],{"categoryNo":113,"categoryName":114,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000016","图像与多媒体",[116],"Video",{"skillNo":118,"name":119,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":120,"categories":121,"keywords":122,"publishedAt":43},"01M6H3TH7EMW9YEX66GB83C1GF","ultrawork","https:\u002F\u002Fgithub.com\u002Ffirst-fluke\u002Fmapple\u002Fblob\u002Fmain\u002F.qwen\u002Fskills\u002Fultrawork\u002FSKILL.md",[],[119],{"skillNo":124,"name":125,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":126,"categories":127,"keywords":128,"publishedAt":43},"01M6H3TEHMS3Y8KR2GA1R6K1KV","tools","https:\u002F\u002Fgithub.com\u002Ffirst-fluke\u002Fmapple\u002Fblob\u002Fmain\u002F.qwen\u002Fskills\u002Ftools\u002FSKILL.md",[],[129],"Tools",{"skillNo":131,"name":132,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":133,"categories":134,"keywords":135,"publishedAt":43},"01M6H3TC4Z8XVX21DJB7SSG24M","stack-set","https:\u002F\u002Fgithub.com\u002Ffirst-fluke\u002Fmapple\u002Fblob\u002Fmain\u002F.qwen\u002Fskills\u002Fstack-set\u002FSKILL.md",[],[136,137,138],"SET","stack","stack set",{"skillNo":140,"name":141,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":142,"categories":143,"keywords":144,"publishedAt":43},"01M6H3T8SPSFYERV58YKAS5W9D","scm","https:\u002F\u002Fgithub.com\u002Ffirst-fluke\u002Fmapple\u002Fblob\u002Fmain\u002F.qwen\u002Fskills\u002Fscm\u002FSKILL.md",[],[141]]