[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CZRRC567QAVCMYMG2S8DJC":3,"skill-same:01M7CZRRC567QAVCMYMG2S8DJC":44},{"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":25,"commitSha":26,"skillDirectory":27,"forksCount":14,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":43},"01M7CZRRC567QAVCMYMG2S8DJC","principle-fix-root-causes",null,"Apply when debugging. Trace each symptom to its root cause and fix it there; reproduce first, ask why until you reach it, resist nil-check guards that silence crashes.","fern-works\u002Fgreenline","fern-works","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F330252531?v=4","01M7CZ6VNSYC4MB0XZS6BWJRX3","fernworks","01M7CZ6VPZYZWBPRG404SRBNA9",0,"MIT","https:\u002F\u002Fgithub.com\u002Ffern-works\u002Fgreenline\u002Fblob\u002Fmain\u002Fcorpus\u002Fupstream\u002Fpstack\u002Fd0ef80d86795816da932a153458c5dbe192d294e\u002Fprinciple-fix-root-causes\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: principle-fix-root-causes\ndescription: \"Apply when debugging. Trace each symptom to its root cause and fix it there; reproduce first, ask why until you reach it, resist nil-check guards that silence crashes.\"\ndisable-model-invocation: true\n---\n\n# Fix Root Causes\n\nWhen debugging, do not fix symptoms. Trace every problem to its root cause and fix it there.\n\n**Why:** Symptom fixes accumulate. Each workaround makes the system harder to reason about, and the real bug remains. Root-cause fixes are slower upfront but reduce total debugging time.\n\n**Pattern:**\n- Reproduce first\n- Ask \"why\" until you hit the root cause\n- Do not add guards (adding a nil check to silence a crash is a symptom fix)\n- If a workaround needs a paragraph-long comment to justify it, the code is wrong (fix the code, not the comment)\n- Check for the pattern, not just the instance (grep for the same pattern, fix all instances)\n- When stuck, instrument. Don't guess (add logging, read the actual error)\n\n**Restart bugs: suspect state before code**\n\nWhen something \"fails after restart,\" suspect stale persistent state first: config files, caches, lock files, serialized state. If clearing a state file restores behavior, prioritize state validation as the fix.\n","# Fix Root Causes\n\nWhen debugging, do not fix symptoms. Trace every problem to its root cause and fix it there.\n\n**Why:** Symptom fixes accumulate. Each workaround makes the system harder to reason about, and the real bug remains. Root-cause fixes are slower upfront but reduce total debugging time.\n\n**Pattern:**\n- Reproduce first\n- Ask \"why\" until you hit the root cause\n- Do not add guards (adding a nil check to silence a crash is a symptom fix)\n- If a workaround needs a paragraph-long comment to justify it, the code is wrong (fix the code, not the comment)\n- Check for the pattern, not just the instance (grep for the same pattern, fix all instances)\n- When stuck, instrument. Don't guess (add logging, read the actual error)\n\n**Restart bugs: suspect state before code**\n\nWhen something \"fails after restart,\" suspect stale persistent state first: config files, caches, lock files, serialized state. If clearing a state file restores behavior, prioritize state validation as the fix.\n",{"name":5,"description":7,"disable-model-invocation":24},true,"main","c4a6bc27da835d109348b8708301821838e98db2","corpus\u002Fupstream\u002Fpstack\u002Fd0ef80d86795816da932a153458c5dbe192d294e\u002Fprinciple-fix-root-causes","https:\u002F\u002Fgithub.com\u002Ffern-works\u002Fgreenline","https:\u002F\u002Fgithub.com\u002Ffern-works","2026-10-21 15:51:59",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":24},[33,36,39],{"tool":34,"command":35},"npx","npx skills add fern-works\u002Fgreenline --skill principle-fix-root-causes",{"tool":37,"command":38},"bunx","bunx skills add fern-works\u002Fgreenline --skill principle-fix-root-causes",{"tool":40,"command":41},"pnpm","pnpm dlx skills add fern-works\u002Fgreenline --skill principle-fix-root-causes","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Ffern-works\u002Fgreenline\u002Fblob\u002Fmain\u002Fcorpus\u002Fupstream\u002Fpstack\u002Fd0ef80d86795816da932a153458c5dbe192d294e\u002Fprinciple-fix-root-causes\u002FSKILL.md",[],[45,52,57,64,71,78],{"skillNo":46,"name":47,"nameZh":6,"description":48,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":49,"categories":50,"keywords":51,"publishedAt":19},"01M7D04ARSVW93Y1EGVM7HQQR8","use-garden","Consulting garden, the separately installed guidance command this repository's owner enabled, when an open engineering choice the repository does not settle, made in a change or only recommended, would be informed by published guidance. Use for a choice between approaches, a pattern or pitfall for a technology or concern the work touches, or a unit a repository decision names; not for a question about this repository's own facts or a change whose choices are already settled.","https:\u002F\u002Fgithub.com\u002Ffern-works\u002Fgreenline\u002Fblob\u002Fmain\u002Ftest\u002Fgoldens\u002Fgarden-enabled\u002Fdot-claude\u002Fskills\u002Fuse-garden\u002FSKILL.md",[],[],{"skillNo":53,"name":47,"nameZh":6,"description":48,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M7D045RXH0SEYZKHHW2YD0FQ","https:\u002F\u002Fgithub.com\u002Ffern-works\u002Fgreenline\u002Fblob\u002Fmain\u002Ftest\u002Fgoldens\u002Fgarden-enabled\u002Fdot-agents\u002Fskills\u002Fuse-garden\u002FSKILL.md",[],[],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M7D03ZXQHBP1RASSRHH5DX7S","what-to-build","Propose what this product could do next at three altitudes: sharpen a shipped slice, extend one, or open ground the product does not stand on yet. Use for 'what should we build next', 'any ideas for this app', 'what's missing', 'is this done or is there more in it', and quick-win hunts. Not for refactors, which belong to the architecture survey.","https:\u002F\u002Fgithub.com\u002Ffern-works\u002Fgreenline\u002Fblob\u002Fmain\u002Ftest\u002Fgoldens\u002Fcorpus\u002Fdot-claude\u002Fskills\u002Fwhat-to-build\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7D03WVYR3NN0N0CTN51RWBV","wayfinder","Plan a huge chunk of work (more than one agent session can hold) as a shared map of decision tickets in a plan directory's map.md, and resolve them one at a time until the way to the destination is clear.","https:\u002F\u002Fgithub.com\u002Ffern-works\u002Fgreenline\u002Fblob\u002Fmain\u002Ftest\u002Fgoldens\u002Fcorpus\u002Fdot-claude\u002Fskills\u002Fwayfinder\u002FSKILL.md",[],[],{"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},"01M7D03R6MAHHKQ42E5NBRHSF6","verify","Prove a change's claims with fresh evidence: restate each item of its acceptance so it can fail, capture a baseline and a treatment with the same command, compare the raw artifacts, and return VERIFIED, NOT VERIFIED or INCONCLUSIVE for each, at the depth the change's mode gives the verify step. Use when the mode reaches verify, or when the owner says \"verify this\", \"prove it works\" or \"did this fix it\".","https:\u002F\u002Fgithub.com\u002Ffern-works\u002Fgreenline\u002Fblob\u002Fmain\u002Ftest\u002Fgoldens\u002Fcorpus\u002Fdot-claude\u002Fskills\u002Fverify\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},"01M7D03JYGW4945FSJV6CDE2K9","tdd","Test-first development at any step: discover the repository's own test commands, name the break a test catches, watch it fail for the intended reason, make it pass with the smallest change, and add a new test only where it catches a realistic failure the existing ones would miss. Use when writing or changing a test, building a feature or fixing a bug test-first, or deciding whether a change needs a new test; also on 'red-green-refactor' and integration tests.","https:\u002F\u002Fgithub.com\u002Ffern-works\u002Fgreenline\u002Fblob\u002Fmain\u002Ftest\u002Fgoldens\u002Fcorpus\u002Fdot-claude\u002Fskills\u002Ftdd\u002FSKILL.md",[],[]]