[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CTYT50GDD2876DC2NHKM0M":3,"skill-same:01M7CTYT50GDD2876DC2NHKM0M":70},{"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":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M7CTYT50GDD2876DC2NHKM0M","systematic-debugging",null,"Use when a stubborn, flaky or cross-system MDE failure needs deep multi-step root-cause tracing; consult from errors when a focused reproduction and hypothesis do not isolate the cause.","amoai-tech\u002Fmdeai","amoai-tech","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F320616881?v=4","01M7CTJYGWP82J2HHMQC5NN9JP","amo","01M7CTJYHE5YQRGQSDJES3Z0QE",2,"MIT","https:\u002F\u002Fgithub.com\u002Famoai-tech\u002Fmdeai\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: systematic-debugging\ndescription: >-\n  Use when a stubborn, flaky or cross-system MDE failure needs deep multi-step root-cause tracing; consult from errors when a focused reproduction and hypothesis do not isolate the cause.\n\n---\n\n# Systematic Debugging\n\n## Purpose\n\nFind the root cause before changing behavior. Treat symptoms, reviewer guesses, and error messages as evidence to test, not fixes to apply blindly.\n\n## MDE ownership\n\nUse this skill to diagnose. Once the failure is localized, use `testing` to lock it into a regression test and apply RED → GREEN → REFACTOR, the affected domain skill for implementation-specific rules, `code-review` to review the patch, and `task-verifier` to prove the task or PR is complete.\n\n## Workflow\n\n1. **Reproduce** the failure with the smallest reliable command, request, or user journey.\n2. **Capture evidence**: exact error, inputs, environment, branch\u002Fcommit, affected boundary, and whether the failure is deterministic.\n3. **Trace backward** from the bad value or failed boundary until the first incorrect assumption\u002Fstate transition is found.\n4. **Form one hypothesis** that explains the evidence.\n5. **Run the smallest experiment** that can falsify that hypothesis. Change one variable at a time.\n6. **Write or update a regression test** when the behavior is testable.\n7. **Apply the smallest root-cause fix**. Do not bundle unrelated cleanup.\n8. **Re-run the reproduction + targeted tests + affected journey**.\n9. **Escalate the proof** only if the risk warrants it: typecheck\u002Flint\u002Fbuild, integration\u002FE2E, live service, or production smoke.\n\n## Boundary debugging\n\nFor MDE integrations, record the value at each boundary instead of guessing which layer failed:\n\n`UI → Next.js route\u002Fserver action → CopilotKit\u002FAG-UI → Mastra → domain tool → Supabase\u002FStripe\u002FMaps\u002FCloudinary → response\u002FUI`\n\nAt each boundary verify: input shape, auth\u002Ftenant context, IDs, timeout\u002Fcancellation, side effects, output shape, and error propagation.\n\n## Stop conditions\n\nStop proposing fixes when you cannot reproduce or localize the failure. Gather more evidence instead. Stop if the proposed patch only suppresses an error, retries indefinitely, weakens authorization, bypasses validation\u002FHITL, or changes unrelated behavior.\n\n## Common traps\n\n- \"This looks like X\" without proving X.\n- Changing multiple variables before rerunning.\n- Treating a green unit test as proof of routing\u002Fintegration behavior.\n- Fixing the caller when the source data is already wrong.\n- Adding fallback behavior that hides a broken authoritative path.\n- Rerunning flaky tests until green without explaining the flake.\n\n## References\n\nRead only when needed:\n- [`references\u002Froot-cause-tracing.md`](references\u002Froot-cause-tracing.md) — trace bad values backward.\n- [`references\u002Fcondition-based-waiting.md`](references\u002Fcondition-based-waiting.md) — timing\u002Frace failures.\n- [`references\u002Fdefense-in-depth.md`](references\u002Fdefense-in-depth.md) — validation across trust boundaries.\n- [`scripts\u002Ffind-polluter.sh`](scripts\u002Ffind-polluter.sh) — deterministic test-pollution helper.\n","# Systematic Debugging\n\n## Purpose\n\nFind the root cause before changing behavior. Treat symptoms, reviewer guesses, and error messages as evidence to test, not fixes to apply blindly.\n\n## MDE ownership\n\nUse this skill to diagnose. Once the failure is localized, use `testing` to lock it into a regression test and apply RED → GREEN → REFACTOR, the affected domain skill for implementation-specific rules, `code-review` to review the patch, and `task-verifier` to prove the task or PR is complete.\n\n## Workflow\n\n1. **Reproduce** the failure with the smallest reliable command, request, or user journey.\n2. **Capture evidence**: exact error, inputs, environment, branch\u002Fcommit, affected boundary, and whether the failure is deterministic.\n3. **Trace backward** from the bad value or failed boundary until the first incorrect assumption\u002Fstate transition is found.\n4. **Form one hypothesis** that explains the evidence.\n5. **Run the smallest experiment** that can falsify that hypothesis. Change one variable at a time.\n6. **Write or update a regression test** when the behavior is testable.\n7. **Apply the smallest root-cause fix**. Do not bundle unrelated cleanup.\n8. **Re-run the reproduction + targeted tests + affected journey**.\n9. **Escalate the proof** only if the risk warrants it: typecheck\u002Flint\u002Fbuild, integration\u002FE2E, live service, or production smoke.\n\n## Boundary debugging\n\nFor MDE integrations, record the value at each boundary instead of guessing which layer failed:\n\n`UI → Next.js route\u002Fserver action → CopilotKit\u002FAG-UI → Mastra → domain tool → Supabase\u002FStripe\u002FMaps\u002FCloudinary → response\u002FUI`\n\nAt each boundary verify: input shape, auth\u002Ftenant context, IDs, timeout\u002Fcancellation, side effects, output shape, and error propagation.\n\n## Stop conditions\n\nStop proposing fixes when you cannot reproduce or localize the failure. Gather more evidence instead. Stop if the proposed patch only suppresses an error, retries indefinitely, weakens authorization, bypasses validation\u002FHITL, or changes unrelated behavior.\n\n## Common traps\n\n- \"This looks like X\" without proving X.\n- Changing multiple variables before rerunning.\n- Treating a green unit test as proof of routing\u002Fintegration behavior.\n- Fixing the caller when the source data is already wrong.\n- Adding fallback behavior that hides a broken authoritative path.\n- Rerunning flaky tests until green without explaining the flake.\n\n## References\n\nRead only when needed:\n- [`references\u002Froot-cause-tracing.md`](references\u002Froot-cause-tracing.md) — trace bad values backward.\n- [`references\u002Fcondition-based-waiting.md`](references\u002Fcondition-based-waiting.md) — timing\u002Frace failures.\n- [`references\u002Fdefense-in-depth.md`](references\u002Fdefense-in-depth.md) — validation across trust boundaries.\n- [`scripts\u002Ffind-polluter.sh`](scripts\u002Ffind-polluter.sh) — deterministic test-pollution helper.\n",{"name":5,"description":7},"main","9955f6a8aa5de3c14fea562c7e6b72973366ba3c",".claude\u002Fskills\u002Fsystematic-debugging",1,"https:\u002F\u002Fgithub.com\u002Famoai-tech\u002Fmdeai","https:\u002F\u002Fmdeai-psi.vercel.app","https:\u002F\u002Fgithub.com\u002Famoai-tech","2026-11-13 03:54:16",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add amoai-tech\u002Fmdeai --skill systematic-debugging",{"tool":38,"command":39},"bunx","bunx skills add amoai-tech\u002Fmdeai --skill systematic-debugging",{"tool":41,"command":42},"pnpm","pnpm dlx skills add amoai-tech\u002Fmdeai --skill systematic-debugging","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Famoai-tech\u002Fmdeai\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",true,[46,52,56,60,64],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"evals\u002Fevals.json","REFERENCE","参考文档",605,"https:\u002F\u002Fgithub.com\u002Famoai-tech\u002Fmdeai\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fsystematic-debugging\u002Fevals\u002Fevals.json",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Fcondition-based-waiting.md",3516,"https:\u002F\u002Fgithub.com\u002Famoai-tech\u002Fmdeai\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fsystematic-debugging\u002Freferences\u002Fcondition-based-waiting.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"references\u002Fdefense-in-depth.md",3650,"https:\u002F\u002Fgithub.com\u002Famoai-tech\u002Fmdeai\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fsystematic-debugging\u002Freferences\u002Fdefense-in-depth.md",{"path":61,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":62,"sourceHtmlUrl":63},"references\u002Froot-cause-tracing.md",5325,"https:\u002F\u002Fgithub.com\u002Famoai-tech\u002Fmdeai\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fsystematic-debugging\u002Freferences\u002Froot-cause-tracing.md",{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"scripts\u002Ffind-polluter.sh","SCRIPT","脚本",1961,"https:\u002F\u002Fgithub.com\u002Famoai-tech\u002Fmdeai\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fsystematic-debugging\u002Fscripts\u002Ffind-polluter.sh",[71,78,85,92,99,106],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M7CV3D59CQX8N178NN3W5DEQ","mde-pr-review-supabase","Use when reviewing MDE Supabase SQL, Auth and RLS changes in a pull request.","https:\u002F\u002Fgithub.com\u002Famoai-tech\u002Fmdeai\u002Fblob\u002Fmain\u002Fscripts\u002Fpr-agent\u002Fskills\u002Fsupabase\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M7CV39XR1SPH7C4FNXAXMM36","mde-pr-review-stripe","Use when reviewing MDE Stripe payments and webhooks changes in a pull request.","https:\u002F\u002Fgithub.com\u002Famoai-tech\u002Fmdeai\u002Fblob\u002Fmain\u002Fscripts\u002Fpr-agent\u002Fskills\u002Fstripe\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7CV37HHNM5A144SEX2VE05N","mde-pr-review-nextjs","Use when reviewing MDE Next.js App Router changes in a pull request.","https:\u002F\u002Fgithub.com\u002Famoai-tech\u002Fmdeai\u002Fblob\u002Fmain\u002Fscripts\u002Fpr-agent\u002Fskills\u002Fnextjs\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M7CV34C1M5STTKHX5CGVN3VS","mde-pr-review-mastra","Use when reviewing MDE Mastra agent, tool and workflow changes in a pull request.","https:\u002F\u002Fgithub.com\u002Famoai-tech\u002Fmdeai\u002Fblob\u002Fmain\u002Fscripts\u002Fpr-agent\u002Fskills\u002Fmastra\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":19},"01M7CV31A37VPRRASAVGE8K8SN","mde-pr-review-maps","Use when reviewing MDE Google Maps and Places changes in a pull request.","https:\u002F\u002Fgithub.com\u002Famoai-tech\u002Fmdeai\u002Fblob\u002Fmain\u002Fscripts\u002Fpr-agent\u002Fskills\u002Fmaps\u002FSKILL.md",[],[],{"skillNo":107,"name":108,"nameZh":6,"description":109,"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":112,"publishedAt":19},"01M7CV2Y70DQJ1VXFHS732CSQ4","mde-pr-review-copilotkit","Use when reviewing MDE CopilotKit and AG-UI changes in a pull request.","https:\u002F\u002Fgithub.com\u002Famoai-tech\u002Fmdeai\u002Fblob\u002Fmain\u002Fscripts\u002Fpr-agent\u002Fskills\u002Fcopilotkit\u002FSKILL.md",[],[]]